Skip to main content
GET
List Workflows
Retrieve a paginated list of workflows in your organization. Workflows are a visual orchestration layer for your AI agents — deterministic, multi-step pipelines where you arrange agents, tools, and logic nodes on a canvas to control execution order, branching, and data flow. In the API, workflows are represented as agents with type: "orchestration". Every node in a workflow is powered by an AI agent, so the execution path is predictable but the intelligence at each step is adaptive.

Query Parameters

integer
default:1
Page number (starting from 1)
integer
default:20
Items per page (maximum 50)

Response

array
Array of workflow objects
integer
Total number of workflows across all pages
integer
Current page number
integer
Number of items per page
integer
Total number of pages available

Example Request

Notes

  • Only workflows (type: orchestration) are returned — regular agents are excluded
  • Results are filtered by API key permissions
  • Use pagination to handle large result sets
  • See the Workflows user guide for details on the visual canvas and node types

Authorizations

x-api-key
string
header
required

API Key for authentication

Query Parameters

page
integer
default:1

Page number (starting from 1)

Required range: x >= 1
per_page
integer
default:10

Items per page (max 50)

Required range: 1 <= x <= 50

Response

Successful Response

items
WorkflowResponse · object[]
required
total
integer
required
page
integer
required
per_page
integer
required
total_pages
integer
required