Workflows v2 (Plays) / MCP

Get workflow

Fetch one workflow by id. Returns the full record including workflow_definition (the compiled DAG of plays + edges), status, schedule, and audit metadata. Use after list-workflows to inspect or before run-workflow to verify the version you are about to execute.

tools/callDeterministic operation

Parameters

workspaceIdOptional · string
Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client.
workflowIdRequired · string
Workflow UUID.
Request example
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get-workflow",
    "arguments": {
      "workflowId": "00000000-0000-4000-8000-000000000000"
    }
  }
}
Full input schema
Input schema
{
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string",
      "minLength": 1,
      "description": "Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client."
    },
    "workflowId": {
      "type": "string",
      "description": "Workflow UUID."
    }
  },
  "required": [
    "workflowId"
  ]
}
See this operation inCLI REST API TypeScript SDK
MCP reference | Pipeline v2 preview