get_workflow

Fetch a single workflow's full definition plus its triggers and latest run. Use before updating a workflow to avoid clobbering unknown fields.

Input Schema

{
  "type": "object",
  "required": [
    "workflow_id"
  ],
  "properties": {
    "workflow_id": {
      "type": "string",
      "format": "uuid",
      "description": "UUID of the workflow template."
    }
  },
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "required": [
    "workflow"
  ],
  "properties": {
    "workflow": {
      "type": "object",
      "required": [
        "id",
        "name",
        "status",
        "link_url"
      ],
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "name": {
          "type": "string"
        },
        "steps": {
          "type": "array"
        },
        "inputs": {
          "type": "object"
        },
        "status": {
          "enum": [
            "draft",
            "active",
            "archived"
          ],
          "type": "string"
        },
        "link_url": {
          "type": "string",
          "format": "uri"
        },
        "_triggers": {
          "type": "array",
          "description": "Schedule/trigger configs. Inspect _triggers[0].schedule_config and .is_enabled."
        },
        "_latest_run": {
          "type": [
            "object",
            "null"
          ],
          "description": "Most recent run (carries its own link_url), or null if never run."
        },
        "allowed_tools": {
          "type": "array"
        }
      }
    }
  }
}

Instructions

Fetch one workflow's full definition plus its triggers and latest run. Always call this before update_workflow — partial updates clobber unspecified keys, so you need the current values first.

Parameters:

workflow_id (string uuid, required): UUID of the workflow to fetch

Output: An object with a single workflow key.

workflow.id (string uuid): Workflow ID
workflow.name (string): Workflow name
workflow.status (string): draft, active, or archived
workflow.steps (array): Ordered step definitions
workflow.inputs (object): Declared input schema
workflow.allowed_tools (array): Tool allowlist for the runner
workflow._triggers (array): Schedule/trigger configs. Inspect _triggers[0].schedule_config and .is_enabled
workflow._latest_run (object or null): Most recent run (carries its own link_url), or null if never run
workflow.link_url (string uri): Direct URL to view the workflow in Marcora