--- title: Memberships --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Memberships ##### [List Memberships](https://developers.cloudflare.com/api/python/resources/memberships/methods/list) memberships.list(MembershipListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[Membership]()] GET/memberships ##### [Membership Details](https://developers.cloudflare.com/api/python/resources/memberships/methods/get) memberships.get(strmembership\_id) -> [MembershipGetResponse]() GET/memberships/{membership\_id} ##### [Update Membership](https://developers.cloudflare.com/api/python/resources/memberships/methods/update) memberships.update(strmembership\_id, MembershipUpdateParams\*\*kwargs) -> [MembershipUpdateResponse]() PUT/memberships/{membership\_id} ##### [Delete Membership](https://developers.cloudflare.com/api/python/resources/memberships/methods/delete) memberships.delete(strmembership\_id) -> [MembershipDeleteResponse]() DELETE/memberships/{membership\_id} ##### ModelsExpand Collapse

class Membership: …

id: Optional\[str] Membership identifier tag. maxLength32 Link to this property account: Optional\[Account] Link to this property api\_access\_enabled: Optional\[bool] Enterprise only. Indicates whether or not API access is enabled specifically for this user on a given account. Link to this property

permissions: Optional\[Permissions] All access permissions for the user at the account.

analytics: Optional\[PermissionGrant] Link to this property billing: Optional\[PermissionGrant] Link to this property cache\_purge: Optional\[PermissionGrant] Link to this property dns: Optional\[PermissionGrant] Link to this property dns\_records: Optional\[PermissionGrant] Link to this property lb: Optional\[PermissionGrant] Link to this property logs: Optional\[PermissionGrant] Link to this property organization: Optional\[PermissionGrant] Link to this property ssl: Optional\[PermissionGrant] Link to this property waf: Optional\[PermissionGrant] Link to this property zone\_settings: Optional\[PermissionGrant] Link to this property zones: Optional\[PermissionGrant] Link to this property

Link to this property roles: Optional\[List\[str]] List of role names the membership has for this account. Link to this property

status: Optional\[Literal\["accepted", "pending", "rejected"]] Status of this membership.

One of the following: "accepted" Link to this property "pending" Link to this property "rejected" Link to this property

Link to this property

[Link to this property](<#(resource)%20memberships%20%3E%20(model)%20membership%20%3E%20(schema)>)

class MembershipGetResponse: …

permissions: Optional\[Permissions] All access permissions for the user at the account.

Link to this property

policies: Optional\[List\[Policy]] Access policy for the membership

id: Optional\[str] Policy identifier. Link to this property

access: Optional\[Literal\["allow", "deny"]] Allow or deny operations against the resources.

One of the following: "allow" Link to this property "deny" Link to this property

Link to this property

permission\_groups: Optional\[List\[PolicyPermissionGroup]] A set of permission groups that are specified to the policy.

id: str Identifier of the permission group. Link to this property

meta: Optional\[PolicyPermissionGroupMeta] Attributes associated to the permission group.

category: Optional\[str] A category used to group permission groups. Link to this property deprecated: Optional\[str] Indicates whether the permission group is deprecated. Link to this property description: Optional\[str] Additional information about the permission group. Link to this property editable: Optional\[str] Indicates whether the permission group can be edited. Link to this property eol\_at: Optional\[datetime] The planned end-of-life date and time, when provided. formatdate-time Link to this property label: Optional\[str] A label identifying the permission group. Link to this property scopes: Optional\[str] The scope associated with the permission group. Link to this property visibility: Optional\[str] Indicates the permission group’s availability or visibility. Link to this property

Link to this property name: Optional\[str] Name of the permission group. Link to this property

Link to this property

resource\_groups: Optional\[List\[PolicyResourceGroup]] A list of resource groups that the policy applies to.

id: str Identifier of the resource group. Link to this property

scope: PolicyResourceGroupScope A scope is a combination of scope objects which provides additional context.

key: str This is a combination of pre-defined resource name and identifier (like Account ID etc.) Link to this property

objects: List\[PolicyResourceGroupScopeObject] A list of scope objects for additional context.

key: str This is a combination of pre-defined resource name and identifier (like Zone ID etc.) Link to this property

Link to this property

meta: Optional\[PolicyResourceGroupMeta] Attributes associated to the resource group.

key: Optional\[str] Link to this property value: Optional\[str] Link to this property

Link to this property name: Optional\[str] Name of the resource group. Link to this property

Link to this property

Link to this property roles: Optional\[List\[str]] List of role names the membership has for this account. Link to this property

status: Optional\[Literal\["accepted", "pending", "rejected"]] Status of this membership.

One of the following: "accepted" Link to this property "pending" Link to this property "rejected" Link to this property

Link to this property

[Link to this property](<#(resource)%20memberships%20%3E%20(model)%20membership_get_response%20%3E%20(schema)>)

class MembershipUpdateResponse: …

permissions: Optional\[Permissions] All access permissions for the user at the account.

Link to this property

policies: Optional\[List\[Policy]] Access policy for the membership

id: Optional\[str] Policy identifier. Link to this property

access: Optional\[Literal\["allow", "deny"]] Allow or deny operations against the resources.

One of the following: "allow" Link to this property "deny" Link to this property

Link to this property

permission\_groups: Optional\[List\[PolicyPermissionGroup]] A set of permission groups that are specified to the policy.

id: str Identifier of the permission group. Link to this property

meta: Optional\[PolicyPermissionGroupMeta] Attributes associated to the permission group.

Link to this property name: Optional\[str] Name of the permission group. Link to this property

Link to this property

resource\_groups: Optional\[List\[PolicyResourceGroup]] A list of resource groups that the policy applies to.

id: str Identifier of the resource group. Link to this property

scope: PolicyResourceGroupScope A scope is a combination of scope objects which provides additional context.

key: str This is a combination of pre-defined resource name and identifier (like Account ID etc.) Link to this property

objects: List\[PolicyResourceGroupScopeObject] A list of scope objects for additional context.

key: str This is a combination of pre-defined resource name and identifier (like Zone ID etc.) Link to this property

Link to this property

meta: Optional\[PolicyResourceGroupMeta] Attributes associated to the resource group.

key: Optional\[str] Link to this property value: Optional\[str] Link to this property

Link to this property name: Optional\[str] Name of the resource group. Link to this property

Link to this property

Link to this property roles: Optional\[List\[str]] List of role names the membership has for this account. Link to this property

status: Optional\[Literal\["accepted", "pending", "rejected"]] Status of this membership.

One of the following: "accepted" Link to this property "pending" Link to this property "rejected" Link to this property

Link to this property

[Link to this property](<#(resource)%20memberships%20%3E%20(model)%20membership_update_response%20%3E%20(schema)>)

class MembershipDeleteResponse: …

id: Optional\[str] Membership identifier tag. maxLength32 Link to this property

[Link to this property](<#(resource)%20memberships%20%3E%20(model)%20membership_delete_response%20%3E%20(schema)>)