Record a conversation into an agent's memory of a contact
POST /voice/agents/{agent_id}/memory
Teach an agent what was said, so the next call is not the first one.
This is how a conversation that happened somewhere ELSE - your own product, a human rep, another channel - becomes context the agent has. Calls the agent places itself are recorded already; this route exists for everything it did not witness.
Written to two places by voice: a durable interaction row and the vector memory retrieval reads. There is no delete for a memory on this surface.
The agent is named in the PATH for a readable URL. Voice’s own handler
scopes the write by (org_id, contact_id), so the memory attaches to the
contact within the caller’s org either way.
Authorizations
Parameters
Path Parameters
The agent doing the remembering.
The agent doing the remembering.
Header Parameters
Request Body required
object
Who the conversation was with.
Channel: “chat”, “email”, “phone_call”, …
Ordered messages, each {"role": "user"|"assistant", "content": "..."}. Oldest first.
Responses
200
Successful Response
object
One voice object - a collection, an agent, a route, a chat.
Open-shaped: voice adds fields to these bodies on its own release cadence and a dropped-or-added key must not be a 500 in this service.
object
object
Whether there are more pages
Items per page
Current page number (1-indexed)
Total number of items
422
Validation Error