Skip to main content
POST
Create folder

Authorizations

Authorization
string
header
required

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

Body

application/json
name
string
required

Folder name. Cannot contain /.

Required string length: 1 - 255
type
enum<string>
required

Which folder tree to create in. Required; there is no default.

Available options:
workflow,
template
parentId
string | null

Parent folder id. Omit or null to create at the tree root.

Response

Created folder

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.