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

​
Overview

Adds one or more items to a specific list identified by UUID. Requires permission to update the list.

​
Endpoint

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

​
Authentication

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

​
Request Body

​
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)

​
Notes

  • 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.

​
Response

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