Reference

Error codes

All errors return JSON in the shape:

json

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable message",
    "details": { "optional": "context" }
  }
}

Code	HTTP	Meaning
`UNAUTHORIZED`	401	Missing or invalid credentials
`INVALID_API_KEY`	401	API key not recognized
`REVOKED_API_KEY`	401	API key was revoked
`FORBIDDEN`	403	Authenticated but not allowed
`NOT_FOUND`	404	Resource does not exist
`VALIDATION_ERROR`	400	Request body failed schema validation
`EVENT_TOO_LARGE`	413	A payload field (typically `metadata` or `targets`) exceeded its size cap. `details` carries the offending field, its size and the limit
`PLAN_LIMIT_REACHED`	429	Monthly event quota hit
`RATE_LIMITED`	429	Too many requests in the current window
`DATABASE_ERROR`	500	Underlying DB error
`INTERNAL_ERROR`	500	Unhandled server error