Skip to main content
Fetch Hive returns JSON errors for invalid or failed public API requests. Runtime public API errors include a human-readable message, a stable code, and error as a compatibility alias.

Error response format

Some plan and rate-limit responses also include code for compatibility with existing clients. New clients should read error_code. See Error Codes for the complete code list, catalog endpoint, and client handling guidance.

Common status codes

401 Unauthorized

Fetch Hive returns 401 when the Authorization header is missing, invalid, or uses a revoked API key. Example:

404 Not Found

Fetch Hive returns 404 when the resource does not exist for your account. Example workflow run response:
Example request lookup response:

422 Unprocessable Entity

Fetch Hive returns 422 when the request is authenticated but invalid for that endpoint. Examples:

502 Bad Gateway

Fetch Hive returns 502 when a provider fails while processing a prompt or agent request. Example:

Rate limits and concurrency

Public API requests count against your plan daily API call cap. If you exceed that cap, Fetch Hive returns 429 Too Many Requests before running the request. Example daily API cap response:
Workflow concurrency depends on your plan. If you exceed your concurrency cap, Fetch Hive returns 429 Too Many Requests. Example:
If you see this response on a workflow request, retry later or switch to callback delivery so Fetch Hive can queue the run.