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

​
Overview

Imports many items in one request (validated per row). Intended for bulk or migration scenarios.

​
Endpoint

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

​
Authentication

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

​
Request Body

​
items
array
required
Each item may include: primaryValue, secondaryValue, searchKeys, category, riskScore, severity (low | medium | high | critical), reason, sourceReference, itemData, metadata, isActive, plus passthrough fields as accepted by the API.
​
skipValidationErrors
boolean
When true, continues importing valid rows while collecting errors for invalid ones (behavior as implemented server-side).
​
replaceExisting
boolean
When true, replaces existing matches according to server merge rules.

​
Response

Usually 200 with successful, errors, and per-row errorDetails for partial failures.

​
Permissions

Requires bulk import permission for data lists. Global lists accept writes only from system administrators.