# Agregar ítem(s)

`POST` `/lists/{list_id}/items`

Agrega o actualiza un ítem en una lista existente.

## Parámetros

- **list_id** (`string`, required) — ID de la lista sin el prefijo "@".

## Cuerpo de la solicitud

- **item** (`object`, required)
  - **values** (`object`, required) — Contenido del ítem. Validado de acuerdo con el tipo de la lista.
  - **description** (`string`) — Descripción opcional del ítem para visualización en el panel de administración.
  - **expiration_in_hours** (`integer`) — Cantidad de horas para expiración automática. Mantenga en blanco para registrar el ítem de forma permanente.

```json
{
  "item": {
    "values": null,
    "description": "string",
    "expiration_in_hours": 6
  }
}
```

## Respuestas

### 201 — Ítem(s) creado(s) con éxito.

- **items** (`array`) — Lista de ítems creados
  - **id** (`string`) — ID del ítem.
  - **value** (`string`) — Contenido del ítem.
  - **description** (`string`) — Descripción opcional del ítem.
  - **expires_at** (`date-time`) — Fecha y hora de expiración del ítem. Si el ítem es permanente, este campo estará nulo.

```json
{
  "items": [
    {
      "id": "string",
      "value": "string",
      "description": "string",
      "expires_at": "2024-01-01T00:00:00Z"
    }
  ]
}
```

### 401 — Credenciales de acceso inválidas

- **errors** (`array`)
  - **field** (`string`) — Campo de la solicitud donde ocurrió el error
  - **type** (`string`) — Código del tipo del error
  - **message** (`string`) — Mensaje del error

```json
{
  "errors": [
    {
      "field": "string",
      "type": "string",
      "message": "string"
    }
  ]
}
```

### 422 — Parámetros inválidos

- **errors** (`array`)
  - **field** (`string`) — Campo de la solicitud donde ocurrió el error
  - **type** (`string`) — Código del tipo del error
  - **message** (`string`) — Mensaje del error

```json
{
  "errors": [
    {
      "field": "string",
      "type": "string",
      "message": "string"
    }
  ]
}
```

### 404 — Objeto no encontrado

- **errors** (`array`)
  - **field** (`string`) — Campo de la solicitud donde ocurrió el error
  - **type** (`string`) — Código del tipo del error
  - **message** (`string`) — Mensaje del error

```json
{
  "errors": [
    {
      "field": "string",
      "type": "string",
      "message": "string"
    }
  ]
}
```