Documentation

Error Handling

Common response shapes and failure cases

API Errors

Error shape usually follows:

json

{
  "ok": false,
  "error": {
    "code": "validation_error",
    "message": "title is required",
    "details": null
  }
}

Some non-versioned attachment upload/download routes return simpler shape:

json

{
  "error": "Upload session not found"
}

Code	Meaning
`unauthorized`	Missing or invalid session/token
`validation_error`	Request body, params, or upload invalid
`not_found`	Snippet, attachment, or upload session missing
`rate_limited`	In-memory rate limit exceeded
`internal_error`	Unexpected server error
`service_unavailable`	Readiness check failed