Workflows
Workflows

update_workflow

Partial update of a workflow template. Only keys present in the input mutate — unspecified keys are preserved. Call get_workflow first to see the current state.

Input Schema

{
  "type": "object",
  "required": [
    "workflow_id"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
    },
    "tags": {
      "type": "array"
    },
    "steps": {
      "type": "array"
    },
    "inputs": {
      "type": "object"
    },
    "status": {
      "enum": [
        "draft",
        "active",
        "archived"
      ],
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "workflow_id": {
      "type": "string",
      "format": "uuid",
      "description": "UUID of the workflow to update."
    },
    "allowed_tools": {
      "type": "array"
    }
  },
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "required": [
    "id",
    "name",
    "status",
    "link_url"
  ],
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid"
    },
    "name": {
      "type": "string"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "steps": {
      "type": "array"
    },
    "inputs": {
      "type": "object"
    },
    "status": {
      "enum": [
        "draft",
        "active",
        "archived"
      ],
      "type": "string"
    },
    "link_url": {
      "type": "string",
      "format": "uri"
    },
    "updated_at": {
      "type": "string"
    },
    "allowed_tools": {
      "type": "array"
    }
  }
}

Instructions

Partial update of a workflow template — only the keys you send mutate; unspecified keys are preserved. Call get_workflow first to read the current values, then send the minimal diff.

Activate with { workflow_id, status: "active" }; soft-delete with { workflow_id, status: "archived" }.
Do NOT send schedule_config — it is rejected with an InputError on update. Schedule edits happen in the Marcora UI.

Parameters:

  • workflow_id (string uuid, required): UUID of the workflow to update
  • name (string, optional): New name
  • description (string, optional): New description
  • status (string, optional): draft, active, or archived. Use archived as soft-delete
  • steps (array, optional): Replacement step definitions
  • inputs (object, optional): Replacement input schema
  • allowed_tools (array, optional): Replacement tool allowlist
  • tags (string[], optional): Replacement tags

Output: The updated workflow object — id, name, status, steps, inputs, allowed_tools, tags, updated_at, link_url.

Scroll to Top