update_workflow
Modify existing workflows by updating specific fields. Changes to live workflows create drafts for review before activation.
Instructions
Update an existing workflow. Provide only the fields you want to change.
IMPORTANT: If the workflow is live, config edits (steps, context, name, etc.) are automatically routed to a draft snapshot instead of modifying the live pipeline. The response will include editingDraft: true. Use get_draft to view the draft, promote_draft to make it live, or discard_draft to throw away the changes. Non-live workflows are updated directly with an automatic pre-edit snapshot for rollback.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| workflowId | Yes | The workflow ID to update | |
| updates | Yes | Partial pipeline updates (name, steps, context, etc.) | |
| locale | No | Locale (default: en) |
Implementation Reference
- src/tools/workflows.ts:75-99 (handler)The update_workflow tool handler implementation in src/tools/workflows.ts which calls client.updateWorkflow.
server.tool( 'update_workflow', `Update an existing workflow. Provide only the fields you want to change. IMPORTANT: If the workflow is live, config edits (steps, context, name, etc.) are automatically routed to a draft snapshot instead of modifying the live pipeline. The response will include editingDraft: true. Use get_draft to view the draft, promote_draft to make it live, or discard_draft to throw away the changes. Non-live workflows are updated directly with an automatic pre-edit snapshot for rollback.`, { workflowId: z.string().describe('The workflow ID to update'), updates: z.record(z.string(), z.any()).describe('Partial pipeline updates (name, steps, context, etc.)'), locale: z.string().optional().describe('Locale (default: en)'), }, async ({ workflowId, updates, locale }, extra) => { const client = clientFactory(extra); const result = await client.updateWorkflow(workflowId, updates, locale); return { content: [{ type: 'text' as const, text: JSON.stringify(result, null, 2), }], }; } );