Edit the caller's contact details and topic
const url = 'https://api.caller9.app/v1/calls/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/contact';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"name":"Jane Smith","location":"Springfield","point":"Wants to talk about the traffic on Route 9"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.caller9.app/v1/calls/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/contact \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "name": "Jane Smith", "location": "Springfield", "point": "Wants to talk about the traffic on Route 9" }'Live-edits the caller’s details. name, location, mood, notes, tags
and favourite are saved to the organization’s contact for this caller’s
number (a contact is created if none exists). point (the call topic /
talking points) applies to this call only and is not saved after it ends.
Only fields present in the body are changed. Fields of the wrong type are
silently ignored (string fields become empty).
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Call ID (UUID).
Request Bodyrequired
Section titled “Request Bodyrequired”object
Full name; split into first/last on the contact. An empty string reverts the display name to the number.
Empty string or null clears it.
Replaces the contact’s tags. Non-string entries are dropped.
Call topic / talking points (this call only; not saved to the contact).
Example
{ "name": "Jane Smith", "location": "Springfield", "point": "Wants to talk about the traffic on Route 9"}Responses
Section titled “Responses”Action accepted.
object
Example
{ "ok": true}Missing, invalid, expired or revoked API key.
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}The key isn’t allowed to do this (e.g. a read-only key making a change).
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}call not found — the call doesn’t exist, belongs to another organization,
or has already ended (or, for reorder, call not found in queue).
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}Too many requests for this API key. Retry after Retry-After seconds.
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}Headers
Section titled “Headers”Seconds until the rate-limit window resets.