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

# Error Model and Retries

> Handle Linquid API failures safely with retry strategy and idempotent writes

# Error Model and Retries

## Response model

Successful responses follow:

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

Error responses follow:

```json theme={null}
{ "error": "CODE", "code": "P003", "message": "...", "statusCode": 402 }
```

## Retry strategy

* Retry transient failures (`429`, `5xx`) with exponential backoff + jitter.
* Do not blindly retry validation/auth failures (`400`, `401`, `403`).
* Keep write paths idempotent using stable request identifiers.

## Safe retry policy

1. classify response (transient vs permanent)
2. retry only transient class
3. cap max attempts and total retry window
4. log request ID and final outcome

## Related

* `/developer/rate-limits-and-budgeting`
* `/developer/webhook-signatures-and-idempotency`