Update membership

Platform

Update supported membership properties such as role assignments, status and organization-facing metadata.

Identity

One user identity

Membership

Tenant affiliation

Role

Functional access

Context

Tenant + membership

PATCH/v1/memberships/{membership_id}Scope: memberships.write

Endpoint summary

PATCH /v1/memberships/{membership_id} requires memberships.write.

Name	Type	Description
membership_id	uuid	Membership to update

Field	Type	Description
roles	string[]	Replacement or approved role set
status	enum	Supported lifecycle status change
metadata	object	Organization-facing membership metadata

JSONCopy

{
  "roles": ["doctor", "prescriber"],
  "status": "active"
}

Code	Meaning
200	Membership updated
400	Invalid fields or role assignment
403	Insufficient tenant permission
404	Membership not found
409	Invalid lifecycle transition