# Poll a message

> One message's status and every reply the agent has sent since it landed.

Canonical: https://revnu.com/docs/agent-message-status

```bash
curl -H "Authorization: Bearer $REVNU_API_TOKEN" https://revnu.com/api/v1/agent/messages/f2a283fd-…
```

## Response

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

## 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.