Contact Relations
List related contacts
Get the contacts related to a contact. Relations are an undirected, untyped graph — the server normalizes edge direction, so the same list comes back whichever side of a pair you ask from. Returns `{
GET /v2/contact-relations/{contactId}
Parameters
Path parameters
contactId
string (uuid) required
Responses
200 — Successful response
Content-Type: application/json
data
object required
data.related_contacts
array<object> required
data.related_contacts[].id
string (uuid) required
data.related_contacts[].full_name
string | null
data.related_contacts[].first_name
string | null
data.related_contacts[].last_name
string | null
data.related_contacts[].image_url
string | null
data.pagination
object
data.pagination.nextCursor
string | null
data.pagination.count
integer
Example
{
"data": {
"related_contacts": [
{
"id": "00000000-0000-0000-0000-000000000000"
}
]
}
}
400 — Request body failed validation.
Content-Type: application/json
(body)
any
401 — Missing or invalid API key.
Content-Type: application/json
(body)
any
403 — Valid key, insufficient permission.
Content-Type: application/json
(body)
any
404 — Resource does not exist.
Content-Type: application/json
(body)
any
409 — Request conflicts with the current state of the resource.
Content-Type: application/json
(body)
any
429 — Rate limit exceeded.
Content-Type: application/json
(body)
any
500 — Unexpected server error.
Content-Type: application/json
(body)
any
Code samples
curl https://api.prod.getdex.com/v2/contact-relations/00000000-0000-0000-0000-000000000000 \
--header 'Authorization: Bearer YOUR_API_KEY'
fetch('https://api.prod.getdex.com/v2/contact-relations/00000000-0000-0000-0000-000000000000', {
headers: {
Authorization: 'Bearer YOUR_API_KEY'
}
})
requests.get(
"https://api.prod.getdex.com/v2/contact-relations/00000000-0000-0000-0000-000000000000",
headers={
"Authorization": "Bearer YOUR_API_KEY"
}
)
Delete a contact address
Remove an address from a contact. Idempotency-Key is optional. Returns `{ data: { affected } }`.
Add related contacts
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 si