# Adiciona item(s)

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

Adiciona ou atualiza um item em uma lista existente.

## Parâmetros

- **list_id** (`string`, obrigatório) — ID da lista sem o prefixo "@".

## Corpo da requisição

- **item** (`object`, obrigatório)
  - **values** (`object`, obrigatório) — Conteúdo do item. Validado de acordo com o tipo da lista. A quantidade de itens por requisição é limitada (ver maxItems).
  - **description** (`string`) — Descrição opcional do item para exibição no painel de administração.
  - **expiration_in_hours** (`integer`) — Quantidade de horas para expiração automática. Mantenha em branco para cadastrar o item de forma permanente.

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

## Respostas

### 201 — Item(s) criado(s) com sucesso.

- **items** (`array`) — Lista de items criados
  - **id** (`string`) — ID do item.
  - **value** (`string`) — Conteúdo do item.
  - **description** (`string`) — Descrição opcional do item.
  - **expires_at** (`date-time`) — Data e hora de expiração do item. Caso o item seja permanente, este campo estará nulo.

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

### 401 — Credenciais de acesso inválidas

- **errors** (`array`)
  - **field** (`string`) — Campo da requisição onde ocorreu o erro
  - **type** (`string`) — Código do tipo do erro
  - **message** (`string`) — Mensagem do erro

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

### 422 — Parâmetros inválidos

- **errors** (`array`)
  - **field** (`string`) — Campo da requisição onde ocorreu o erro
  - **type** (`string`) — Código do tipo do erro
  - **message** (`string`) — Mensagem do erro

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

### 404 — Objeto não encontrado

- **errors** (`array`)
  - **field** (`string`) — Campo da requisição onde ocorreu o erro
  - **type** (`string`) — Código do tipo do erro
  - **message** (`string`) — Mensagem do erro

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