---
title: "User Delete API"
method: DELETE
path: "/v1/users/{user_id}"
tags: ["User APIs"]
---

# User Delete API

`DELETE /v1/users/{user_id}`

This API endpoint allows you to delete a specific user from the system using their `user_id`.

**Notice**: Make sure the user_id is an urlencode string.

To remove a user, make a DELETE request to:

```
DELETE /v1/users/{user_id}
```

Replace `{user_id}` with the unique identifier of the user you wish to delete.

## Response Format

The API will return a JSON object with a `task_id` that can be used to retrieve.

#### Example Error Response

```json
{
  "message": "deleted",
  "data": {
    "task_id": "{task_id}"
  }
}
```

To check the exact response body of this task_id, make a GET request to the following endpoint:

```
GET /v1/users/_status/{task_id}
```

Replace `{task_id}` with the task_id returned from the response.

## Path parameters

- `user_id` string, required

## Response `200`

Successful Response

- DeleteResponse
  - `message` string, required — Human-readable message
  - `data` TaskId, required
    - `task_id` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Validation Error
- `500` — Internal Server Error

---

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