Trigger a workflow
Trigger a workflow run on an existing session. The session must be in
`completed` or `failed` status. This is useful for retrying after
investigation, running a different workflow on an existing session,
or regulatory re-verification.
The previous workflow run (if any) is deleted and the session is set
to `processing`. The workflow executes asynchronously — poll the
session or use webhooks to track completion.
Requires the `workflows:write` scope.
Authentication
X-API-Keystring
Organization API key. Keys are prefixed with vk_live_ (production) or
vk_sandbox_ (sandbox).
Path parameters
workflow_id
Workflow ID (wfl_*).
Headers
Verifa-Version
API version date string (e.g. 2026-02-01). If omitted, the version
pinned to your API key is used.
Key-Inflection
Response key casing. Defaults to snake.
Allowed values:
Request
This endpoint expects an object.
session_id
The session to run the workflow on.
Response
Workflow trigger accepted. The session is now processing.
session_id
workflow_id
status
Errors
401
Unauthorized Error
404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error