Use this tool to update an existing workflow draft. An AI agent interprets your natural-language prompt and applies the structural changes — creating, updating, or deleting steps — then returns a summary of what it did. Call it after create_workflow, and call it repeatedly on the same draft to refine the workflow step by step.

🚧
This tool runs against the monday.com dev (preview) API schema. Changes apply to the draft — the workflow runs only after it is published with publish_workflow.

Parameters

Parameter	Type	Required	Description
workflowObjectId	`number`	Yes	The workflow object ID returned by create_workflow. Identifies the workflow across all drafts and published versions; does not change across publishes.
workflowDraftId	`number`	Yes	The draft version ID to update. Always read it from the latest `create_workflow`/`update_workflow` response — the agent may return a new draft ID.
prompt	`string`	Yes	Natural-language description of the changes to make (e.g. "Add a trigger that fires when an item is created on the Marketing board"). Maximum 2000 characters.

Example

Add a trigger step to an existing workflow draft:

{
  "workflowObjectId": 12345,
  "workflowDraftId": 67890,
  "prompt": "Add a trigger that fires when an item is created on the Marketing board, then notify the item's owner."
}

The tool returns workflowObjectId, workflowDraftId, and a result describing the changes the agent made.

Programmatic equivalent

This tool calls the monday.com workflow-builder agent service on the dev (preview) API. There is no stable public GraphQL equivalent yet.