Talkr AI
API ReferenceAgents

Validate Workflow

Validate a workflow definition without executing it

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.

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

Path Parameters

workflow_id*Workflow Id

Header Parameters

authorization?string|null
X-API-Key?string|null

Response Body

application/json

application/json

curl -X POST "https://example.com/api/v1/workflow/0/validate"
{  "is_valid": true,  "errors": [    {      "kind": "node",      "id": "string",      "field": "string",      "message": "string"    }  ]}