workflow_update
ManagementcatalogUpdate Workflow
Not in the default tool list
This tool lives in the tool catalog. Discover it with scenario_tools_search (or enumerate everything with scenario_tools_list) and run it via scenario_tool_execute_write. To list every tool directly, connect with ?toolsets=full.
Update an existing workflow's metadata or definition. Supplied fields replace existing values and draft status unpublishes the workflow; confirm overwrites or unpublishing first.
Args:
- workflow_id: required
- name, description: optional metadata
- status: "draft" unpublishes the app while preserving its graph and compiled flow; "ready" restores an existing compiled flow without recompiling. Use workflow_publish to compile editor changes.
- flow, inputs_definition, editor_info: optional definition fields. Editing editor_info without also supplying flow leaves the compiled flow stale until re-published. The response carries _publishHint in that case unless status="draft" was explicitly requested.
- team_id, project_id: required for OAuth callers
Returns: the updated workflow record (plus _publishHint when editor_info changed without a fresh flow).
Examples:
- "Rename this workflow" -> workflow_id="workflow_xxx", name="new-name"
- "Unpublish this app" -> workflow_id="workflow_xxx", status="draft"
destructiveopen-world
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| workflow_id | string | ✓ | Workflow ID. |
| name | string | — | Workflow name (for create/update). |
| description | string | — | Workflow description (for create/update). |
| status | enum(draft | ready) | — | Set draft to unpublish without deleting the graph or compiled flow. ready reuses an existing compiled flow; use workflow_publish to compile editor changes. |
| flow | array | — | Workflow flow definition (array of node objects). |
| inputs_definition | array | — | Workflow input definitions. |
| editor_info | record | — | UI editor metadata (managed by the Scenario webapp). Validated against the webapp's import schema before persisting. |
| team_id | string | — | Team ID. Required with project_id for OAuth callers; an API key is scoped by the key. |
| project_id | string | — | Project ID. Required with team_id for OAuth callers; an API key is scoped by the key. |
| response_format | enum(json | markdown) | json | Output format: 'json' for structured data, 'markdown' for human-readable text. |