---
title: "Remove a user from a workspace"
method: DELETE
path: "/workspaces/{workspace_id}/users/{id}"
tags: ["User"]
---

# Remove a user from a workspace

`DELETE /workspaces/{workspace_id}/users/{id}`

Remove a user's role in a workspace. The user's memberships in other workspaces are unaffected. This operation is idempotent - removing a user who is not a member of the workspace returns 204. Available to workspace owners, company owners, and properly permissioned API keys.

## Path parameters

- `workspace_id` string, required
- `id` string, required

## Headers

- `If-Match` string

## Response `204`

The user holds no role in the workspace, either because it was just removed or because it was already absent

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `404` — No user exists with the given id
- `409` — Removal conflicts with workspace constraints, such as removing the last owner or an If-Match header version mismatch
- `default` — Unknown error

---

[API](https://skmtc.net/mabl/apis/mabl-api.md) · [All operations](https://skmtc.net/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/d0fc0114da66/schema)