List Workflows

Endpoint

GET https://api.eachlabs.ai/v1/workflows

Returns the workflows visible to your organization, newest first.

Query Parameters

Parameter	Type	Required	Description
`limit`	integer	No	Page size. Defaults to 50, capped at 100
`offset`	integer	No	Page start. Defaults to 0
`category`	string	No	Keep only workflows carrying this category slug
`keyword`	string	No	Free-text match on the workflow name
`sort_key`	string	No	`name`, `created_at`, `updated_at`, `trigger_count`, or `status`
`sort_direction`	string	No	`asc` or `desc`
`node_based`	boolean	No	Keep only workflows whose `node_based` flag matches

sort_key and sort_direction only take effect together — sending one without the other leaves the default ordering in place.

Code Examples

curl "https://api.eachlabs.ai/v1/workflows?limit=20&category=image-generation" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response = requests.get(
    "https://api.eachlabs.ai/v1/workflows",
    params={"limit": 20, "category": "image-generation"},
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
page = response.json()
for workflow in page["workflows"]:
    print(f"{workflow['workflow_id']} | {workflow['name']}")
print(f"{page['total_count']} workflows total")

const params = new URLSearchParams({ limit: "20", category: "image-generation" });
const response = await fetch(
  `https://api.eachlabs.ai/v1/workflows?${params}`,
  { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
);
const page = await response.json();
page.workflows.forEach((w) => console.log(`${w.workflow_id} | ${w.name}`));
console.log(`${page.total_count} workflows total`);

Response

{
  "workflows": [
    {
      "workflow_id": "50741f40-8621-4d46-8a91-dff4d873be98",
      "slug": "text-to-image-generator",
      "name": "Text to Image Generator",
      "categories": ["image-generation"],
      "tags": ["demo"],
      "status": "active",
      "trigger_count": 42,
      "clone_count": 3,
      "is_public": false,
      "production": false,
      "node_based": false,
      "created_at": "2025-12-01T10:00:00Z",
      "updated_at": "2025-12-07T15:30:00Z"
    }
  ],
  "offset": 20,
  "total_count": 231
}

Response Fields

Field	Type	Description
`workflows`	object[]	The page of workflows
`offset`	integer	Start of the next page; present while pages come back full
`total_count`	integer	Full result-set size for the applied filters

Workflow Fields

Field	Type	Description
`workflow_id`	string	Workflow UUID
`slug`	string	URL-friendly workflow identifier
`name`	string	Human-readable workflow name
`categories`	string[]	Category slugs
`tags`	string[]	Free-form workflow tags
`status`	string	`active`, `archived`, or `deleted`
`trigger_count`	integer	Total executions triggered across all versions
`clone_count`	integer	Number of times the workflow has been cloned
`is_public`	boolean	Whether the workflow appears in public listings
`production`	boolean	Whether this is a production workflow
`node_based`	boolean	Whether the workflow’s latest active version runs as a node graph
`created_at`	string	RFC3339 creation timestamp
`updated_at`	string	RFC3339 update timestamp

Rows carry summary fields only. Use Get Workflow for a workflow’s versions and definition.

Pagination

offset in the response is the start of the next page, not an echo of the offset you sent. It is present whenever the page came back full, so a full final page still carries one — page until a page returns fewer than limit rows:

LIMIT = 100
offset, workflows = 0, []
while True:
    page = requests.get(
        "https://api.eachlabs.ai/v1/workflows",
        params={"limit": LIMIT, "offset": offset},
        headers={"Authorization": "Bearer YOUR_API_KEY"}
    ).json()
    workflows.extend(page["workflows"])
    if len(page["workflows"]) < LIMIT:
        break
    offset = page["offset"]

Error Responses

Status	Body	Description
`401`	`{"error": "Invalid or missing API key"}`	Authentication failure

Overview

Concepts

API Reference

OpenAPI Reference

Webhooks

Examples

Endpoint

Query Parameters

Code Examples

Response

Response Fields

Workflow Fields

Error Responses

​Endpoint

​Query Parameters

​Code Examples

​Response

​Response Fields

​Workflow Fields

​Pagination

​Error Responses

Endpoint

Query Parameters

Code Examples

Response

Response Fields

Workflow Fields

Pagination

Error Responses