Filter workflows | Respan Docs

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"
    }
  }
}'

{
  "count": 1,
  "results": [
    {
      "id": "wv_draft_001",
      "workflow_id": "wf_monitor_001",
      "version": 2,
      "name": "High error rate alert",
      "description": "Alert when error rate rises above 5%",
      "type": "monitors",
      "trigger_event_type": "request_log",
      "is_enabled": true,
      "is_starred": false,
      "is_read_only": false,
      "created_at": "2026-04-01T10:00:00Z",
      "updated_at": "2026-04-06T12:00:00Z",
      "deployed_version": 1
    }
  ],
  "filters_data": {
    "type": {
      "value": [
        "monitors"
      ],
      "operator": "eq"
    }
  }
}

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

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

Headers

Query parameters

Request

Response

Errors