> 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/identity-api/identity-api-reference/users/users-blacklists/enroll-user-blacklist.md).

# Enroll User Blacklist

Registra el rostro de un nuevo usuario en la lista negra compartida. El userId debe ser único dentro de la colección. Solo el cliente que registró el rostro podrá recuperar el userId completo en los resultados de búsqueda y eliminar esta entrada.

### Endpoint

```
PUT /users/blacklist/{userId}
```

### Autenticación

| Tipo    | Ubicación | Nombre        |
| ------- | --------- | ------------- |
| API Key | Header    | **x-api-key** |

### Cuerpo de la solicitud

**Content-Type:** `application/json`

#### Parámetros de ruta

| Parámetro | Tipo   | Requerido | Descripción                                                                                    |
| --------- | ------ | --------- | ---------------------------------------------------------------------------------------------- |
| `userId`  | string | **Sí**    | Identificador único del usuario. Este ID debe ser único dentro de la colección de lista negra. |

#### Parámetros

| Parámetro | Tipo   | Requerido | Descripción                                                                                                                           |
| --------- | ------ | --------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `face`    | string | **Sí**    | Imagen del rostro del usuario **codificada en Base64**. Los formatos soportados son **JPEG** y **PNG**. Tamaño máximo soportado: 5MB. |

#### Ejemplo de solicitud

```json
{
  "face": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="
}
```

### Respuestas

#### `200` Éxito

Usuario registrado exitosamente en la lista negra. Esta respuesta no incluye cuerpo.

#### `400` Bad Request

#### Ejemplo de respuesta: userId duplicado

```json
{
  "status": 400,
  "title": "Bad Request",
  "detail": "Invalid request.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400",
  "errors": ["the provided userId already exists"]
}
```

#### Ejemplo de respuesta: imagen facial inválida

```json
{
  "status": 400,
  "title": "Bad Request",
  "detail": "Invalid request.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400",
  "errors": ["no face was detected in the provided image"]
}
```

#### `401` Unauthorized

```json
{
  "message": "Unauthorized"
}
```

#### `403` Forbidden

```json
{
  "Message": "User is not authorized to access this resource with an explicit deny"
}
```

#### `404` Not Found

```json
{
  "status": 404,
  "title": "Not Found",
  "detail": "The server can't find the requested resource.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404"
}
```