Error Handling

Error Response Format

All Tiro API errors follow a consistent JSON structure:

{
  "error": {
    "code": 400001,
    "message": "Human readable error message",
    "detail": "Additional context or null"
  }
}

Status Code	Meaning	When It Occurs
400	Bad Request	Invalid request format or parameters
401	Unauthorized	Missing or invalid API key
403	Forbidden	API key lacks required permissions
404	Not Found	Resource doesn’t exist
409	Conflict	Resource already exists or state conflict
413	Payload Too Large	File exceeds size limits
415	Unsupported Media Type	Invalid file format
422	Unprocessable Entity	Valid format but invalid data
429	Too Many Requests	Rate limit exceeded
500	Internal Server Error	Unexpected server error
503	Service Unavailable	Temporary service outage