Skip to content

Client API errors

The exact documented responses are shown per operation in the Client API reference. Common cases in the current REST routes include:

Status Current use
400 Zod validation, unsupported provider/model, or invalid runtime option.
401 Missing or invalid X-API-Key.
403 Package-level limits such as automation count.
404 User-scoped job, agent, or social account not found.
429 Monthly transaction limit reached.
500 Pipeline or persistence failure not mapped to a more specific status.

Asynchronous scrape and agentic jobs persist a failed status and error message when execution fails after the initial HTTP 202 response. Poll the matching status endpoint to obtain that state.