Skip to main content
POST
/
data-lists
/
{type}
/
items
Add items by list type (legacy shortcut)
curl --request POST \
  --url http://api.gu1.ai/data-lists/{type}/items \
  --header 'Authorization: Bearer <token>'

​
Overview

Adds items to the first active list returned for {type} (ordered by createdAt descending with limit: 1 in the implementation). If no active list exists, returns 404 with a hint to create one via POST /data-lists. For production integrations with more than one list per type, always use Add items with the explicit list UUID.

​
Endpoint

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

​
Authentication

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

​
Request Body

Same shape as Add items:
  • items (required): 1–1000 entries with primaryValue, optional searchKeys, category, riskScore, itemData, metadata.
  • options: batchSize, ignoreDuplicates, updateExisting.

​
Response

201 with listId resolved by the server, plus ingest counters.