SAsanctionskit
Review evidence

Open a review case for an existing retained screening

Required API key scope: cases:write.

Creates an open case for standard-retention evidence when a case was not already created automatically. Send decision=open; completed decisions require the human investigation workflow and return investigation_review_required. No Idempotency-Key contract applies to this endpoint. Before retrying an uncertain response, query GET /cases?screeningId=...; duplicate creation returns case_exists with error.details.caseId.

post/cases

Request

Request body

decision'open' required

Must be open when creating a case. Completed decisions require the human investigation workflow and return investigation_review_required here.

notesstring required

Nonempty opening rationale, trimmed before validation. Retained under the case policy.

screeningIdstring uuid required

UUID of a retained standard screening in this organization and environment. An existing case returns case_exists; minimal or expired evidence cannot be used.

expectedUpdatedAtstring date-time

Legacy optional timestamp accepted and echoed by creation. It is not a concurrency guard for a new case; omit it.

Response

Successful response. JSON object with the required data key. All properties marked required are present, including keys whose value may be null. Unmarked properties can be omitted; clients should tolerate additional response properties.

Changes

No recorded changes to this operation across all 1 revision of this API.