Errors

Response format

All errors return JSON with an error field:

{ "error": "Not found" }

Some errors include additional fields:

{
  "error": "Upgrade required",
  "upgrade": true,
  "plan_required": "agency"
}

Code	Meaning
`200`	OK
`201`	Created
`400`	Bad request — missing or invalid fields
`401`	Unauthenticated — missing or invalid API key/session
`403`	Forbidden — valid auth, insufficient permissions or plan
`404`	Not found
`409`	Conflict — duplicate resource
`422`	Unprocessable — validation failed
`429`	Rate limited
`500`	Server error

{ "error": "title is required" }

{ "error": "Unauthorized" }

{
  "error": "Free plan allows up to 3 event types",
  "upgrade": true
}

{ "error": "Not found" }

{ "error": "Time slot unavailable" }

Limits are per API key per minute. If you hit a 429, back off and retry. Headers are not currently exposed but will be added in a future release.