Skip to main content
PATCH
Update folder

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Folder id (fldr_…).

Body

application/json
name
string

New folder name. Cannot contain /.

Required string length: 1 - 255
parentId
string | null

New parent folder id. null moves the folder to the tree root.

Response

Updated 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.