Skip to main content
Glama

Edit a saved workflow

writ_update_workflow
Destructive

Inspects or edits a saved workflow: an outline, one function's source, targeted function or step edits, a settings patch. copy_to keeps a linked copy on Writ Cloud or the user's desktop. Every option: writ_help('writ_update_workflow').

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "writ_update_workflow"
  }
}

Input Schema

NameRequiredDescriptionDefault
pathNo
limitNo
patchNoSettings and metadata to change; {"name": "New name"} renames it.
deviceNo
offsetNo
copy_toNo
sectionNo
step_idNo
verboseNo
operatorNo
workflowNoName or id; local:<n> for a desktop workflow.
max_charsNo
workflow_idNo
step_updatesNo[{index, patch}] merged into those recorded steps.
function_nameNo
input_updatesNo
replace_stepsNo
validate_onlyNotrue previews and validates; nothing is saved.
function_updatesNo[{function_name, patch|json_edits|script_edits}] (add /config/flow/steps/- appends a step); add:{step} adds a function.
regenerate_skillNo
expected_updated_atNo
confirm_listing_changeNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / confirm_listing_change
      Added value: +{
      +  "type": "boolean"
      +}
    • addedInput schema / properties / input_updates
      Added value: +{
      +  "items": {
      +    "type": "object"
      +  },
      +  "maxItems": 50,
      +  "minItems": 1,
      +  "type": "array"
      +}
  2. Changed19 schema fields changed
    • addedInput schema / properties / copy_to
      Added value: +{
      +  "enum": [
      +    "cloud",
      +    "desktop"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / device
      Added value: +{
      +  "type": "string"
      +}
    • addedInput schema / properties / expected_updated_at
      Added value: +{
      +  "type": "string"
      +}
    • addedInput schema / properties / function_name
      Added value: +{
      +  "type": "string"
      +}
    • addedInput schema / properties / function_updates
      Added value: +{
      +  "description": "[{function_name, patch|json_edits|script_edits}] (add /config/flow/steps/- appends a step); add:{step} adds a function.",
      +  "items": {
      +    "type": "object"
      +  },
      +  "maxItems": 50,
      +  "minItems": 1,
      +  "type": "array"
      +}
    • addedInput schema / properties / limit
      Added value: +{
      +  "maximum": 100,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / max_chars
      Added value: +{
      +  "maximum": 20000,
      +  "minimum": 1000,
      +  "type": "integer"
      +}
    • addedInput schema / properties / offset
      Added value: +{
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • addedInput schema / properties / operator
      Added value: +{
      +  "type": "string"
      +}
    • addedInput schema / properties / patch
      Added value: +{
      +  "description": "Settings and metadata to change; {\"name\": \"New name\"} renames it.",
      +  "type": "object"
      +}
    • addedInput schema / properties / path
      Added value: +{
      +  "type": "string"
      +}
    • addedInput schema / properties / regenerate_skill
      Added value: +{
      +  "type": "boolean"
      +}
    • addedInput schema / properties / replace_steps
      Added value: +{
      +  "items": {
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / section
      Added value: +{
      +  "enum": [
      +    "source",
      +    "flow",
      +    "contract"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / step_id
      Added value: +{
      +  "type": "string"
      +}
    • addedInput schema / properties / step_updates
      Added value: +{
      +  "description": "[{index, patch}] merged into those recorded steps.",
      +  "items": {
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / validate_only
      Added value: +{
      +  "description": "true previews and validates; nothing is saved.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / verbose
      Added value: +{
      +  "type": "boolean"
      +}
    • addedInput schema / properties / workflow
      Added value: +{
      +  "description": "Name or id; local:<n> for a desktop workflow.",
      +  "type": "string"
      +}
  3. Changed17 schema fields changed
    • removedInput schema / properties / expected_updated_at
      Removed value: -{
      -  "description": "Workflow timestamp returned by inspection; checked under the row lock.",
      -  "type": "string"
      -}
    • removedInput schema / properties / function_name
      Removed value: -{
      -  "description": "Source of this function only.",
      -  "type": "string"
      -}
    • removedInput schema / properties / function_updates
      Removed value: -{
      -  "items": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "expected_hash": {
      -        "description": "Expected whole-step hash from inspection.",
      -        "type": "string"
      -      },
      -      "function_name": {
      -        "type": "string"
      -      },
      -      "json_edits": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "op": {
      -              "enum": [
      -                "test",
      -                "add",
      -                "replace",
      -                "remove"
      -              ],
      -              "type": "string"
      -            },
      -            "path": {
      -              "type": "string"
      -            },
      -            "value": {}
      -          },
      -          "required": [
      -            "op",
      -            "path"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "patch": {
      -        "description": "Sparse type/config/enabled patch; object keys merge, arrays replace.",
      -        "type": "object"
      -      },
      -      "script_edits": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "expected_hash": {
      -              "type": "string"
      -            },
      -            "new": {
      -              "type": "string"
      -            },
      -            "old": {
      -              "type": "string"
      -            },
      -            "path": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "path",
      -            "old",
      -            "new"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "step_id": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "function_name"
      -    ],
      -    "type": "object"
      -  },
      -  "maxItems": 50,
      -  "minItems": 1,
      -  "type": "array"
      -}
    • removedInput schema / properties / limit
      Removed value: -{
      -  "maximum": 100,
      -  "minimum": 1,
      -  "type": "integer"
      -}
    • removedInput schema / properties / max_chars
      Removed value: -{
      -  "maximum": 20000,
      -  "minimum": 1000,
      -  "type": "integer"
      -}
    • removedInput schema / properties / offset
      Removed value: -{
      -  "minimum": 0,
      -  "type": "integer"
      -}
    • removedInput schema / properties / operator
      Removed value: -{
      -  "description": "section=contract: one operator, with its operands, semantics and example.",
      -  "type": "string"
      -}
    • removedInput schema / properties / patch
      Removed value: -{
      -  "description": "Sparse settings patch. Supports every WorkflowUpdate field except credentials and captured recorded_session material, which vault/persona/session management own. human_behavior: 'on' types text using keyboard events every browser run; 'auto' does so on a bot-block retry; 'off' disables the default.",
      -  "type": "object"
      -}
    • removedInput schema / properties / path
      Removed value: -{
      -  "description": "JSON Pointer into the selected step, e.g. /config/flow/steps/2 or /config/script.",
      -  "type": "string"
      -}
    • removedInput schema / properties / regenerate_skill
      Removed value: -{
      -  "description": "Rebuild the workflow's agent skill (SKILL.md) from its current functions, inputs and sign-in, replacing any edited version; the answer carries the new skill_md. Runs after any patch in the same call.",
      -  "type": "boolean"
      -}
    • removedInput schema / properties / replace_steps
      Removed value: -{
      -  "description": "Complete recorded-step replacement; step_updates is the targeted edit.",
      -  "items": {
      -    "type": "object"
      -  },
      -  "type": "array"
      -}
    • removedInput schema / properties / section
      Removed value: -{
      -  "description": "source reads a source window; flow lists nested node paths; contract lists operators and their semantics without requiring a workflow.",
      -  "enum": [
      -    "source",
      -    "flow",
      -    "contract"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / step_id
      Removed value: -{
      -  "description": "Stable step id that picks one step of a multi-step function.",
      -  "type": "string"
      -}
    • removedInput schema / properties / step_updates
      Removed value: -{
      -  "items": {
      -    "properties": {
      -      "index": {
      -        "description": "Zero-based step index.",
      -        "type": "integer"
      -      },
      -      "patch": {
      -        "description": "Sparse step patch: id, type, enabled, and/or nested config. Config is merged recursively.",
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "index",
      -      "patch"
      -    ],
      -    "type": "object"
      -  },
      -  "type": "array"
      -}
    • removedInput schema / properties / validate_only
      Removed value: -{
      -  "description": "Preview/validate without saving or executing.",
      -  "type": "boolean"
      -}
    • removedInput schema / properties / verbose
      Removed value: -{
      -  "description": "Edits answer with the full workflow definition instead of the compact step outline (default false).",
      -  "type": "boolean"
      -}
    • removedInput schema / properties / workflow
      Removed value: -{
      -  "description": "Workflow name (or workflow_id).",
      -  "type": "string"
      -}
  4. First observed

TDQS

C2.9/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructiveHint=true, readOnlyHint=false and idempotentHint=false, so the safety profile is largely carried by structured data. The description adds useful context: an inspect mode exists and copy_to creates a linked copy on cloud/desktop. It does not warn that replace_steps/step_updates can destroy recorded steps, nor mention expected_updated_at concurrency behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three tight sentences that front-load the core capability, then side effects, then a pointer to full docs. No filler, though the blanket "Every option: writ_help(...)" is an offloading move rather than information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a destructive, 22-parameter, nested-object mutation tool with no required params and no output schema, this is thin: no return-shape guidance for inspect mode, no pagination context, no caution around the destructive edit paths, and most parameters are covered only via the help tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 23% across 22 parameters, so the description must compensate, and it only glosses a handful (copy_to, a settings patch, function/step edits, source/outline sections). Many high-impact parameters — replace_steps, validate_only, confirm_listing_change, regenerate_skill, expected_updated_at, limit/offset/max_chars — get no mention in the description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States specific verbs and resource ("Inspects or edits a saved workflow") and enumerates the distinct modes: outline, function source, function/step edits, settings patch, copy_to. An agent can tell what the tool does, but nothing distinguishes it from siblings like writ_run_workflow or writ_list_workflows.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit guidance on when to choose this tool over alternatives, no prerequisites, no when-not conditions. The mode list hints at use cases but leaves selection entirely to inference, and final routing is deferred to writ_help('writ_update_workflow').

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.