---
title: "Remove workspace member"
method: DELETE
path: "/v1/workspaces/{workspaceId}/members/{userId}"
tags: ["Workspaces"]
---

# Remove workspace member

`DELETE /v1/workspaces/{workspaceId}/members/{userId}`

## Request

- Base URL: `https://api.tokenbooks.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tokenbooks.io/v1/workspaces/{workspaceId}/members/{userId}`
- Auth: API key in header `x-api-key`

Executes member offboarding. HTTP 200 returns completed with performed actions, or already_removed with no actions field when the membership no longer exists. Dependencies requiring manual resolution return HTTP 409 with blockers.

## Path parameters

- `workspaceId` string, required
- `userId` string, required

## Response `200`

Offboarding completed or already_removed; completed includes performed actions, while already_removed has no actions field.

- union
  - object
    - `actions` union[], required
      - union
        - object
          - `affectedCount` integer, required
          - `code` 'PORTFOLIO_MEMBERSHIPS_REMOVED', required
          - `description` string, required
          - `resources` object[], required
            - `name` string, required
            - `type` 'portfolio', required
        - object
          - `affectedCount` integer, required
          - `code` 'TEAM_MEMBERSHIPS_REMOVED', required
          - `description` string, required
          - `resources` object[], required
            - `name` string, required
            - `type` 'team', required
        - object
          - `affectedCount` integer, required
          - `code` 'TEAM_MANAGER_ASSIGNMENTS_CLEARED', required
          - `description` string, required
          - `resources` object[], required
            - `name` string, required
            - `type` 'team', required
        - object
          - `affectedCount` integer, required
          - `code` 'API_KEYS_DISABLED', required
          - `description` string, required
          - `resources` object[], required
            - `name` string, required
            - `type` 'api_key', required
        - object
          - `affectedCount` integer, required
          - `code` 'SLACK_LINKS_DISABLED', required
          - `description` string, required
          - `resources` object[], required
            - `name` string, required
            - `type` 'slack_link', required
        - object
          - `affectedCount` integer, required
          - `code` 'ACTIVE_SESSIONS_CLEARED', required
          - `description` string, required
          - `resources` object[], required
            - `name` string, required
            - `type` 'session', required
        - object
          - `affectedCount` integer, required
          - `code` 'COUNTERPARTIES_UNLINKED', required
          - `description` string, required
          - `resources` object[], required
            - `name` string, required
            - `type` 'counterparty', required
        - object
          - `affectedCount` integer, required
          - `code` 'INVITATIONS_CANCELED', required
          - `description` string, required
          - `resources` object[], required
            - `name` string, required
            - `type` 'invitation', required
        - object
          - `affectedCount` integer, required
          - `code` 'APPROVAL_POLICY_USERS_REMOVED', required
          - `description` string, required
          - `resources` object[], required
            - `name` string, required
            - `type` 'approval_rule', required
        - object
          - `affectedCount` integer, required
          - `code` 'WORKSPACE_MEMBERSHIPS_REMOVED', required
          - `description` string, required
          - `resources` object[], required
            - `name` string, required
            - `type` 'workspace', required
        - object
          - `affectedCount` integer, required
          - `code` 'WORKSPACE_USAGE_REFRESHED', required
          - `description` string, required
          - `resources` object[], required
            - `name` string, required
            - `type` 'workspace', required
    - `status` 'completed', required
  - object
    - `status` 'already_removed', required

## Other responses

- `409`: Offboarding could not run because blockers require manual resolution.

---

[API](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api.md) · [All operations](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api/revisions/180622e6255e?raw)