Skip to main content
PATCH
Update organization details

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

organizationName
string
required

The unique identifier of the organization to update Standard identifier pattern for resource names

Pattern: ^[a-zA-Z0-9_ -]+$

Body

application/json

Partial organization data to update

Represents an organization entity that serves as the top-level container for all resources

name
string

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.

Required string length: 1 - 63
Pattern: ^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$
displayName
string

Human-readable name for the organization, displayed in user interfaces

Required string length: 1 - 128
Pattern: ^[^\u0000-\u001F\u007F]+$
createdAt
string<date-time>

ISO 8601 timestamp indicating when the organization was created

updatedAt
string<date-time>

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

name
string

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.

Required string length: 1 - 63
Pattern: ^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$
displayName
string

Human-readable name for the organization, displayed in user interfaces

Required string length: 1 - 128
Pattern: ^[^\u0000-\u001F\u007F]+$
createdAt
string<date-time>

ISO 8601 timestamp indicating when the organization was created

updatedAt
string<date-time>

ISO 8601 timestamp indicating when the organization was last modified

mpaVersion
string
read-only

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.

Required string length: 1 - 32
Pattern: ^[a-zA-Z0-9._-]+$