---
title: "Delete Users"
method: POST
path: "/users/delete"
tags: ["Users"]
---

# Delete Users

`POST /users/delete`

## Request

- Base URL: `https://api.velt.dev/v2`
- URL: `https://api.velt.dev/v2/users/delete`
- Auth: API key in header `x-velt-api-key` and API key in header `x-velt-auth-token`

Use this API to remove Users from organizations or documents.

- **Organization:** Removes access from all documents and data
- **Document:** Removes access from specified document (pass documentId)
- **Folder:** Removes access from specified folder (pass folderId)

## Request body

- object
  - `data` object, required
    - `organizationId` string, required: Organization ID
    - `documentId` string: Document ID (optional)
    - `folderId` string: Folder ID (optional)
    - `userIds` string[], required: Array of User IDs to delete

## Response `200`

Users deleted successfully

- SuccessResponse
  - `result` object
    - `status` 'success'
    - `message` string
    - `data` object: Response data specific to the operation

## Other responses

- `400`: Invalid request

---

[API](https://skmtc.dev/velt-js/apis/velt-rest-api.md) - [All operations](https://skmtc.dev/velt-js/apis/velt-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/velt-js/apis/velt-rest-api/revisions/0f5af15fa267?raw)