v3

latestOpenAPI 3.1.02026-07-311,4541,5202.3 MB
workflows

Validate Workflow

Validate a workflow's configuration and fire preview delivery sends.

POST /api/workflows/<workflow_id>/validations/

Validates structure, per-task config, and upstream state references, then dispatches real preview notifications and webhooks so users can verify their delivery channels. Unresolved template variables render as the token {{placeholder}}. No aggregation runs; no logs are fetched.

Returns: status, validation, task_results, is_all_passed

post/api/workflows/{workflow_id}/validations/

Path parameters

workflow_idstring required

Headers

Authorizationstring required

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

Response

status'success' | 'validation_error' required
  • success - success
  • validation_error - validation_error
is_all_passedboolean required