/recollection-case/{recollection_case_id}/set-stage

post

https://api-sandbox.getdefacto.com/recollection-case/{recollection_case_id}/set-stage

Set a recollection case's escalation stage

Set the case's current stage (pro-active, amiable, contentieux, judiciaire, in insolvency, or
sold to a third party) and record the justification. Governed by the recollection policy: a
stage transition always requires HumanReviewer.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

recollection_case_id

string

required

Body Params

escalation_comment

string | null

Defaults to null

Narrative justification for this stage, stored on recollection_case.payload.

stage

string

enum

required

The case's new escalation stage.

Allowed:

Headers

X-Decision-Id

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.

Responses

400

Missing X-Decision-Id header or value is not a valid UUID.

403

Decision is not approved, the calling identity does not match the proposer, no planned operation matches this endpoint + payload, the matching step has already been executed, or the caller is not a recognised proposing Operator.

404

No Decision exists for the supplied X-Decision-Id.

200