Validate Workflow

Validate a workflow definition without executing it

POST /api/v1/workflow/{workflow_id}/validate

Validate Workflow

cURL

curl --request POST \
  --url https://app.dograh.com/api/v1/workflow/{workflow_id}/validate

200

{
  "is_valid": true,
  "errors": [
    {
      "kind": "node",
      "id": "<string>",
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

Checks the current workflow definition for structural errors — missing required fields, invalid node configurations, broken edge references — without placing a call or creating a run.

If invalid, the response includes a list of errors each with a kind (node, edge, or workflow), the offending id, the field, and a human-readable message. See Errors for the full error schema.

Headers

authorization · string | null

X-API-Key · string | null

Path Parameters

workflow_id · integer · required

Response

200

application/json

Successful Response

is_valid · boolean · required

errors · WorkflowError · object[] · required

Show child attributes