Errors
Interpret HTTP failures and investigation stream failures correctly.
HTTP errors
| Status | Action |
|---|---|
400 | Fix the request; do not retry unchanged |
401 | Replace or restore the API key |
403 | Check mission ownership |
409 | Refresh the continuation token from the stream |
5xx | Retry safe requests; reconnect existing missions instead of duplicating them |
Stream failures
step.failed describes a failed fragment. turn.failed ends the active turn. session.failed is terminal. Preserve the events received before a failure for diagnostics.
Insufficient balance can also appear as a failed investigation event after a mission has been accepted. Add funds, then start or continue the mission as appropriate.
Next steps
Review streaming and the endpoint-specific error responses in the API reference.