---
title: "Delete workspace user"
method: DELETE
path: "/api/v1/workspaces/users/{userId}"
tags: ["workspace", "users"]
---

# Delete workspace user

`DELETE /api/v1/workspaces/users/{userId}`

Remove a specific user from the current workspace by user ID.

    <Callout type="warn">
    Deleting a user from the workspace will revoke their access and remove all workspace-specific data.
    </Callout>

    **Use cases:**
    - Removing users who no longer need access
    - Managing team membership
    - Enforcing security and compliance

## Path parameters

- `userId` string, required

## Other responses

- `401` — This response indicates that the client must authenticate to access the requested resource.
- `403` — This response indicates that the client does not have permission to access the requested resource.
- `404` — This response indicates that the requested resource could not be found.

---

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