Error Reference

​

Error Response Format

{
  "error": "Human-readable error message"
}

​

HTTP Status Codes

​

Common Errors

​

400: Bad Request

{
  "error": "slug parameter is required"
}

• Missing required parameters
• Invalid parameter types or values
• Malformed JSON body
• Input validation failure

​

401: Unauthorized

{
  "error": "Invalid or missing API key"
}

• X-API-Key header not included
• API key is invalid or expired

​

403: Forbidden

{
  "error": "Workflow is locked and cannot be modified"
}

• Attempting to modify a locked workflow or version
• Insufficient permissions for the requested operation

​

404: Not Found

{
  "error": "Failed to fetch model: model not found"
}

• Invalid model slug
• Non-existent prediction ID, workflow ID, or execution ID
• Resource was deleted

​

429: Rate Limited

{
  "error": "Rate limit exceeded. Please retry after 60 seconds."
}

• Implement exponential backoff
• Check the Retry-After header when available
• Consider reducing request frequency

​

500: Internal Server Error

{
  "error": "Failed to fetch models: internal error"
}

• Retry with exponential backoff
• If persistent, contact support

​

Product-Specific Errors

​

each::api: Prediction Errors

​

each::workflows: Execution Errors

​

each::sense: Agent Errors

​

Retry Strategy

import time
import requests

def request_with_retry(url, headers, json=None, max_retries=3):
    for attempt in range(max_retries):
        response = requests.post(url, headers=headers, json=json)
        if response.status_code in (429, 500):
            wait = 2 ** attempt
            time.sleep(wait)
            continue
        return response
    return response

async function requestWithRetry(url, options, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    const response = await fetch(url, options);
    if ([429, 500].includes(response.status)) {
      await new Promise((r) => setTimeout(r, 2 ** attempt * 1000));
      continue;
    }
    return response;
  }
  return response;
}