Errors

HTTP error codes#

trained.chat uses standard HTTP status codes to indicate the success or failure of API requests:

• 200 - OK: Request succeeded.
• 400 - Bad Request: Missing required fields or parameters.
• 401 - Unauthorized: Invalid or missing API authorization key.
• 404 - Not Found: The requested agent, action, or resource does not exist.
• 429 - Rate Limited: Too many requests sent in a short window.

Error response structure#

All failed requests return a structured JSON response containing an error code and a human-readable message:

{
  "error": {
    "code": "unauthorized",
    "message": "The provided API key is invalid or has expired."
  }
}