Workspaces¶
Membership and account-level operations.
GET /api/workspaces/{id}/members¶
List workspace members
Auth: Session
Who is in the workspace and what each may do, plus what the caller may hand out without it being refused as escalation. Being a member is the only requirement to read it.
Parameters
| Name | In | Required | Notes |
|---|---|---|---|
id |
path | yes |
Responses
| Status | Meaning |
|---|---|
200 |
Members and the caller's grantable set. |
401 |
Refused, with a named reason. |
403 |
Refused, with a named reason. |
Response fields
| Field | Type | Notes |
|---|---|---|
members |
array of Member | |
grantable |
array of Permission | |
canManage |
boolean |
DELETE /api/account¶
Delete the authenticated account
Auth: Session
Removes the account and everything reachable through it. Workspaces the account is alone in are torn down entirely; in shared workspaces its content is handed to a remaining member rather than orphaned.
Refused while the account is the last member able to administer a shared workspace, since that would leave the workspace unadministrable.
Users only — an API key must not be able to delete the person behind it.
Responses
| Status | Meaning |
|---|---|
204 |
Deleted. |
401 |
Refused, with a named reason. |
409 |
The account is the last administrator of a shared workspace. |