API ReferenceWorkflows

Get session workflow run

Returns the workflow run for a session, including which steps were executed and their individual results.

Authentication

X-API-Keystring

Organization API key. Keys are prefixed with vk_live_ (production) or vk_sandbox_ (sandbox).

Path parameters

session_idstringRequired

Session ID (ses_*).

Headers

Verifa-VersiondateOptional

API version date string (e.g. 2026-02-01). If omitted, the version pinned to your API key is used.

Key-InflectionenumOptionalDefaults to snake

Response key casing. Defaults to snake.

Allowed values:

Response

Workflow run details.
idstring
Workflow run ID.
session_idstring
workflow_idstring
statusenum

Current status of the workflow run. paused indicates the run is waiting for an external gate decision.

Allowed values:
created_atdatetime
final_statusstring or null
Overall workflow outcome once completed.
graph_snapshotmap from strings to any or null

Snapshot of the workflow graph as it was when the run started. Present for graph-format runs.

paused_at_nodestring or null

Node ID where the workflow is paused (e.g., waiting for external gate decision). Present only when status is “paused”.

current_nodestring or null

ID of the current or last executed graph node. Present for graph-format runs.

node_resultsmap from strings to objects or null

Results keyed by node ID for graph-format runs. Each entry contains the policy name, execution status, pass/fail result, duration, and routing target.

started_atdatetime or null
completed_atdatetime or null
duration_msinteger or null
Total workflow execution time in milliseconds.

Errors

401
Unauthorized Error
404
Not Found Error