Skip to navigation

Remove a member

Required scopes: membership.delete.

Requires the current membership ETag. Owners cannot be removed (409); service principals cannot remove administrators (403). Absent memberships return 204 after scope and precondition syntax checks. Revokes human organization access through the existing membership boundary; independently owned service tokens remain valid.

Authentication

AuthorizationBearer

Organization-owned service token. Issue the initial token in organization credential settings. Scopes are documented per operation via x-required-scopes; they are not OAuth scopes.

Path parameters

organization_idstringRequiredformat: "uuid"
Immutable organization UUID bound to the service token.
member_idstringRequiredformat: "uuid"
Immutable user UUID of an active organization membership. Protocol principals and handles are not accepted.

Headers

If-MatchstringRequiredformat: "^"membership-[a-f0-9]{64}"$"

Strong validator for this membership representation and row revision. Membership writes require the latest value unchanged. Missing:428; stale:412; malformed, weak, wildcard or list:422.

Response

Successful operation

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
503
Service Unavailable Error