Approve or reject a version of an advance's structure terms (a treasury checker other than its maker)

POST/ledger/borrowings/{id}/structure-terms/{version}/review

The ledger's guard admits ledger:treasury:write; the store also requires operations:approve, a step-up within five minutes and a checker other than the record's maker, refused 422 ledger.maker_checker_required. The same decision by the same checker replays; a different one is 409 conflict.

Path parameters

idstringRequired

versionstringRequired

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

approvebooleanRequired

reasonstringRequired

Returns

200 OK

borrowing_idstringRequired

content_sha256stringRequired

effective_datestring · dateRequired

A business date, YYYY-MM-DD

makerstringRequired

optionsarray of objectsRequired

4 child attributes

descriptionstringRequired

exercised_datestring · date or nullOptional

Call or put exercised: the date it repays the advance

first_exercise_datestring · date or nullOptional

Call, conversion and put

kindstringRequired

rate_typestringRequired

recorded_atstring · date-timeRequired

reviewobject or nullOptional

ReviewRecord is a retained review.

5 child attributes

approvebooleanRequired

checkerstringRequired

journal_idstringOptional

Example jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm

reasonstringRequired

recorded_atstring · date-timeRequired

source_refstringRequired

source_sha256stringRequired

statusstringRequired

Pending_review, approved or rejected

versionintegerRequired

Errors

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

400401403404409412413422424429500503