Refund reserve

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" }'

{ "balance": 742 }

POST

ledger

refund

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" }'

{ "balance": 742 }

string

required

Reserve token.

string

Optional reason for the audit log.

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" }'

{ "balance": 742 }

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

Welcome

Guides

MCP

Agent skills

SDKs

API reference