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. |
PUT /api/account/features¶
Choose which parts of the app the account sees
Auth: Session
Replaces the account's feature set with the keys given. Every key must
be in the catalogue at GET /api/features, or nothing is stored and
the answer is unknown_feature. An empty list means the vault alone.
This is the only way the field is written: a PATCH on the users
record refuses it. The stored set is readable on the account's own
record as features, and is null while the account has never
chosen — then the catalogue's defaults apply, and an accepted invite
that carries a starting set fills it in.
Users only. A feature set is a person's view of the app, which an API key has none of.
Request body
application/json
| Field | Type | Notes |
|---|---|---|
features |
array of string |
Responses
| Status | Meaning |
|---|---|
200 |
The stored set, in catalogue order. |
400 |
unknown_feature: a key is not in the catalogue. |
401 |
Refused, with a named reason. |
Response fields
| Field | Type | Notes |
|---|---|---|
features |
array of string |