foliot docs

API reference / Workspaces / Leave a workspace

Leave a workspace

POST/workspaces/{workspaceId}/leave

Authenticate with a signed-in Foliot Console session.

Takes the signed-in person out of the workspace, at once and without anyone approving it. Any member may, in any role. Their access to the workspace and its apps ends on their very next request, and a bulk action they started stops before its next run. Their account, and any other workspace they belong to, is untouched. It is recorded in the workspace’s history as member.left, with the person as both actor and subject, and every owner and admin who remains is sent an email about it (one Foliot holds no email address for is not, and still sees it in the history). 409 if they are the workspace’s only owner: make someone else an owner first, or close the workspace. 404 if they are not a member. A signed-in person only: an app key is 403, since it is a member of nothing. To come back, an owner or admin invites them again.

Path parameters

workspaceId
string (uuid)
REQUIRED

The workspace to leave.

Responses

204 no body No Content
400 Error Invalid request.
401 Error Missing, malformed or unknown bearer token.
403 Error The token is valid but not permitted on this route.
404 Error No such resource.
409 Error Conflicts with existing state.
503 Error A dependency this route needs is unreachable.