Remove a workspace member
Removes a member. Admins and owners; only an owner removes an owner, and the last owner stays. Requires `workspace:members`. Removing yourself leaves the workspace and, like leaving, needs only `workspace:read` and works without workspace sharing for your account. Removing someone else needs workspace sharing for your account; otherwise 403 `WORKSPACE_SHARING_REQUIRED`.
/workspaces/{id}/members/{user_id}Authorization
bearerAuth Send Authorization: Bearer <token> with one of: an app session access token from /auth/verify-otp or /auth/refresh; an OAuth access token from /oauth/token issued for the API origin (its scopes are its permissions); or a personal access token starting with optima_pat_ (see /docs/personal-access-tokens). Personal access tokens cannot create or list tokens, revoke other tokens, sign out, or delete or restore the account. Content routes need the permission of their layer: audio:read/audio:write for recordings, turns:read/turns:write for turns, contacts, source signals, and events, and insights:read/insights:write for suggestions and session summaries; search and recall need turns:read and insights:read. A request without the permission, or for an account whose layer is turned off, returns 403 FORBIDDEN. See /docs/authentication#scopes.
In: header
Path Parameters
uuiduuidHeader Parameters
Send 1 to pin the documented API contract. If omitted, the latest version is selected.
"1"Value in
- "1"
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/workspaces/497f6eca-6276-4993-bfeb-53cbbbba6f08/members/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "X-API-Version: 1"Change a member's role PATCH
Changes a member's role. Admins and owners; only an owner grants or removes `owner`, and the last owner keeps it. Requires `workspace:members`. Needs workspace sharing for your account; otherwise 403 `WORKSPACE_SHARING_REQUIRED`.
GET /workspaces/{id}/settings GET
Reads a workspace’s settings: for each retention bucket (`audio`, `transcripts`, `insights`, `voice`), whether its data is kept, for how many days, the longest duration the plan allows (`max_days`), and the default. Any member may read them; requires `workspace:read`. A shared workspace’s settings need workspace sharing for your account; your private workspace’s do not.