> ## Documentation Index
> Fetch the complete documentation index at: https://kavenio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors

Successful JSON responses use:

```json theme={null}
{
  "ok": true,
  "data": {}
}
```

Failed JSON responses use:

```json theme={null}
{
  "ok": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Request validation failed.",
    "details": {}
  }
}
```

`details` is optional. When it is present, Kavenio redacts sensitive values such
as access tokens, refresh tokens, client secrets, bot tokens, API keys,
authorization headers, passwords, and bearer strings.

Common status codes:

| Status | Meaning                                               |
| ------ | ----------------------------------------------------- |
| `400`  | Malformed request or unsupported input shape          |
| `401`  | Missing or invalid authentication                     |
| `403`  | Authenticated caller cannot access the resource       |
| `404`  | Resource was not found                                |
| `409`  | Request conflicts with current resource state         |
| `422`  | Validation or domain rule failure                     |
| `500`  | Unexpected server failure                             |
| `501`  | Provider capability is unsupported or not implemented |