MCP tools
Save workflow
Create or update a Workflow.
Tool name: save-workflow.
Create or update a Workflow. Omit workflowId to create a new one; pass it to update. spec holds the full workflow definition. WRITE.
When to use
Persist a new or edited workflow spec. Include a review_gate node when a human should approve before launch.
Access
| Property | Value |
|---|---|
| Required scope | write |
| Publishes | No |
| Read-only | No |
| Destructive | Yes |
| Idempotent | No |
| Open world | No |
Input
| Field | Type | Required | Description |
|---|---|---|---|
workflowId | string | No | |
name | string | No | |
type | string | No | One of visual, agent, template. |
spec | object | Yes | Full workflow spec: { name, type, trigger, triggerAdded, nodes[], agentPrompt? } |
Output
The tool catalog does not declare an output schema for this tool.
REST equivalent
POST /v1/brands/{brandId}/workflows, Save workflow. CLI: koast save-workflow.