---
title: "Read the thread"
method: GET
path: "/api/v1/agent/thread"
tags: ["API Reference"]
---

# Read the thread

`GET /api/v1/agent/thread`

## Request

- Base URL: `https://revnu.com`
- URL: `https://revnu.com/api/v1/agent/thread`
- Auth: HTTP bearer

This token's conversation with the agent, newest first.

Requires the `agent:message` scope.

**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`.

## Query parameters

- `limit` integer

## Response `200`

{ "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.

- object
  - `items` union[], required
    - union
      - object
        - `role` 'agent', required
        - `requestId` string, required
        - `text` string, required
        - `at` number, required
      - object
        - `role` 'user', required
        - `requestId` string, required
        - `text` string, required
        - `at` number, required

## Other responses

- `400`: The request is malformed; the error names the problem.
- `401`: Missing, malformed, unknown or revoked token.
- `402`: `setup_pending`: the account hasn't started its trial. Finish setup with `GET /setup`.
- `403`: The token lacks the scope in `requiredScope`.
- `429`: Rate limited.
- `503`: Temporarily unavailable; retry the same call.

---

[API](https://skmtc.dev/revnu/apis/revnu-api.md) · [All operations](https://skmtc.dev/revnu/apis/revnu-api/llms.txt) · [OpenAPI document](https://skmtc.dev/revnu/apis/revnu-api/revisions/52e523c2db61?raw)