---
title: "Get Workflows"
method: GET
path: "/v1/workflows"
tags: ["workflows"]
---

# Get Workflows

`GET /v1/workflows`

Get Workflows

## Query parameters

- `status` union — Filter by workflow status
  - 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELED' | 'TERMINATED' | 'CONTINUED_AS_NEW' | 'TIMED_OUT' | 'RETRYING_AFTER_ERROR'
  - WorkflowExecutionStatus[]
- `include_shared` boolean — Whether to include shared workflows
- `available_in_chat_assistant` boolean, nullable — Whether to only return workflows available in chat assistant
- `deployment_name` string[], nullable — Filter by deployment name(s)
- `deployment_status` 'active' | 'inactive', nullable — Filter by deployment activity. active=only active, inactive=only inactive, None=no filter
- `archived` boolean, nullable — Filter by archived state. False=exclude archived, True=only archived, None=include all
- `tags` string[], nullable — Filter to workflows tagged with all listed tags (AND).
- `sort_by` 'display_name', nullable — Field to sort by
- `order` 'asc' | 'desc' — Sort direction
- `cursor` string, nullable — The cursor for pagination
- `limit` integer — The maximum number of workflows to return
- `active_only` boolean — Deprecated: use deployment_status instead
- `search` string, nullable — Fuzzy search query for workflow name, display name, description, or ID

## Response `200`

Successful Response

- WorkflowListResponse
  - `workflows` WorkflowBasicDefinition[], required — A list of workflows
    - `id` string, uuid, required
    - `name` string, required — The name of the workflow
    - `display_name` string, required — The display name of the workflow
    - `description` string, nullable — A description of the workflow
    - `metadata` WorkflowMetadata
      - `shared_namespace` string, nullable — Namespace for shared workflows, None if user-owned
    - `archived` boolean, required — Whether the workflow is archived
    - `tags` string[] — Workflow tags
  - `next_cursor` string, nullable, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.net/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/revisions/933c4ebdcd72/schema)