Validate workflow

POST

https://api.respan.ai/api/workflows/:workflow_id/validations/

Validate a workflow configuration and fire preview delivery sends. The backend validates the workflow identified by the path parameter and does not consume a request body.

Authentication

AuthorizationBearer

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, OpenAI or Azure OpenAI provider credentials go in Settings -> Providers or the request body credential_override field, not in this auth field.

Path parameters

workflow_idstringRequired

Workflow ID.

Response

Workflow validation result

statusenum

validationobject

task_resultslist of objects

is_all_passedboolean

Errors

401

Unauthorized Error

404

Not Found Error

$	curl -X POST https://api.respan.ai/api/workflows/workflow_id/validations/ \
>	-H "Authorization: Bearer <respanApiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"status": "success",
3	"validation": {
4	"is_valid": true,
5	"error": null
6	},
7	"task_results": [
8	{
9	"task_id": "email-delivery-check",
10	"task_type": "delivery",
11	"status": "passed",
12	"message": null
13	},
14	{
15	"task_id": "monitor-threshold",
16	"task_type": "condition",
17	"status": "passed",
18	"message": null
19	}
20	],
21	"is_all_passed": true
22	}