---
title: "List workflows"
method: GET
path: "/v1/workspaces/{workspace_id}/workflows/"
tags: ["Workflows"]
---

# List workflows

`GET /v1/workspaces/{workspace_id}/workflows/`

## Request

- Base URL: `https://api.stacksync.com`
- URL: `https://api.stacksync.com/v1/workspaces/{workspace_id}/workflows/`
- Auth: HTTP bearer

The workflows of the workspace the caller sees on the web app's Resources page (their own and those shared with the workspace), newest first, one page per region (or of the region asked for). Optionally only the workflows directly in a folder, or those whose name or id contains a text.

## Path parameters

- `workspace_id` integer, required

## Query parameters

- `region` 'besg' | 'usnv'
- `offset` integer, nullable: Offset for pagination. Used to skip a number of workflows.
- `limit` integer: Maximum number of workflows of each region, at most 200
- `folder_id` string, nullable: Only the workflows directly in this folder
- `search` string, nullable: Only the workflows whose name, id or resource id contains this text

## Response `200`

OK

- WorkflowList: The documented list answer, one page of each region asked for
  - `workflows` WorkflowListItem[], required
    - `workflow_id` string, required
    - `workflow_name` string, required
    - `workflow_resource_id` string, required
    - `workflow_status` 'running' | 'paused' | 'deleted', required
    - `workspace_id` integer, required
    - `is_shared_with_workspace` boolean, nullable
    - `module_app_type_display_list` string[], nullable
    - `parent_folders` ParentFolderModel[], nullable
      - `parent_folder_id` string, uuid4, required
      - `type` 'primary' | 'shortcut', required
    - `created_by` integer, required
    - `created_time` string, required
    - `last_modified_by` integer, required
    - `last_modified_time` string, required
    - `region` 'besg' | 'usnv', required

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Content

---

[API](https://skmtc.dev/stacksync/apis/stacksync-api.md) - [All operations](https://skmtc.dev/stacksync/apis/stacksync-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stacksync/apis/stacksync-api/revisions/21f4ba4b214e?raw)