Skip to main content
GET
List workflows

Authorizations

Authorization
string
header
required

A Modus personal access token (modus_<orgUuid>_<prefix>_<secret>) or an OAuth 2.1 access token, sent as Authorization: Bearer <token>.

Query Parameters

pageToken
string

Opaque page token from a previous response's nextPageToken. Omit for the first page.

pageSize
number

Max items per page. Defaults to 25, clamped to 100.

Required range: 1 <= x <= 100
Example:

25

view
enum<string>

Variation view. active reads deployed; draft reads the latest builder snapshot.

Available options:
active,
draft
type
enum<string>

Filter by workflow type.

Available options:
task,
workflow

Case-insensitive substring filter on workflow name.

Example:

"sales"

includeVariation
boolean

Include the requested variation payload (trigger, workflowStructure, agentSelection) on list rows.

Example:

false

Response

workflows
object[]
required

Page of workflows the caller can at least use. Workflows the caller cannot see are filtered out (not enumerated).

nextPageToken
string | null
required

Opaque token for the next page; null when this was the last page. Pass as pageToken on the next request.