---
title: "List all workflow definitions"
method: GET
path: "/api/v1/workflows"
tags: ["Workflows"]
---

# List all workflow definitions

`GET /api/v1/workflows`

## Request

- Base URL: `https://api.korala.ai`
- URL: `https://api.korala.ai/api/v1/workflows`
- Auth: one of:
  - API key in header `X-API-Key`
  - `bearer` (a scheme the document does not define)

## Query parameters

- `page` number
- `limit` number
- `includePublic` boolean

## Headers

- `X-Korala-Mode` 'live' | 'test'

## Response `200`

- PaginatedManagedWorkflowDefinitionsDto
  - `total` number, required: Total number of workflows
  - `page` number, required: Current page number
  - `limit` number, required: Number of items per page
  - `totalPages` number, required: Total number of pages
  - `data` ManagedWorkflowDefinitionDto[], required
    - `sandbox` boolean, required: Persisted execution mode: true for test data
    - `id` string, required
    - `organizationId` string, nullable
    - `name` string, required
    - `slug` string, required
    - `description` string, nullable
    - `steps` WorkflowStepDto[], required
      - `type` 'capture' | 'ocr' | 'extract' | 'validate' | 'enrich' | 'check' | 'risk' | 'output' | 'review' | 'webhook', required
      - `config` object, required
    - `inputSchema` object, nullable
    - `outputSchema` object, nullable
    - `isPublic` boolean, required
    - `isActive` boolean, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required: When what a run executes last changed: the steps, output sharing, the input or output schema, or the slug. A rename, a new description or switching the workflow on or off leaves it alone.
    - `outputSharing` WorkflowOutputSharingRuleDto[], required
      - `stepIndex` number, required
      - `stepType` string: Physical step type, or workflow for its approval result.
      - `field` string, required: A verification field alias or output field path.
      - `scope` 'current_context', required

---

[API](https://skmtc.dev/korala/apis/korala-public-api.md) · [All operations](https://skmtc.dev/korala/apis/korala-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/korala/apis/korala-public-api/revisions/5c4d7810c507?raw)