Update Workflow
update_workflowUpdate a workflow draft by describing changes in plain English; the AI agent applies structural modifications and returns a summary.
Instructions
Updates an existing workflow draft using an AI agent.
The agent interprets the prompt and applies structural changes to the workflow — creating, updating, or deleting steps. Pass clear, descriptive instructions and the agent will decide which operations to perform, then return a summary of what it did.
Use this after create_workflow to build out the workflow step by step. You can call it multiple times on the same draft to iteratively refine the workflow.
Parameters:
workflowObjectId and workflowDraftId: both returned by create_workflow — they identify which draft to update.
prompt: describe what you want to change in plain English (e.g. "Add a trigger that fires when an item is created on the Marketing board"). Maximum 2000 characters.
Returns:
workflowObjectId: the workflow object ID (unchanged)
workflowDraftId: the draft version ID (unchanged)
result: agent response describing the changes made
Note: if directing the user to the workflow in the UI, the correct URL path is custom_objects/, not workflows/ — e.g. {account}.monday.com/custom_objects/{workflowObjectId}.
Note: the workflow runs only after it is published to live version.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| workflowObjectId | Yes | The workflow object ID returned by create_workflow. Identifies the workflow across all its drafts and published versions. Does not change across publishes. | |
| workflowDraftId | Yes | The draft version ID to update. Use the workflowDraftId from the previous create_workflow or update_workflow response — the agent may return a new draft ID, so always read it from the latest response rather than reusing an earlier value. | |
| prompt | Yes | Natural-language description of the changes to make. Describe what steps to add, remove, or modify in plain English (e.g. "Add a trigger that fires when an item is created on the Marketing board"). The agent interprets this and applies the right structural changes. Maximum 2000 characters. |