Skip to main content
List Subjects
When memory is on, an agent remembers the people it talks to across calls and WhatsApp — so a caller who gave their name last week is greeted by name today.
Two halves, deliberately separate. The settings — whether memory is on, which channels, which fields to fill — are part of the agent’s configuration and move with a publish. The people are here, and are never versioned: an erasure has to take effect now, not at your next deploy.
Filter by the date a caller was last updated (last_updated_on, or last_updated_from / last_updated_to) or search part of a number.
Two different questions about channels. The agent’s memory.channels setting (inbound, outbound, whatsapp) decides which conversations are allowed to feed memory - a permission, and a phone call’s direction is what it is judged on. A subject’s last_channel (voice, whatsapp) records how that person last got in touch. Widget conversations never feed memory, so they appear in neither.

Authorizations

Authorization
string
header
required

Your API key as a Bearer token, e.g. Authorization: Bearer vk_….

Path Parameters

agent_id
string
required

The agent's id, as GET /v1/agents returns it.

Query Parameters

last_updated_on
string | null

ISO date - callers updated that day

last_updated_from
string | null

ISO date - range start, inclusive

last_updated_to
string | null

ISO date - range end, inclusive

search
string | null

Match any part of the number

limit
integer
default:100

Maximum records to return in one page.

Required range: x <= 500
cursor
string | null

Opaque cursor from a previous response's next_cursor; omit for the first page

Response

The callers this agent remembers.

data
object[]
required

The rows on this page.

has_more
boolean
required

Whether another page exists. false on the last.

next_cursor
string | null

Pass back as ?cursor= for the next page; null on the last one. Opaque — do not parse or construct one. A cursor from a differently sorted list is refused with invalid_cursor rather than silently returning page 1.