Update an Evaluation State

put

https://riskos.socure.com/api/evaluation/{eval_id}/state

Updates evaluation metadata, including decision, status, and sub_status, and optionally adds notes or a base64-encoded attachment.

Path Params

eval_id

uuid

required

The system-generated unique ID for the evaluation. Capture this value from the initial POST /api/evaluation response.

Headers

X-API-Version

string

Specifies the API version used for the request. If omitted, the default version is used. Socure recommends pinning a version to avoid unexpected behavioral changes when new versions are released.

Body Params

workflow

string

required

Your environment-specific workflow identifier.

Note: The workflow name must be unique within your RiskOS™ environment. It is not scoped by use case and must identify a single active workflow for each Evaluation API request.

decision

string

enum

required

The new decision value to apply.

Allowed: