contact-relations
Add related contacts (v2)
Link one or more contacts to {contactId} as related contacts. Relations are symmetric — linking A to B also links B to A — and carry no relationship label. Already-linked pairs and self-links are silently skipped. Requires Idempotency-Key. Returns { data: { affected, ids } } where affected counts NEW links created.
post/v2/contact-relations/{contactId}/add
Path parameters
contactIdstring uuid required
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
Changes
Changed in 2 of the 21 revisions of this API.2
- ○
api operation id
addRelatedContactsV2was addedapi-operation-id-added
- ○
- ○
endpoint added
endpoint-added
- ○