> For the complete documentation index, see [llms.txt](https://elacity.gitbook.io/elacity-sdks/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://elacity.gitbook.io/elacity-sdks/documentation/api/getting-started/errors-and-retries.md).

# Errors and Retries

This guide describes how to handle API failures reliably in client integrations.

## Error Handling Model

* Separate transport/network failures from application-level errors.
* Use structured error payload fields to classify retryable vs terminal failures.
* Log request/correlation identifiers when available for faster troubleshooting.

## Retry Guidance

* Retry transient failures with bounded exponential backoff.
* Do not retry validation/authentication errors without changing input/session state.
* Apply idempotency safeguards for write operations where relevant.

## Practical Checklist

* Capture endpoint, payload shape, and response code/body in logs.
* Include chain/environment context for cross-network integrations.
* Fail fast on authorization or schema errors; retry only transient classes.
