Skip to main content
POST
Batch upsert by external ID

Authorizations

Authorization
string
header
required

A scoped Integration key, prefixed cint_. Send as Authorization: Bearer cint_... on every request. Server-side only. Legacy personal cmem_... keys remain accepted during migration; team/org-scoped cmem_... keys are not valid on this API.

Body

application/json
endUserId
string
required

Your stable internal user ID. No colon allowed.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9@._-]{1,128}$
Example:

"u_123"

items
object[]
required

Aggregate content is capped at 1 MiB per request.

Required array length: 1 - 100 elements

Response

Batch processed; inspect each ordered per-item result.

success
boolean
required

"The batch was processed" — NOT "every item succeeded". Per-item outcomes are in items[].

applied
integer
required
failed
integer
required
items
object[]
required

One result per input item, in input order.