Reserve transaction capacity (phase one)

Use this endpoint to reserve transaction capacity against spending limits — phase one of the two-phase reservation flow. Provide the ledger transactionId the reservation is keyed on; the response returns one reservation ID per counter-backed limit that must later be confirmed or released. When a spending limit would be exceeded, the response is returned with denied set to true and no capacity is held. Reserves are idempotent by transactionId — retrying the same reserve returns the same handle.

POST /v1/reservations

Reserve transaction capacity (phase one)

cURL

curl --request POST \
  --url https://tracer.sandbox.lerian.net/v1/reservations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '"<string>"'

201

{
  "denied": false,
  "reservationIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

BearerAuthApiKeyAuth

Authorization · string · header · required

JWT bearer token issued by the identity provider.

Body

application/json

The body is of type file.

Response

201

application/json

Created

denied · boolean · required

Example:

false

reservationIds · string<uuid>[] | null · required

transactionId · string<uuid> · required