Update organization details
Partially updates an organization’s details. Only the provided fields will be updated. This operation allows for selective updates without requiring all organization fields.
Authorization: Requires organization admin permissions.
Validation: All provided fields are validated according to their schema constraints.
Side Effects: Updates the organization’s updatedAt timestamp.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The unique identifier of the organization to update Standard identifier pattern for resource names
^[a-zA-Z0-9_ -]+$Body
Partial organization data to update
Represents an organization entity that serves as the top-level container for all resources
The unique identifier for the organization. Used as the resource name in API paths AND as the DNS subdomain label routing traffic to the org, so it follows RFC 1035 hostname rules — lowercase letters, digits, and hyphens; no underscores; no leading or trailing hyphen; max 63 chars.
1 - 63^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$Human-readable name for the organization, displayed in user interfaces
1 - 128^[^\u0000-\u001F\u007F]+$ISO 8601 timestamp indicating when the organization was created
ISO 8601 timestamp indicating when the organization was last modified
Response
Organization updated successfully
Represents an organization entity that serves as the top-level container for all resources
The unique identifier for the organization. Used as the resource name in API paths AND as the DNS subdomain label routing traffic to the org, so it follows RFC 1035 hostname rules — lowercase letters, digits, and hyphens; no underscores; no leading or trailing hyphen; max 63 chars.
1 - 63^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$Human-readable name for the organization, displayed in user interfaces
1 - 128^[^\u0000-\u001F\u007F]+$ISO 8601 timestamp indicating when the organization was created
ISO 8601 timestamp indicating when the organization was last modified
Version identifier of the Master Platform Agreement the organization
accepted at creation time (file basename, e.g. v1-2026-05-19).
Server-set: clients do not (and cannot) submit this field — when an
organization is created via the invite-redemption path, the server
stamps its current active MPA version. Null on legacy organizations
created before MPA acceptance was required.
Only the version is exposed on this resource. The per-user / per-
timestamp audit fields (mpa_accepted_by, mpa_accepted_at)
are kept internal — useful for compliance audit on the server
side, not for API consumers. If a future use case needs them on
the API, add them then; widening is easier than narrowing.
1 - 32^[a-zA-Z0-9._-]+$