Terminate membership

Platform

End a user’s access to a tenant while preserving the historical membership and audit trail.

Identity

One user identity

Membership

Tenant affiliation

Role

Functional access

Context

Tenant + membership

POST/v1/memberships/{membership_id}/terminateScope: memberships.write

Endpoint summary

POST /v1/memberships/{membership_id}/terminate ends tenant access while retaining historical attribution.

Termination is not deletion. Historical clinical and operational actions must remain attributable to the membership that performed them.

Field	Type	Description
reason	string	Termination reason
effective_at	date-time	Optional scheduled effective time

JSONCopy

{
  "reason": "affiliation_ended",
  "effective_at": "2026-08-31T18:00:00Z"
}

Code	Meaning
200	Membership terminated
403	Insufficient access
404	Membership not found
409	Membership already terminated or invalid state