contacts
Bulk-update contacts (v2)
Update multiple contacts in a single request. Per-row results are settled (some can succeed, others fail). Requires Idempotency-Key. Returns { data: { affected, ids } } where ids lists the contact IDs that were successfully updated.
post/v2/contacts/batch-update
Headers
Idempotency-Keystring required
Example:01HV8N6X7K3P9Q5R2T4Y6W8Z0A
Required. UUID per logical operation, reused on every retry. See apps/rest-api/src/shared/idempotency.ts for the full contract. Missing → 400 BadRequest; same key + different body → 409 Conflict.
Request body
Response
Successful response