four-eyes-gated

Set a recollection case's collection objective

Set the case's estimated recoverable amount over exactly three horizons (within 5 business days, within a month, ever), the collection phase, and the justification. Governed by the recollection policy §4/§9: the reasoning must assess the borrower's liquidity and near-term trajectory, with a likelihood stated per horizon.

post/recollection-case/{recollection_case_id}/set-objective

Path parameters

recollection_case_idstring required

Headers

X-Decision-Idstring uuid required

UUID of an approved governance Decision whose planned_operations list this endpoint together with the exact request payload. The matching planned step must not yet have been executed. Planned operations may contain {{step.<n>.json.<path>}} references to earlier steps' responses: the gate resolves them against the recorded outputs before matching, so send the RESOLVED body and fire steps in order — a step whose references are not yet resolvable cannot match. Required for MCP callers; HumanReviewer callers bypass the gate by default.

Request body

collection_phase'1st-payment-paid' | 'bad-faith' | 'fully-repaid' | 'promise-to-pay' | 'respected-installment-so-far' required
objective_commentstring required

Justification for the stated objective.

Response

OK

Changes

Changed in 1 of the 13 revisions of this API.1