API Reference / Poll a message
Poll a message
GET/api/v1/agent/messages/{requestId}
One message's status and every reply the agent has sent since it landed.
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). The agent may answer in more than one bubble, so replies is a list, oldest first. 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.