---
title: "Filter workflows"
method: POST
path: "/api/workflows/list/"
tags: ["workflows"]
---

# Filter workflows

`POST /api/workflows/list/`

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

## Query parameters

- `page` integer
- `page_size` integer
- `sort_by` string

## Headers

- `Authorization` string, required

## Request body

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

## Response `200`

Successful response for Filter workflows

- WorkflowsFilterWorkflowsResponse200
  - `count` integer
  - `next` string, nullable
  - `previous` string, nullable
  - `results` ApiWorkflowsListPostResponsesContentApplicationJsonSchemaResultsItems[]
    - `id` string
    - `workflow_id` string
    - `version` integer
    - `name` string
    - `description` string, nullable
    - `type` 'automations' | 'monitors' | 'evaluators'
    - `trigger_event_type` string, nullable
    - `is_enabled` boolean
    - `is_starred` boolean
    - `is_read_only` boolean
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `deployed_version` integer, nullable
  - `filters_data` object — Filter metadata returned by the backend for building the filter UI.

## Other responses

- `401` — Unauthorized - Missing/invalid authentication

---

[API](https://skmtc.dev/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.dev/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/keywordsai/api-reference/revisions/58a2eabdccf3/schema)