Update organization

Platform

Update organization metadata, legal information and supported configuration fields.

Isolation

Tenant-scoped by design

Hierarchy

Organizations + sub-organizations

Access

Membership + role context

Configuration

Policies, modules & branding

PATCH/v1/organizations/{id}Scope: organizations.write

Endpoint summary

Method	Endpoint	Required scope
PATCH	/v1/organizations/{id}	organizations.write

Parameter	Type	Required	Description
id	string	Yes	Organization identifier

Field	Type	Required	Description
name	string	No	Organization name
type	string	No	Organization type
legal_identifier	string	No	Approved external legal identifier
parent_organization_id	string	No	Optional parent organization

PATCH /v1/organizations/{id}Copy

PATCH /v1/organizations/{id}
Authorization: Bearer $ACCESS_TOKEN
Content-Type: application/json

{
  "name":"Updated display name"
}

Code	Meaning
200	Updated successfully
400	Unsupported or invalid field
403	Insufficient access
404	Resource not found
409	Lifecycle or concurrency conflict

Field	Type	Description
id	string	Immutable organization identifier
name	string	Display / legal organization name
type	enum	hospital, clinic, pharmacy_group, supplier, healthtech, other
status	enum	draft, active, suspended, archived
parent_organization_id	string \| null	Optional parent organization
primary_tenant_id	string \| null	Primary operational tenant reference