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

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

Response

items
array
Array of workflow objects
total
integer
Total number of workflows across all pages
page
integer
Current page number
per_page
integer
Number of items per page
total_pages
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