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

{
  "error": "Invalid access.",
  "message": "Invalid access.",
  "error_code": "validation_error"
}
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: 
{
  "error": "Invalid access."
}

​
404 Not Found

Fetch Hive returns 404 when the resource does not exist for your account. Example workflow run response: 
{
  "error": "Prompt workflow run not found"
}
Example request lookup response: 
{
  "error": "Request not found"
}

​
422 Unprocessable Entity

Fetch Hive returns 422 when the request is authenticated but invalid for that endpoint. Examples: 
{
  "error": "Agent not found."
}

{
  "error": "Data set not found."
}

{
  "error": "You've reached your credit cap."
}

​
502 Bad Gateway

Fetch Hive returns 502 when a provider fails while processing a prompt or agent request. Example: 
{
  "error": "openai API error: provider rejected the request"
}

​
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: 
{
  "error": "Daily API rate limit reached",
  "code": "api_rate_limit_exceeded",
  "message": "You have reached your daily limit of 50 API calls. Resets at midnight UTC. Upgrade your plan for higher limits.",
  "limit": 50,
  "current": 50
}
Workflow concurrency depends on your plan.
PlanConcurrency cap
Lite1
Starter3
Pro5
EntrepriseCustom
If you exceed your concurrency cap, Fetch Hive returns 429 Too Many Requests. Example: 
{
  "error": "You've reached your concurrency limit. Try again later or use async mode."
}
If you see this response on a workflow request, retry later or switch to callback delivery so Fetch Hive can queue the run.