Skip to main content
Given the arriving turn in a conversation, return a short, ready-to-inject block of context about the people in the scope — drop it straight into an agent’s prompt before it replies. recall is meant to run every turn, before the agent’s reply. The arriving message is part of the signal: the same text from different speakers pulls different context (what does Alice asking about lunch surface, versus Bob?). Run one recall per turn alongside whatever else feeds your prompt. This is a billable read over the scope’s conversation; see What a read sees.

Authorization

string
required
Your bearer token: Bearer <token>. See Authentication.

Request body

string
required
Which scope to recall from. 1–255 characters. See Scopes.
Message
required
The arriving turn — the message the agent is about to respond to.
Request

Response

string
Prose context about the people involved, tuned to the arriving turn. Drop it into the agent’s prompt before it replies. Empty ("") when the scope has no stored messages yet.
200 OK

Errors

See Errors for the full envelope shape.

Example