# Error Model

Alle API-fouten gebruiken `application/problem+json`:

```json
{
  "type": "https://ragcore.example.test/problems/space-forbidden",
  "title": "Knowledge space access denied",
  "status": 403,
  "code": "SPACE_FORBIDDEN",
  "detail": "The caller is not allowed to use one or more requested spaces.",
  "trace_id": "..."
}
```

## Regels

- `code` is stabiel en machineleesbaar.
- `detail` bevat geen secrets, SQL, filesystemroots of providerkeys.
- Validation errors bevatten veldpaden en veilige redenen.
- Provider/downstream errors worden gemapt naar RAGCore-codes.
- Retryable errors geven optioneel `retry_after_seconds`.
- 404 mag voor gevoelige resources worden gebruikt waar 403 bestaan zou lekken.