Skip to main content
GET
List folders

Authorizations

Authorization
string
header
required

API key issued from Settings → API Keys. Pass as Authorization: Bearer <key>.

Query Parameters

type
enum<string>
required

Folder tree to list. Required; there is no default.

Available options:
workflow,
template
parentId
string

Limit to direct children of this folder. Pass null for root folders only. Ignored when tree=true.

tree
string

When true, return the full tree for type with child counts (and workflow previews for workflow trees).

Response

Folders in the requested tree

id
string
required
parentId
string | null
required
type
enum<string>
required
Available options:
workflow,
template
name
string
required
createdAt
required
childCount
integer

Direct subfolder count. Present on tree listings.

Required range: -9007199254740991 <= x <= 9007199254740991
workflowCount
integer

Workflows filed directly in this folder. Present on workflow-tree listings.

Required range: -9007199254740991 <= x <= 9007199254740991
previewItems
object[]

Up to a handful of item names — subfolders first, then workflows — for a peek at folder contents. Present on workflow-tree listings.