Save agent authoring code

Tool: save_workflow. Requires Editor, Admin, or Owner in the applicable workspace and a connected OAuth session. Read get_workflow first and edit its returned code. Submit the complete updated source with the same numeric workflow_id; patches are not accepted. Success has saved: true and version status draft. The agent lifecycle is separate and may stay active while a draft is edited. Inspect structured failure fields including error_code, error, and optional validation details. Parser errors can identify a source location. Preserve fields you did not intend to change. Saving does not publish or execute a call; URL checks can resolve hostnames.

Example: update one prompt

Call get_workflow with { "workflow_id": 42 }, using an agent ID from your workspace.
Read the returned code string. For an agent whose prompt is Be helpful and concise., change only that prompt to Ask one question.. Keep every node, edge, identifier, and other setting.
Call save_workflow with workflow_id: 42 and code set to the entire edited string, not just the new prompt.
Confirm saved: true and version_status: "draft" before continuing. Run Validate an agent to inspect the saved definition.

Arguments

Name	Type	Required	Defaults and limits
`code`	string	Yes	See full schema
`workflow_id`	integer	Yes	See full schema

Result and errors

The schema below describes MCP structuredContent, including the result wrapper where present. Your client may also display a text representation. Read success flags and structured errors before continuing; transport success alone does not prove the operation succeeded. Authentication, missing membership, and insufficient role can fail before a tool result is produced. See troubleshooting. Effect: Changes state. Retry: Do not blindly repeat successful calls. Discovery annotations describe behavior; they do not grant permission or replace confirmation for consequential actions.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "code": {
      "type": "string"
    },
    "workflow_id": {
      "type": "integer"
    }
  },
  "required": [
    "workflow_id",
    "code"
  ],
  "type": "object"
}

Result schema

{
  "properties": {
    "result": {
      "anyOf": [
        {
          "properties": {
            "edge_count": {
              "type": "integer"
            },
            "lifecycle_status": {
              "enum": [
                "draft",
                "active",
                "paused",
                "archived"
              ],
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "node_count": {
              "type": "integer"
            },
            "renamed": {
              "type": "boolean"
            },
            "saved": {
              "const": true,
              "type": "boolean"
            },
            "version_number": {
              "type": "integer"
            },
            "version_status": {
              "enum": [
                "draft",
                "published"
              ],
              "type": "string"
            },
            "workflow_id": {
              "type": "integer"
            }
          },
          "required": [
            "saved",
            "workflow_id",
            "version_status",
            "lifecycle_status",
            "version_number",
            "node_count",
            "edge_count",
            "name",
            "renamed"
          ],
          "type": "object"
        },
        {
          "properties": {
            "error": {
              "type": "string"
            },
            "error_code": {
              "type": "string"
            },
            "errors": {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "type": "array"
            },
            "saved": {
              "const": false,
              "type": "boolean"
            }
          },
          "required": [
            "saved",
            "error_code",
            "error"
          ],
          "type": "object"
        }
      ]
    }
  },
  "required": [
    "result"
  ],
  "type": "object"
}

Get started

Use MCP

Workspaces

Agents

Calls and outcomes

Phone numbers

Resources

Authoring guidance

Documentation

Example: update one prompt

Arguments

Result and errors

​Example: update one prompt

​Arguments

​Result and errors

Example: update one prompt

Arguments

Result and errors