# Read the thread

> Read your API token's conversation with the Revnu agent, newest first. Retrieve message text, roles, timestamps and request IDs to rebuild conversation history.

Canonical: https://revnu.com/docs/agent-thread
Last updated: 2026-10-21

```bash
curl -H "Authorization: Bearer $REVNU_API_TOKEN" "https://revnu.com/api/v1/agent/thread?limit=50"
```

## Query

| Param | Meaning |
|---|---|
| `limit` | 1 to 100. Default 50. |

## Response

`{ "items": [{ role, requestId, text, at }, …] }` with `role` of `user` or `agent`. Each token is its own thread; dashboard and Slack conversations are not included. A bot can rebuild its history from here after a restart, matching its own messages by `requestId`.

## Frequently asked questions

### Which scope does this need?

`agent:message`. A token without it gets `403` with `requiredScope` in the body. `GET /me` shows a token's scopes.

### Are responses cached?

No. Every response is `Cache-Control: no-store`, so what you read is current.