List Workflows

Retrieve a paginated list of workflows in your workspace with optional filters.

GET /workflow-service/api/public/v1/workflows

List Workflows

cURL

curl --request GET \
  --url https://api.slatehq.ai/workflow-service/api/public/v1/workflows \
  --header 'Authorization: <authorization>'

200

{
  "data": [
    {
      "_id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "status": "<string>",
      "uuid": "<string>",
      "categories": [
        "<string>"
      ],
      "defaultVersion": 123,
      "totalVersions": 123,
      "emoji": "<string>",
      "color": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>"
    }
  ],
  "pagination": {
    "page": 123,
    "limit": 123,
    "total": 123,
    "totalPages": 123
  }
}

Returns a paginated list of workflows in the token’s workspace. Use query parameters to filter by status, search by name, and control pagination.

Parameters

Authorization · string · required

Bearer token. Format: Bearer slat_<your-token>.

status · string

Filter by workflow status. One of: draft, published.

search · string

Search workflows by name. Case-insensitive partial match.

page · integer

Page number for pagination. Default: 1.

limit · integer

Number of workflows per page. Default: 15.

Response

Returns 200 OK with a paginated list of workflows.

data · object[] · required

Array of workflow objects.

Show workflow object

_id · string · required

Unique identifier for the workflow.

name · string · required

Display name of the workflow.

description · string

Description of what the workflow does.

status · string · required

Current status. One of: draft, published.

uuid · string · required

Unique UUID for the workflow.

categories · string[]

Tags assigned to the workflow.

defaultVersion · number · required

The active published version number. 0 if no version has been published.

totalVersions · number · required

Total number of published versions.

emoji · string

Emoji icon for the workflow.

color · string

Color label for the workflow.

createdAt · string · required

Timestamp when the workflow was created. ISO 8601 format.

updatedAt · string · required

Timestamp of the last update. ISO 8601 format.

pagination · object · required

Pagination metadata.

Show pagination object

page · integer · required

Current page number.

limit · integer · required

Number of items per page.

total · integer · required

Total number of workflows matching the filters.

totalPages · integer · required

Total number of pages.

Example

cURL

curl -s "https://api.slatehq.ai/workflow-service/api/public/v1/workflows?status=published&page=1&limit=10" \
  -H "Authorization: Bearer slat_YOUR_TOKEN"

Response

{
  "data": [
    {
      "_id": "6789abc0def1234567890abc",
      "name": "SEO Content Generator",
      "description": "Generates SEO-optimized blog posts from a brand domain.",
      "status": "published",
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "categories": ["content", "seo"],
      "defaultVersion": 3,
      "totalVersions": 3,
      "emoji": "",
      "color": "blue",
      "createdAt": "2026-01-10T08:30:00.000Z",
      "updatedAt": "2026-01-25T14:15:00.000Z"
    },
    {
      "_id": "6789abc0def1234567890def",
      "name": "Competitor Analysis",
      "description": "Analyzes competitor domains and generates a comparison report.",
      "status": "published",
      "uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "categories": ["analytics"],
      "defaultVersion": 1,
      "totalVersions": 1,
      "emoji": "",
      "color": "green",
      "createdAt": "2026-01-15T10:00:00.000Z",
      "updatedAt": "2026-01-20T09:45:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 2,
    "totalPages": 1
  }
}

Results are sorted by updatedAt in descending order (most recently updated first).

Status codes

Status	Description
200	List returned.
401	Missing or invalid Bearer token. See Authentication.
500	Internal server error.

What’s next

• Get Workflow — Get full details for a specific workflow.
• Create Workflow Run — Trigger a run for a workflow.