Skip to main content
PATCH
Move workflow automation

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Workflow id, agent id, or typed alias like workflows.slug / agents.slug

Body

application/json
folderId
string | null

Move a YAML workflow into this workflow folder. null files it at the tenant root. Ignored for the folder lookup when folderPath is also sent, but a string value is still validated before the path is applied.

folderPath
string

Slash-separated workflow folder path. Missing folders are created. Empty or / means root. When both fields are sent, folderPath wins after folderId validation.

Response

Updated automation

id
string
required

Implementation id for the automation. Workflow automations use workflow ids; agent automations use agent workflow ids.

type
enum<string>
required
Available options:
workflow,
agent
slug
string
required
name
string | null
required
folderId
string | null
required

Workflow folder id. Null for unfiled workflows, agent automations, and orphan registry rows.

folderPath
string | null
required

Slash-separated workflow folder path from the tenant root, such as billing/invoices. Null at root and for agent automations.

createdAt
required
description
string | null
status
string
version
string | null
triggers
object
implementationAvailable
boolean

False when the automations registry row exists but the workflow/agent implementation row is missing.

updatedAt
inputSchema
object | null
outputSchema
object | null