PATCH
/organizations/{organization_id}Update an organization
Updates an existing organization.
As of API version 2026-05-12, this endpoint no longer accepts public_metadata or private_metadata.
Use PATCH /v1/organizations/{organization_id}/metadata to merge updates into existing metadata, or PUT /v1/organizations/{organization_id}/metadata to replace a metadata field entirely.
- IdempotentThe SDK sends
Idempotency-Key, so a retried request is only applied once.
organization_idstringrequired
The ID of the organization to update
namestringoptional
The new name of the organization.
May not contain URLs or HTML.
Max length: 256
slugstringoptional
The new slug of the organization, which needs to be unique in the instance
max_allowed_membershipsintegeroptional
The maximum number of memberships allowed for this organization
admin_delete_enabledbooleanoptional
If true, an admin can delete this organization with the Frontend API.
self_serve_sso_enabledbooleanoptional
Whether this organization can configure self-serve enterprise SSO.
self_serve_directory_sync_enabledbooleanoptional
Whether this organization can configure self-serve Directory Sync (SCIM).
Independent of `self_serve_sso_enabled`.
created_atstringoptional
A custom date/time denoting _when_ the organization was created, specified in RFC3339 format (e.g. `2012-10-20T07:15:20.902Z`).
role_set_keystringoptional
The key of the [role set](https://clerk.com/docs/guides/organizations/control-access/role-sets) to assign to this organization.
reassignment_mappingsobjectoptional
Maps role keys in the organization's current role set to role keys in the new role set. Only applies when `role_set_key` changes the role set.
Every role that a member holds and that the new role set does not include must be mapped, otherwise the request fails with a 422.
Mapping a role that both role sets include moves its members to the destination role.
Memberships are reassigned asynchronously after the response.
200An organization
objectstringrequired
idstringrequired
namestringrequired
slugstringrequired
image_urlstringoptional
has_imagebooleanrequired
members_countintegeroptional
missing_member_with_elevated_permissionsbooleanoptional
pending_invitations_countintegeroptional
max_allowed_membershipsintegerrequired
admin_delete_enabledbooleanrequired
self_serve_sso_enabledbooleanoptional
Whether this organization can configure self-serve enterprise SSO.
self_serve_directory_sync_enabledbooleanoptional
Whether this organization can configure self-serve Directory Sync (SCIM).
public_metadataobjectrequired
private_metadataobjectoptional
created_bystringoptional
created_atintegerrequired
Unix timestamp of creation.
updated_atintegerrequired
Unix timestamp of last update.
last_active_atintegeroptional
Unix timestamp of last activity.
role_set_keystringoptional
The key of the [role set](https://clerk.com/docs/guides/organizations/control-access/role-sets) assigned to this organization.
400Request was not successful
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
402Payment required
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
403Authorization invalid
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
404Resource not found
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
422Invalid request parameters
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
Error handling
A 400 is returned: Request was not successful. A 402 is returned: Payment required. A 403 is returned: Authorization invalid. A 404 is returned: Resource not found. A 422 is returned: Invalid request parameters.