v13

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-04237161688.6 KB

Organizations

Replace metadata for an organization

Replace an organization's metadata attributes with the provided values. Unlike PATCH /v1/organizations/{organization_id}/metadata (merge semantics), this endpoint replaces the supplied metadata fields entirely — the prior contents of each supplied field are discarded. Fields omitted from the request body are left unchanged. Prefer the PATCH endpoint for partial updates. Use PUT only when you explicitly intend to overwrite a metadata field wholesale.

put/organizations/{organization_id}/metadata

Path parameters

organization_idstring required

The ID of the organization whose metadata will be replaced

Request body

public_metadataobject

Metadata saved on the organization, that is visible to both your frontend and backend. The existing value will be replaced entirely with the new object.

private_metadataobject

Metadata saved on the organization that is only visible to your backend. The existing value will be replaced entirely with the new object.

Response

An organization

object'organization' required

idstring required

namestring required

slugstring required

image_urlstring

has_imageboolean required

members_countinteger

missing_member_with_elevated_permissionsboolean

pending_invitations_countinteger

max_allowed_membershipsinteger required

admin_delete_enabledboolean required

public_metadataobject required

private_metadataobject

created_bystring

created_atinteger required

Unix timestamp of creation.

updated_atinteger required

Unix timestamp of last update.

last_active_atinteger

Unix timestamp of last activity.

role_set_keystring nullable

The key of the role set assigned to this organization.