Remove a member from the workspace
Take someone out of this workspace.
/v1/workspace/members/{user_id}Admin- Operation id
- remove_member
- Access
- An editor or a viewer is refused.
/v1/workspace/members/{user_id}Take someone out of this workspace.
Their account continues to exist and their membership of other workspaces is untouched. What goes is their access here, from their next request onwards.
The last owner cannot be removed, so a workspace is never left with nobody who can administer it.
Removing someone also kills every API key they minted, because a key borrows its owner's live role and there is no longer one to borrow.
Tickets they worked keep their name on the timeline. There is no response body.
Tenancy: the request is scoped to one workspace, and the credential presented is what selects it. A caller with no membership in that workspace is refused with 404, which is indistinguishable from a workspace that does not exist.
Authorisation: admin or owner. An editor or viewer receives 403 insufficient_role.
Access: Authorization: Bearer carrying either a realm access token or an API key. A key must hold the workspace-admin:write scope, and the workspace role of the person who owns it must meet the floor above.
A realm-issued access token, presented as Authorization: Bearer <token>. It acts as the person who signed in, and every operation resolves their workspace role live from the membership record.
In: header
Path Parameters
uuidResponse Body
application/json
curl -X DELETE "https://example.com/v1/workspace/members/497f6eca-6276-4993-bfeb-53cbbbba6f08"