RevnuDocs
Browse the Docs

API Reference / Get agent status

Get agent status

GET/api/v1/agent/status

Whether the agent is up and busy: sandbox state, last activity, and the next scheduled wake.

curl -H "Authorization: Bearer $REVNU_API_TOKEN" https://revnu.com/api/v1/agent/status

Response

{ "status": { "sandbox": "alive", "running": false, "lastActivityAt": 1789832474865, "lastTurnAt": 1789832490530, "pendingWakes": 2, "nextWakeAt": 1790002800000 } }

running is derived: a turn that started in the last 30 minutes and has not finished. A dead sandbox is normal between turns; the next message or wake spawns one.

Agents: this page is also markdown at /docs/agent-status.md, answers Accept: text/markdown, and is listed in /docs/llms.txt.

Frequently Asked Questions

`results:read`. A token without it gets `403` with `requiredScope` in the body. `GET /me` shows a token's scopes.