Release a hold

POST/ledger/holds/{id}/release

Release a hold. A hold records the service that placed it, and only that service may release it. A hold no service owns — a legacy or legal hold — is released by a verified staff person (never an API key, never a service) holding ledger:holds:release who stepped up within five minutes; the release records them as released_by. The ledger's guard admits that scope on this route and nowhere else, so it reaches no journal, and it does not reach a hold a service owns. Every other caller is refused 403 forbidden; a missing or stale step-up answers step_up_required.

Path parameters

idstringRequired

Headers

Idempotency-KeystringOptional

Send on every write that creates or changes money or state; a replay with the same key returns the original result with 200.

Returns

200 OK

The Hold object.

Errors

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503