Dry-run a workflow draft

POST

https://devapi.withverifa.com/api/v1/workflows/:workflow_id/drafts/:draft_id/dry-run

Simulates the draft’s graph against a sandbox preset and returns per-node step results. Optionally accepts an inline graph to run instead of the stored draft graph.

Required scope: workflows:read

Authentication

X-API-Keystring

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

Path parameters

workflow_idstringRequired

draft_idstringRequired

Request

This endpoint expects an object.

presetstringRequired

Sandbox preset name that drives the simulated responses.

graphmap from strings to any or nullOptional

Optional inline graph to simulate instead of the stored one.

Response

Dry-run result.

stepslist of objects

presetstring

preset_descriptionstring

Errors

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error

$	curl -X POST https://devapi.withverifa.com/api/v1/workflows/workflow_id/drafts/draft_id/dry-run \
>	-H "X-API-Key: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"preset": "standard_identity_check"
>	}'

1	{
2	"steps": [
3	{
4	"node_id": "node_12345",
5	"node_type": "document_verification",
6	"policy": "passport_check",
7	"status": "completed",
8	"passed": true,
9	"details": {},
10	"duration_ms": 350,
11	"routed_to": "verifa_sandbox_server_1",
12	"outcome": "approved"
13	}
14	],
15	"preset": "standard_identity_check",
16	"preset_description": "Simulates a standard identity verification workflow including document verification and liveness check."
17	}

Authentication

Path parameters

Headers

Request

Response

Errors