Move a pledge to pledged (with the lender's reference), releasing or released; a release that would leave advances uncovered is refused (treasury staff)

POST/ledger/collateral/pledges/{id}/transitions

The ledger's guard admits ledger:treasury:write on this route and refuses ledger:post; the store admits only verified treasury staff (never a service or an API key) who stepped up within five minutes. reserved to pledged (the lender's reference is required), releasing or released; pledged to releasing; releasing to released. A release that would leave more of the lender's advances uncovered is refused 409 conflict. The same transition replays and repeats lending's mirror.

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.

Body parameters

referencestringOptional

statestringRequired

Returns

200 OK

The Collateral Pledge object.

Errors

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

400401403404409412413422424429500503

Request

curl -X POST 'https://api.dev.bank.corgi.com/ledger/collateral/pledges/{id}/transitions' \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "state": "string"
  }'

Response200

{
  "asset": {
    "asset_class": "string",
    "id": 0,
    "kind": "string",
    "loan": {
      "as_of": "2026-09-17",
      "asset_class": "string",
      "charged_off": false,
      "days_past_due": 0,
      "loan_id": "loan_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "maturity_date": "2026-09-17",
      "maturity_unresolved": false,
      "nonaccrual": false,
      "participations_sold_amount": 10000,
      "product_code": "string",
      "status": "string",
      "unpaid_principal_amount": 10000
    },
    "maturity_date": "2026-09-17",
    "maturity_unresolved": false,
    "reference": "string",
    "updated_at": "2026-09-17T14:30:00Z",
    "valuation_as_of": "2026-09-17",
    "valuation_basis": "string",
    "valuation_sha256": "string",
    "value_amount": 10000
  },
  "created_at": "2026-09-17T14:30:00Z",
  "eligible": false,
  "haircut_bps": 0,
  "id": 0,
  "ineligibility": [
    "string"
  ],
  "lendable_amount": 10000,
  "lender_id": 0,
  "maker": "string",
  "pledge_reference": "string",
  "state": "string",
  "updated_at": "2026-09-17T14:30:00Z",
  "value_amount": 10000
}