Workflows v2 (Plays) / REST API

List workflow runs

List recent executions of a workflow. Returns up to `limit` runs (default 20, max 100) ordered newest first, each carrying status, trigger_type, started_at, finished_at, and aggregate counts. Pair with get-workflow-run to drill into a specific execution.

GET /api/agent-workflows/{workflowId}/executionsDeterministic 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.
limitOptional · number
Max rows to return (1-100, default 20).
Request example
curl -X GET "https://app.pipeline.help/api/agent-workflows/00000000-0000-4000-8000-000000000000/executions" \
  -H "Authorization: Bearer $PIPELINE_API_KEY"
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."
    },
    "limit": {
      "type": "number",
      "description": "Max rows to return (1-100, default 20)."
    }
  },
  "required": [
    "workflowId"
  ]
}
See this operation inCLI MCP TypeScript SDK
API reference | Pipeline v2 preview