{ "ok": false, "error": "Human-readable reason" }
invocationId.
| Status | When | Example error |
|---|---|---|
400 | Malformed body, missing actionId, input fails schema | Invalid input: missing username |
401 | No token, or token expired | An active session cookie or Bearer token is required |
403 | Cross-origin POST, or disallowed host | Cross-origin writes are not allowed |
404 | Action not registered in this session, or unknown route | Unknown action: not registered in this session |
405 | Wrong method | Unsupported route or method |
409 | No page snapshot, no live tab, another action in flight, or session attached to another page | Another action is in flight. Read the manifest before retrying. |
413 | Body over 64 KiB | Request body exceeds 64 KiB |
415 | POST without JSON content type | Content-Type must be application/json |
422 | The page’s handler threw | Handler’s own message |
503 | Unexpected server failure | Agent bridge unavailable. Check server logs. |
504 | Tab didn’t answer in time | Timed out; outcome is unknown… |
504 means unknown, not failed. Re-read state before deciding anything.