API Reference / Poll a message
Poll a message
One message's status and every reply the agent has sent since it landed.
Last updated
curl -H "Authorization: Bearer $REVNU_API_TOKEN" https://revnu.com/api/v1/agent/messages/f2a283fd-…Response
{
"message": {
"requestId": "f2a283fd-…",
"status": "replied",
"text": "What did we ship this week?",
"sentAt": 1789851456304,
"replies": [{ "text": "Three things shipped: …", "at": 1789851468121 }]
}
}status is queued, running, replied or failed (with a failure message; re-send with a new client id). replied means the agent answered and finished the turn. The agent may answer in more than one bubble, and it often posts progress while it works, so replies can fill while the status is still running. It is a list, oldest first, holding the latest five bubbles. interrupted: true means a later message stopped this turn before it finished. 404 for an unknown id, a colleague's dashboard turn, or another account's message.
Agents: this page is also markdown at /docs/agent-message-status.md, answers Accept: text/markdown, and is listed in /docs/llms.txt.
Frequently Asked Questions
`agent:message`. A token without it gets `403` with `requiredScope` in the body. `GET /me` shows a token's scopes.