Skip to content

Edit the caller's contact details and topic

POST
/v1/calls/{call}/contact
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).

call
required
string format: uuid

Call ID (UUID).

Media typeapplication/json
object
name

Full name; split into first/last on the contact. An empty string reverts the display name to the number.

string
location
string
mood

Empty string or null clears it.

string | null
notes
string
tags

Replaces the contact’s tags. Non-string entries are dropped.

Array<string>
favourite
boolean
point

Call topic / talking points (this call only; not saved to the contact).

string

Example

{
"name": "Jane Smith",
"location": "Springfield",
"point": "Wants to talk about the traffic on Route 9"
}

Action accepted.

Media typeapplication/json
object
ok
required
boolean

Example

{
"ok": true
}

Missing, invalid, expired or revoked API key.

Media typeapplication/json
object
error
required

Human-readable error message.

string
code

Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).

string

Example generated

{
"error": "example",
"code": "example"
}

The key isn’t allowed to do this (e.g. a read-only key making a change).

Media typeapplication/json
object
error
required

Human-readable error message.

string
code

Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).

string

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).

Media typeapplication/json
object
error
required

Human-readable error message.

string
code

Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).

string

Example generated

{
"error": "example",
"code": "example"
}

Too many requests for this API key. Retry after Retry-After seconds.

Media typeapplication/json
object
error
required

Human-readable error message.

string
code

Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).

string

Example generated

{
"error": "example",
"code": "example"
}
Retry-After
integer

Seconds until the rate-limit window resets.