> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/api-rest/midapi-v2/biometric-user/delete-user.md).

# Delete User

Servicio que da de baja a un usuario registrado.

La baja es lógica: el identificador queda liberado y un alta posterior con el mismo `userId` crea un registro nuevo. Ver [La baja es lógica](/api-rest/midapi-v2/biometric-user.md#la-baja-es-logica).

### Endpoint

```
DELETE /user/{userId}
```

### Headers

| Nombre            | Tipo   | Requerido | Descripción                                                                                               |
| ----------------- | ------ | --------- | --------------------------------------------------------------------------------------------------------- |
| **Authorization** | string | **Sí**    | Token de consumer en formato `Bearer <token>`. Ver [Autenticación](/api-rest/midapi-v2/autenticacion.md). |
| **consumer-id**   | string | **Sí**    | Identificador del consumer.                                                                               |

### Parámetros de ruta

| Parámetro | Tipo   | Requerido | Descripción                                                       |
| --------- | ------ | --------- | ----------------------------------------------------------------- |
| `userId`  | string | **Sí**    | Identificador del usuario a dar de baja, de hasta 255 caracteres. |

### Cuerpo de la solicitud

Esta petición no lleva cuerpo.

### Respuestas

#### `200` Éxito

#### Parámetros de respuesta

| Parámetro   | Tipo   | Descripción                                                   |
| ----------- | ------ | ------------------------------------------------------------- |
| `userId`    | string | El identificador del usuario que se dio de baja.              |
| `timestamp` | string | Momento en que se dio de baja, en formato **ISO 8601** (UTC). |

#### Ejemplo de respuesta

```json
{
  "userId": "user-4417",
  "timestamp": "2026-06-26T12:00:00.000Z"
}
```

#### Otras respuestas

| Código | Descripción                                                                                                                                                                                                                                                    |
| ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`  | El `userId` excede el tamaño admitido.                                                                                                                                                                                                                         |
| `401`  | Token ausente, inválido o caducado.                                                                                                                                                                                                                            |
| `403`  | El consumer no está aprovisionado con el servicio `BIOMETRIC_USER`.                                                                                                                                                                                            |
| `404`  | No hay ningún usuario registrado con ese `userId`. Un usuario ya dado de baja cuenta como ausente, así que repetir la llamada informa de que no se encuentra en lugar de volver a tener éxito.                                                                 |
| `429`  | El consumer ha superado su límite de tasa de peticiones. El servicio subyacente no se invoca y la llamada no se factura. La respuesta incluye `Retry-After` con los segundos de espera, y `X-RateLimit-Limit` y `X-RateLimit-Burst` con los umbrales vigentes. |
| `503`  | El servicio no está disponible temporalmente.                                                                                                                                                                                                                  |

El cuerpo de una respuesta de error tiene la forma descrita en [Middleware API v2](/api-rest/midapi-v2.md#respuestas-de-error).