Skip to main content
POST
/
data-lists
/
{id}
/
items
Adicionar itens à lista
curl --request POST \
  --url http://api.gu1.ai/data-lists/{id}/items \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {}
  ],
  "options": {}
}
'

​
Visão geral

Adiciona um ou mais itens a uma lista identificada por UUID. Exige permissão de atualização na lista.

​
Endpoint

POST https://api.gu1.ai/data-lists/{id}/items

​
Autenticação

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

​
Corpo da solicitação

​
items
array
required
Each element:
  • primaryValue (string, required)
  • searchKeys (string[], optional)
  • category (string, optional)
  • riskScore (number, optional)
  • itemData (object, optional)
  • metadata (object, optional)
​
options
object
  • batchSize (number, optional)
  • ignoreDuplicates (boolean, optional)
  • updateExisting (boolean, optional)

​
Notas

  • For large uploads with richer per-row fields, prefer Bulk import items (POST /data-lists/{id}/items/bulk).
  • Shortcut POST /data-lists/{type}/items adds to the first active list of that type (oldest by default). Prefer list id when you have multiple lists per type.

​
Resposta

201 with counts (processed, errors, duplicates, etc.) on success.