For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.

Discord Platform

Documentation Integrations API reference SDKs Changelog

Documentation Integrations API reference SDKs Changelog

API Reference
Reference
- Filters API Reference

Discord Platform

API Reference Workflows

Validate workflow

POST

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

POST

/api/workflows/:workflow_id/validations/

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

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

Validate a workflow against a sample log without triggering real side effects. No notifications, webhooks, or dataset writes are performed.

Was this page helpful?

Filters API Reference

This document describes the filtering system used across Respan endpoints (spans, traces, threads, etc.).

Path parameters

workflow_idstringRequired

Workflow ID.

Headers

AuthorizationstringRequired

Bearer token. Use Bearer YOUR_API_KEY.

Request

This endpoint expects an object.

log_idstringOptional

Specific log ID to use as the validation sample. If omitted, the backend uses the most recent organization log.

Response

Workflow validation result

statusenum

Allowed values:

validationobject

task_resultslist of objects

is_all_passedboolean

Errors

401

Unauthorized Error

404

Not Found Error