Check the response envelope before reading the payload. A successful queue response means accepted work; its run or operation status supplies the eventual result.
Response format
Success and error envelopes
{ "ok": true, "data": { "items": [] } }
{ "ok": false, "error": {
"code": "unauthenticated", "message": "Missing session"
} }Choose the next action
- 400: correct the input. 401: repair the credential. 403: check permissions, Actor scope, or workspace limits.
- 404: check the resource and workspace. 409: resolve the prerequisite, active run, outdated proposal, or idempotency conflict.
- 429 or 503: follow retry guidance and back off. Repeat writes only with the operation's supported idempotency behavior.