Workflows
Workflows

get_workflow_runs

Inspect workflow run history. Two modes: list mode (paginated runs for a workflow) or single mode (one run with step logs and tool call logs) controlled by run_id presence.

Input Schema

{
  "type": "object",
  "required": [
    "workflow_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "run_id": {
      "type": "string",
      "format": "uuid",
      "description": "UUID of a specific run. Omit to list all runs for the workflow."
    },
    "status": {
      "enum": [
        "pending",
        "running",
        "succeeded",
        "failed",
        "skipped"
      ],
      "type": "string",
      "description": "Filter by run status (list mode only)."
    },
    "per_page": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "workflow_id": {
      "type": "string",
      "format": "uuid",
      "description": "UUID of the workflow template."
    }
  },
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "description": "Single-run mode only. Run UUID."
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string"
          },
          "link_url": {
            "type": "string",
            "format": "uri"
          },
          "workflow_template_id": {
            "type": "string",
            "format": "uuid"
          }
        }
      },
      "description": "List mode only. Array of run summaries."
    },
    "status": {
      "type": "string",
      "description": "Single-run mode only. Run status."
    },
    "link_url": {
      "type": "string",
      "format": "uri",
      "description": "Single-run mode only. Direct URL to view this run."
    },
    "_step_logs": {
      "type": "array",
      "description": "Single-run mode only. Step execution logs."
    },
    "itemsTotal": {
      "type": "integer",
      "description": "List mode only. Total number of matching runs."
    },
    "_tool_call_logs": {
      "type": "array",
      "description": "Single-run mode only. Tool call logs."
    },
    "workflow_template_id": {
      "type": "string",
      "format": "uuid",
      "description": "Single-run mode only."
    }
  },
  "description": "Shape depends on mode. List mode (run_id omitted): items + itemsTotal. Single-run mode (run_id supplied): id, workflow_template_id, status, _step_logs, _tool_call_logs, link_url."
}

Instructions

Inspect workflow run history. Two modes, controlled by whether run_id is supplied: omit it for a paginated list of runs; supply it for a single run's detail including step logs and tool-call logs.

Parameters:

  • workflow_id (string uuid, required): UUID of the workflow
  • run_id (string uuid, optional): If supplied → single-run detail; if omitted → paginated list of runs
  • status (string, optional): List-mode filter (e.g. "failed"). Ignored in single mode
  • page (integer, optional): List-mode page number (default 1)
  • per_page (integer, optional): List-mode page size (default 20)

Output: An object whose shape depends on the mode:

  • List mode (run_id omitted): items — an array of runs, each { id, workflow_template_id, status, link_url } — plus itemsTotal (integer).
  • Single-run mode (run_id supplied): id, workflow_template_id, status, _step_logs (array), _tool_call_logs (array), and link_url.
Scroll to Top