Conversation history — get_conversation_history
Read the transcript of the current conversation so your agent can ground its reply in prior turns — available only to agents running inside ONBF.
#What it returns
get_conversation_history returns the ordered transcript of the conversation the run is bound to. Use it to recover context across runs without persisting anything yourself.
| Field | Type | Notes |
|---|---|---|
messages | array | Ordered turns, oldest first. |
messages[].role | string | user or assistant. |
messages[].content | string | The message text. |
messages[].createdAt | string (ISO) | When the turn was recorded. |
#Access
- Scope:
conversation:read. - Tokens: session token only — a user's personal access token cannot read another agent's conversation.
- Bound: the conversation is resolved from the token binding, never from a caller-supplied id.
Pair it with replies: Read history with get_conversation_history, then respond with post_reply — see Replies. For the full scope matrix, see Tools & scopes.