← Back to home

Error Responses

Standard error format used across all API endpoints.

Format

// Simple error
{ "error": "Unauthorized" }

// Validation error
{
  "error": "Validation failed",
  "issues": [
    { "path": "title", "message": "Title is required" },
    { "path": "start", "message": "start must be an ISO 8601 datetime" }
  ]
}

Status Codes

400Bad request or validation error. Check the issues array for field-level details.
401Missing or invalid API key. Ensure you're sending the Authorization: Bearer header.
403Not authorized to access this resource. The API key is valid but doesn't own the requested resource.
404Resource not found. The ID doesn't exist or doesn't belong to your agent.