Adiciona item(s)

POST /lists/{list_id}/items

Adiciona ou atualiza um item em uma lista existente.

Parâmetros

list_idstringrequired

ID da lista sem o prefixo "@".

Corpo da requisição

itemobjectrequired
item object
valuesobjectrequired

Conteúdo do item. Validado de acordo com o tipo da lista.

descriptionstring

Descrição opcional do item para exibição no painel de administração.

expiration_in_hoursinteger

Quantidade de horas para expiração automática. Mantenha em branco para cadastrar o item de forma permanente.

Respostas

201Item(s) criado(s) com sucesso.
Response body
itemsarray

Lista de items criados

items[] item
idstring

ID do item.

valuestring

Conteúdo do item.

descriptionstring

Descrição opcional do item.

expires_atdate-time

Data e hora de expiração do item. Caso o item seja permanente, este campo estará nulo.

401Credenciais de acesso inválidas
Response body
errorsarray
errors[] item
fieldstring

Campo da requisição onde ocorreu o erro

typestring

Código do tipo do erro

messagestring

Mensagem do erro

422Parâmetros inválidos
Response body
errorsarray
errors[] item
fieldstring

Campo da requisição onde ocorreu o erro

typestring

Código do tipo do erro

messagestring

Mensagem do erro

404Objeto não encontrado
Response body
errorsarray
errors[] item
fieldstring

Campo da requisição onde ocorreu o erro

typestring

Código do tipo do erro

messagestring

Mensagem do erro

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