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

# Refund reserve

> Release a pending reserve without spending.

<ParamField body="token" type="string" required>Reserve token.</ParamField>
<ParamField body="reason" type="string">Optional reason for the audit log.</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.lavendly.ai/v1/ledger/refund \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer $LAVENDLY_API_KEY' \
    -d '{ "token": "rsv_lq3z9m_8fa1c0", "reason": "upstream_timeout" }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  { "balance": 742 }
  ```
</ResponseExample>

Like commit, refunding an unknown token is a no-op, safe to retry.
