> For the complete documentation index, see [llms.txt](https://docs.yifi.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yifi.io/api-reference/errors.md).

# Errors

Unhandled exceptions and `HttpException` bodies are wrapped as:

```json
{ "success": false, "error": { "code": "STRING", "message": "…", "requestId": "…", "timestamp": "ISO-8601", "details": {} } }
```

`details` is present only on some 4xx errors. `X-Request-Id` is always set on the response (generated if the client did not send `x-request-id`).

Unknown query/body fields are rejected (`forbidNonWhitelisted`). Validation failures use HTTP 400.