# Delete users

{% hint style="danger" %}
**`DELETE /users` requests are limited to a raw JSON payload size of 3 MB.**
{% endhint %}

## Endpoint

<mark style="color:blue;">`DELETE`</mark> `https://api.signitic.app/users`

## Headers

| Name                                        | Type   | Description  |
| ------------------------------------------- | ------ | ------------ |
| x-api-key<mark style="color:red;">\*</mark> | String | Your API key |

## Request body

### Example

```json
{
  "users": [
    {
      "email": "user1@signitic.fr"
    },
    {
      "email": "user2@signitic.fr"
    }
  ]
}
```

Deleting a user marks it for deletion one month later. The limit applies to the raw request body size, not to a fixed number of users.

## Success response

### `200 OK`

```json
{
  "success": true,
  "value": {
    "deleted": 2
  }
}
```

## Error responses

| Status | Internal code | When                                |
| ------ | ------------- | ----------------------------------- |
| 400    | `103`         | The request body is not valid JSON. |
| 401    | `99`          | The API key is missing or invalid.  |
| 422    | `104`         | The raw JSON payload exceeds 3 MB.  |