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.
DiscordPlatform
DocumentationIntegrationsAPI referenceSDKsChangelog
DocumentationIntegrationsAPI referenceSDKsChangelog
  • API Reference
      • GETList workflows
      • POSTCreate a workflow
      • POSTFilter workflows
      • GETGet latest workflow draft
      • DELDelete workflow
      • PATCHUpdate latest workflow draft
      • GETList workflow versions
      • POSTCreate workflow version
      • GETGet workflow version
      • PATCHUpdate workflow version
      • POSTDeploy workflow version
      • DELUndeploy workflow
      • POSTValidate workflow
  • Reference
    • Filters API Reference
LogoLogo
DiscordPlatform
API ReferenceWorkflows

Filter workflows

POST
https://api.respan.ai/api/workflows/list/
POST
/api/workflows/list/
$curl -X POST https://api.respan.ai/api/workflows/list/ \
>     -H "Authorization: Bearer sk_live_xxxxx" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "filters": {
>    "type": {
>      "value": [
>        "monitors"
>      ],
>      "operator": "eq"
>    }
>  }
>}'
1{
2  "count": 1,
3  "next": null,
4  "previous": null,
5  "results": [
6    {
7      "id": "wv_draft_001",
8      "workflow_id": "wf_monitor_001",
9      "version": 2,
10      "name": "High error rate alert",
11      "description": "Alert when error rate rises above 5%",
12      "type": "monitors",
13      "trigger_event_type": "request_log",
14      "is_enabled": true,
15      "is_starred": false,
16      "is_read_only": false,
17      "created_at": "2026-04-01T10:00:00Z",
18      "updated_at": "2026-04-06T12:00:00Z",
19      "deployed_version": 1
20    }
21  ],
22  "filters_data": {
23    "type": {
24      "value": [
25        "monitors"
26      ],
27      "operator": "eq"
28    }
29  }
30}

List workflows with server-side filtering. Use the type filter in the request body to scope results to automations, monitors, or evaluators.

Was this page helpful?
Previous

Get latest workflow draft

Next
Built with

Headers

AuthorizationstringRequired

Bearer token. Use Bearer YOUR_API_KEY.

Query parameters

pageintegerOptional
Page number.
page_sizeintegerOptional
Results per page.
sort_bystringOptional

Sort field. Prefix with - for descending.

Request

This endpoint expects an object.
filtersmap from strings to anyRequired

Filter object keyed by field name. Include a type filter with value: ["automations"], ["monitors"], or ["evaluators"] and operator: "eq" to scope results.

Response

Successful response for Filter workflows
countinteger
nextstring or null
previousstring or null
resultslist of objects
filters_datamap from strings to any
Filter metadata returned by the backend for building the filter UI.

Errors

401
Unauthorized Error