Skip to main content
Get Subject
The row from the list, plus the rolling summary, the recent transcript turns, and every fact. Each fact carries where it came from (source, source_channel) and when it became true (valid_from), so you can tell what the agent learned on which conversation. There is no way to edit a remembered value — by design. You change what the agent looks for (the agent’s memory fields), or you delete: one fact or in bulk.

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.

subject_id
string
required

The remembered person's id, from GET …/memory/subjects.

Response

Successful Response

One caller's whole notebook.

id
string
required

This person's id, for reading and erasing their memory.

msisdn_full
string
required

Their number, E.164.

display_name
string | null
required

What the agent knows them as, if anything.

fact_count
integer
required

How many facts are held about them.

interaction_count
integer
required

How many conversations they have had with this agent.

last_channel
string | null
required

How they last got in touch — voice (a phone call) or whatsapp. Widget conversations are not recorded in memory, so they never appear here. A record of what happened, which is a different question from the agent's memory.channels setting, which decides what is allowed to feed memory.

last_seen_at
string<date-time>
required

When they last spoke to it (UTC, ISO 8601).

first_seen_at
string<date-time>
required

When they first did (UTC, ISO 8601).

summary
string | null
required

The agent's running summary of who they are.

transcript
Transcript · object[]
required

Recent turns kept as context for the next conversation.

facts
MemoryFactRead · object[]
required

Everything the agent remembers about them, fact by fact.