---
title: "Request deletion of a console user"
method: DELETE
path: "/management/users/{id}"
tags: ["Console User"]
---

# Request deletion of a console user

`DELETE /management/users/{id}`

## Request

- Base URL: `https://api.fireblocks.io/v1`
- URL: `https://api.fireblocks.io/v1/management/users/{id}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fireblocks/apis/fireblocks-api/docs/management/users/:id/delete.ts> (a function with typed inputs; its response is checked against the schema)

Requests deletion of a console user. The request is asynchronous: it goes through the workspace's configured "Delete users" approval policy (Settings > Quorums), exactly as deleting a user from the console does, and the user is removed only once that approval completes.
- The workspace must have a "Delete users" approval policy (admin quorum or approval group). If "Delete users" is Owner-only, which is the default, the request is refused with OWNER_ONLY (2760) and the Owner deletes users in the Console. With an admin quorum, the requesting API user's own approval counts toward the quorum.
- Track progress by polling GET /management/users; deletion is complete when the user is disabled.
- Please note that this endpoint is available only for API keys with Admin/Non Signing Admin/Security Admin permissions.
Endpoint Permission: Admin, Non-Signing Admin, Security Admin.
**Note:** This endpoint is in Early Availability (EA) and may change or break before it reaches GA.

## Path parameters

- `id` string, required

## Query parameters

- `force` boolean

## Response `202`

Deletion request accepted. Returns the console user that will be removed once the workspace's configured approval completes.

- ConsoleUser
  - `id` string: The unique identifier of the user
  - `firstName` string: The first name of the user
  - `lastName` string: The last name of the user
  - `email` string: The email address of the user
  - `role` 'OWNER' | 'ADMIN' | 'SIGNER' | 'COLLATERALS_SIGNER' | 'EDITOR' | 'APPROVER' | 'VIEWER' | 'NON_SIGNING_ADMIN' | 'AUDITOR' | 'NCW_ADMIN' | 'NCW_SIGNER' | 'SECURITY_ADMIN' | 'SECURITY_AUDITOR': The role of the user
  - `enabled` boolean: Whether the user is enabled
  - `status` 'PENDING_ACTIVATION' | 'PENDING_DEVICE_PAIRING' | 'PENDING_DEVICE_SETUP' | 'READY': The status of the user
  - `userType` 'API' | 'CONSOLE': The type of the user

## Other responses

- `400`: Bad request: invalid parameters (for example a non-boolean `force`), or TARGET_IS_API_USER - the ID belongs to an API user in this workspace; this endpoint deletes console users only.
- `401`: Unauthorized. Missing / invalid JWT token in Authorization header.
- `403`: Lacking permissions, or the target cannot be deleted: the user is the workspace Owner, or the caller is the target. Also returned as OWNER_ONLY (2760) when the workspace's "Delete users" approval is Owner-only; set an approval policy in the Console under Settings > Quorums.
- `404`: Console user not found. Also returned for users in other workspaces (so the endpoint does not reveal whether an ID exists there) and for users that were already deleted.
- `409`: PENDING_REQUEST_EXISTS - a deletion request for this user is already awaiting approval; USER_REFERENCED_IN_TAP - the user is referenced by the workspace transaction authorization policy (can be overridden with force=true); or USER_PENDING_ONBOARDING - the user has not completed onboarding, so there is nothing to delete yet. Revoke the invitation from the console instead.
- `422`: QUORUM_INTEGRITY - the user is required to complete the workspace's admin approval quorum. Can be overridden with force=true, matching the console's acknowledgement checkbox.
- `5XX`: Internal error.
- `default`: Error Response

---

[API](https://skmtc.dev/fireblocks/apis/fireblocks-api.md) - [All operations](https://skmtc.dev/fireblocks/apis/fireblocks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireblocks/apis/fireblocks-api/revisions/4eba9965659a?raw)