--- title: Update Membership --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Memberships](https://developers.cloudflare.com/api/go/resources/memberships) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Update Membership client.Memberships.Update(ctx, membershipID, body) (\*[MembershipUpdateResponse](), error) PUT/memberships/{membership\_id} Accept or reject this account invitation. ##### Security API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**`X-Auth-Email: user@example.com` The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**`X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194` ##### Accepted Permissions (at least one required) `Memberships Write` ##### ParametersExpand Collapse membershipID string Membership identifier tag. maxLength32 [Link to this property](<#(resource)%20memberships%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20membership_id%20%3E%20(schema)>)
body MembershipUpdateParams
Status param.Field\[MembershipUpdateParamsStatus] Whether to accept or reject this account invitation. const MembershipUpdateParamsStatusAccepted MembershipUpdateParamsStatus = "accepted" Link to this property const MembershipUpdateParamsStatusRejected MembershipUpdateParamsStatus = "rejected" Link to this property
Link to this property
[Link to this property](<#(resource)%20memberships%20%3E%20(method)%20update%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type MembershipUpdateResponse struct{…} ID stringOptional Membership identifier tag. maxLength32 Link to this property
Account AccountOptional ID string Identifier maxLength32 minLength32 Link to this property Name string Account name maxLength100 Link to this property
Type AccountType One of the following: const AccountTypeStandard AccountType = "standard" Link to this property const AccountTypeEnterprise AccountType = "enterprise" Link to this property
Link to this property CreatedOn TimeOptional Timestamp for the creation of the account formatdate-time Link to this property
ManagedBy AccountManagedByOptional Parent container details ParentOrgID stringOptional ID of the parent Organization, if one exists maxLength32 Link to this property ParentOrgName stringOptional Name of the parent Organization, if one exists Link to this property
Link to this property
Settings AccountSettingsOptional Account settings AbuseContactEmail stringOptional Sets an abuse contact email to notify for abuse reports. Link to this property EnforceTwofactor boolOptional Indicates whether membership in this account requires that Two-Factor Authentication is enabled Link to this property
Link to this property
Link to this property APIAccessEnabled boolOptional Enterprise only. Indicates whether or not API access is enabled specifically for this user on a given account. Link to this property
Permissions MembershipUpdateResponsePermissionsOptional All access permissions for the user at the account.
Analytics PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
Billing PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
CachePurge PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
DNS PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
DNSRecords PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
LB PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
Logs PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
Organization PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
SSL PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
WAF PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
ZoneSettings PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
Zones PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
Link to this property
Policies \[]MembershipUpdateResponsePolicyOptional Access policy for the membership ID stringOptional Policy identifier. Link to this property
Access MembershipUpdateResponsePoliciesAccessOptional Allow or deny operations against the resources. One of the following: const MembershipUpdateResponsePoliciesAccessAllow MembershipUpdateResponsePoliciesAccess = "allow" Link to this property const MembershipUpdateResponsePoliciesAccessDeny MembershipUpdateResponsePoliciesAccess = "deny" Link to this property
Link to this property
PermissionGroups \[]MembershipUpdateResponsePoliciesPermissionGroupOptional A set of permission groups that are specified to the policy. ID string Identifier of the permission group. Link to this property
Meta MembershipUpdateResponsePoliciesPermissionGroupsMetaOptional Attributes associated to the permission group. Category stringOptional A category used to group permission groups. Link to this property Deprecated stringOptional Indicates whether the permission group is deprecated. Link to this property Description stringOptional Additional information about the permission group. Link to this property Editable stringOptional Indicates whether the permission group can be edited. Link to this property EolAt TimeOptional The planned end-of-life date and time, when provided. formatdate-time Link to this property Label stringOptional A label identifying the permission group. Link to this property Scopes stringOptional The scope associated with the permission group. Link to this property Visibility stringOptional Indicates the permission group’s availability or visibility. Link to this property
Link to this property Name stringOptional Name of the permission group. Link to this property
Link to this property
ResourceGroups \[]MembershipUpdateResponsePoliciesResourceGroupOptional A list of resource groups that the policy applies to. ID string Identifier of the resource group. Link to this property
Scope MembershipUpdateResponsePoliciesResourceGroupsScope 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 \[]MembershipUpdateResponsePoliciesResourceGroupsScopeObject 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
Link to this property
Meta MembershipUpdateResponsePoliciesResourceGroupsMetaOptional Attributes associated to the resource group. Key stringOptional Link to this property Value stringOptional Link to this property
Link to this property Name stringOptional Name of the resource group. Link to this property
Link to this property
Link to this property Roles \[]stringOptional List of role names the membership has for this account. Link to this property
Status MembershipUpdateResponseStatusOptional Status of this membership. One of the following: const MembershipUpdateResponseStatusAccepted MembershipUpdateResponseStatus = "accepted" Link to this property const MembershipUpdateResponseStatusPending MembershipUpdateResponseStatus = "pending" Link to this property const MembershipUpdateResponseStatusRejected MembershipUpdateResponseStatus = "rejected" Link to this property
Link to this property
[Link to this property](<#(resource)%20memberships%20%3E%20(model)%20MembershipUpdateResponse%20%3E%20(schema)>) ### Update Membership Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/memberships" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIKey("144c9defac04969c7bfad8efaa8ea194"), option.WithAPIEmail("user@example.com"), ) membership, err := client.Memberships.Update( context.TODO(), "4536bcfad5faccb111b47003c79917fa", memberships.MembershipUpdateParams{ Status: cloudflare.F(memberships.MembershipUpdateParamsStatusAccepted), }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", membership.ID) } ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "4536bcfad5faccb111b47003c79917fa", "account": { "id": "023e105f4ecef8ad9ca31a8372d0c353", "name": "Demo Account", "type": "standard", "created_on": "2014-03-01T12:21:02Z", "managed_by": { "parent_org_id": "4536bcfad5faccb111b47003c79917fa", "parent_org_name": "Demo Parent Organization" }, "settings": { "abuse_contact_email": "abuse_contact_email", "enforce_twofactor": true } }, "api_access_enabled": true, "permissions": { "analytics": { "read": true, "write": false }, "billing": { "read": true, "write": false }, "cache_purge": { "read": true, "write": false }, "dns": { "read": true, "write": false }, "dns_records": { "read": true, "write": false }, "lb": { "read": true, "write": false }, "logs": { "read": true, "write": false }, "organization": { "read": true, "write": false }, "ssl": { "read": true, "write": false }, "waf": { "read": true, "write": false }, "zone_settings": { "read": true, "write": false }, "zones": { "read": true, "write": true } }, "policies": [ { "id": "f267e341f3dd4697bd3b9f71dd96247f", "access": "allow", "permission_groups": [ { "id": "c8fed203ed3043cba015a93ad1616f1f", "meta": { "category": "category", "deprecated": "deprecated", "description": "description", "editable": "editable", "eol_at": "2019-12-27T18:11:19.117Z", "label": "load_balancer_admin", "scopes": "com.cloudflare.api.account", "visibility": "visibility" }, "name": "Zone Read" }, { "id": "82e64a83756745bbbb1c9c2701bf816b", "meta": { "category": "category", "deprecated": "deprecated", "description": "description", "editable": "editable", "eol_at": "2019-12-27T18:11:19.117Z", "label": "fbm_user", "scopes": "com.cloudflare.api.account", "visibility": "visibility" }, "name": "Magic Network Monitoring" } ], "resource_groups": [ { "id": "6d7f2f5f5b1d4a0e9081fdc98d432fd1", "scope": { "key": "com.cloudflare.api.account.eb78d65290b24279ba6f44721b3ea3c4", "objects": [ { "key": "com.cloudflare.api.account.zone.23f8d65290b24279ba6f44721b3eaad5" } ] }, "meta": { "key": "key", "value": "value" }, "name": "com.cloudflare.api.account.eb78d65290b24279ba6f44721b3ea3c4" } ] } ], "roles": [ "Account Administrator" ], "status": "accepted" } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "4536bcfad5faccb111b47003c79917fa", "account": { "id": "023e105f4ecef8ad9ca31a8372d0c353", "name": "Demo Account", "type": "standard", "created_on": "2014-03-01T12:21:02Z", "managed_by": { "parent_org_id": "4536bcfad5faccb111b47003c79917fa", "parent_org_name": "Demo Parent Organization" }, "settings": { "abuse_contact_email": "abuse_contact_email", "enforce_twofactor": true } }, "api_access_enabled": true, "permissions": { "analytics": { "read": true, "write": false }, "billing": { "read": true, "write": false }, "cache_purge": { "read": true, "write": false }, "dns": { "read": true, "write": false }, "dns_records": { "read": true, "write": false }, "lb": { "read": true, "write": false }, "logs": { "read": true, "write": false }, "organization": { "read": true, "write": false }, "ssl": { "read": true, "write": false }, "waf": { "read": true, "write": false }, "zone_settings": { "read": true, "write": false }, "zones": { "read": true, "write": true } }, "policies": [ { "id": "f267e341f3dd4697bd3b9f71dd96247f", "access": "allow", "permission_groups": [ { "id": "c8fed203ed3043cba015a93ad1616f1f", "meta": { "category": "category", "deprecated": "deprecated", "description": "description", "editable": "editable", "eol_at": "2019-12-27T18:11:19.117Z", "label": "load_balancer_admin", "scopes": "com.cloudflare.api.account", "visibility": "visibility" }, "name": "Zone Read" }, { "id": "82e64a83756745bbbb1c9c2701bf816b", "meta": { "category": "category", "deprecated": "deprecated", "description": "description", "editable": "editable", "eol_at": "2019-12-27T18:11:19.117Z", "label": "fbm_user", "scopes": "com.cloudflare.api.account", "visibility": "visibility" }, "name": "Magic Network Monitoring" } ], "resource_groups": [ { "id": "6d7f2f5f5b1d4a0e9081fdc98d432fd1", "scope": { "key": "com.cloudflare.api.account.eb78d65290b24279ba6f44721b3ea3c4", "objects": [ { "key": "com.cloudflare.api.account.zone.23f8d65290b24279ba6f44721b3eaad5" } ] }, "meta": { "key": "key", "value": "value" }, "name": "com.cloudflare.api.account.eb78d65290b24279ba6f44721b3ea3c4" } ] } ], "roles": [ "Account Administrator" ], "status": "accepted" } } ```