Organization Memberships

Remove a member from an organization

Changed on

Removes the given membership from the organization

delete/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

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