Organization Memberships

Update an organization membership

Changed on

Updates the properties of an existing organization membership

patch/organizations/{organization_id}/memberships/{user_id}

Request

  • Base URL: https://api.clerk.com/v1
  • URL: https://api.clerk.com/v1/organizations/{organization_id}/memberships/{user_id}
  • Auth: HTTP bearer

Path parameters

organization_idstring required

The ID of the organization to which this membership belongs

user_idstring required

The ID of the user to which this membership belongs

Request body

rolestring required

The new role of the given membership.

Response

Success

idstring required
object'organization_membership' required

String representing the object's type. Objects of the same type share the same value.

rolestring required
role_namestring
permissionsstring[] required
public_metadataobject required

Metadata saved on the organization membership, accessible from both Frontend and Backend APIs

private_metadataobject

Metadata saved on the organization membership, accessible only from the Backend API

created_atinteger required

Unix timestamp of creation.

updated_atinteger required

Unix timestamp of last update.

Changes

  • 2025-11-10a490313abffaRevision changes
    • warning

      removed the optional property ///// from the response with the status

  • 2025-11-107db12d6a9b2aRevision changes
    • info

      added the optional property ///// to the response with the status