Skip to Content
Browse the Docs▾

Read the thread

GET/api/v1/agent/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.

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.