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 <respanApiKey>" \
>      -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.

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.

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