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

Membership object {id, account, api\_access\_enabled, 3 more }

id: optional string Membership identifier tag. maxLength32 Link to this property account: optional Account { id, name, type, 3 more } Link to this property api\_access\_enabled: optional boolean Enterprise only. Indicates whether or not API access is enabled specifically for this user on a given account. Link to this property

permissions: optional object {analytics, billing, cache\_purge, 9 more } All access permissions for the user at the account.

analytics: optional PermissionGrant { read, write } Link to this property billing: optional PermissionGrant { read, write } Link to this property cache\_purge: optional PermissionGrant { read, write } Link to this property dns: optional PermissionGrant { read, write } Link to this property dns\_records: optional PermissionGrant { read, write } Link to this property lb: optional PermissionGrant { read, write } Link to this property logs: optional PermissionGrant { read, write } Link to this property organization: optional PermissionGrant { read, write } Link to this property ssl: optional PermissionGrant { read, write } Link to this property waf: optional PermissionGrant { read, write } Link to this property zone\_settings: optional PermissionGrant { read, write } Link to this property zones: optional PermissionGrant { read, write } Link to this property

Link to this property roles: optional array of string List of role names the membership has for this account. Link to this property

status: optional "accepted"or "pending"or "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)>)

MembershipGetResponse object {id, account, api\_access\_enabled, 4 more }

permissions: optional object {analytics, billing, cache\_purge, 9 more } All access permissions for the user at the account.

Link to this property

policies: optional array of object {id, access, permission\_groups, resource\_groups } Access policy for the membership

id: optional string Policy identifier. Link to this property

access: optional "allow"or "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 array of object {id, meta, name } A set of permission groups that are specified to the policy.

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

meta: optional object {category, deprecated, description, 5 more } Attributes associated to the permission group.

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

Link to this property name: optional string Name of the permission group. Link to this property

Link to this property

resource\_groups: optional array of object {id, scope, meta, name } A list of resource groups that the policy applies to.

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

scope: object {key, objects } A scope is a combination of scope objects which provides additional context.

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

objects: array of object {key } A list of scope objects for additional context.

key: string 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 object {key, value } Attributes associated to the resource group.

key: optional string Link to this property value: optional string Link to this property

Link to this property name: optional string Name of the resource group. Link to this property

Link to this property

Link to this property roles: optional array of string List of role names the membership has for this account. Link to this property

status: optional "accepted"or "pending"or "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)>)

MembershipUpdateResponse object {id, account, api\_access\_enabled, 4 more }

permissions: optional object {analytics, billing, cache\_purge, 9 more } All access permissions for the user at the account.

Link to this property

policies: optional array of object {id, access, permission\_groups, resource\_groups } Access policy for the membership

id: optional string Policy identifier. Link to this property

access: optional "allow"or "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 array of object {id, meta, name } A set of permission groups that are specified to the policy.

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

meta: optional object {category, deprecated, description, 5 more } Attributes associated to the permission group.

Link to this property name: optional string Name of the permission group. Link to this property

Link to this property

resource\_groups: optional array of object {id, scope, meta, name } A list of resource groups that the policy applies to.

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

scope: object {key, objects } A scope is a combination of scope objects which provides additional context.

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

objects: array of object {key } A list of scope objects for additional context.

key: string 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 object {key, value } Attributes associated to the resource group.

key: optional string Link to this property value: optional string Link to this property

Link to this property name: optional string Name of the resource group. Link to this property

Link to this property

Link to this property roles: optional array of string List of role names the membership has for this account. Link to this property

status: optional "accepted"or "pending"or "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)>)

MembershipDeleteResponse object {id }

id: optional string 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)>)