Common Errors

Authentication Errors

401 Unauthorized

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key"
  }
}

Solution: Check that your API key is correct and included in the x-api-key header.

403 Forbidden

{
  "error": {
    "code": "FORBIDDEN",
    "message": "Access denied to this resource"
  }
}

Solution: Verify your API key has access to the requested company/resource.

Rate Limiting

429 Too Many Requests

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded. Limit: 100 requests per minute."
  }
}

Solution:

Wait for the rate limit window to reset (check X-RateLimit-Reset header)
Reduce request frequency
Implement exponential backoff

Validation Errors

400 Bad Request

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid workflow configuration",
    "details": [
      { "field": "steps[0].id", "message": "Step ID is required" }
    ]
  }
}

Solution: Check the details array for specific field errors.

Not Found

404 Not Found

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Workflow not found"
  }
}

Solution: Verify the resource ID exists and belongs to your company.

Common Errors

On this page