# 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](/docs/replies)**. For the full scope matrix, see **[Tools & scopes](/docs/passport-mcp/tools)**.