Get Workflow Execution

curl -X GET "https://api.danubeai.com/v1/workflows/executions/exec_xyz789" \
  -H "danube-api-key: YOUR_API_KEY"

from danube import DanubeClient

with DanubeClient(api_key="dk_...") as client:
    execution = client.workflows.get_execution("exec_xyz789")
    print(f"Status: {execution.status}")
    if execution.error:
        print(f"Error: {execution.error}")

{
  "id": "exec_xyz789",
  "workflow_id": "wf_abc123",
  "user_id": "user_456",
  "status": "success",
  "inputs": {
    "city": "San Francisco"
  },
  "step_results": [
    {
      "step_number": 1,
      "tool_id": "tool_001",
      "tool_name": "Weather - Get Forecast",
      "status": "success",
      "result": {"forecast": "Sunny, 22C"},
      "error": null,
      "execution_time_ms": 280
    }
  ],
  "error": null,
  "execution_time_ms": 280,
  "started_at": "2026-02-16T12:00:00Z",
  "completed_at": "2026-02-16T12:00:01Z",
  "created_at": "2026-02-16T12:00:00Z"
}

GET

workflows

executions

{execution_id}

curl -X GET "https://api.danubeai.com/v1/workflows/executions/exec_xyz789" \
  -H "danube-api-key: YOUR_API_KEY"

from danube import DanubeClient

with DanubeClient(api_key="dk_...") as client:
    execution = client.workflows.get_execution("exec_xyz789")
    print(f"Status: {execution.status}")
    if execution.error:
        print(f"Error: {execution.error}")

{
  "id": "exec_xyz789",
  "workflow_id": "wf_abc123",
  "user_id": "user_456",
  "status": "success",
  "inputs": {
    "city": "San Francisco"
  },
  "step_results": [
    {
      "step_number": 1,
      "tool_id": "tool_001",
      "tool_name": "Weather - Get Forecast",
      "status": "success",
      "result": {"forecast": "Sunny, 22C"},
      "error": null,
      "execution_time_ms": 280
    }
  ],
  "error": null,
  "execution_time_ms": 280,
  "started_at": "2026-02-16T12:00:00Z",
  "completed_at": "2026-02-16T12:00:01Z",
  "created_at": "2026-02-16T12:00:00Z"
}

Overview

Retrieves the full result of a workflow execution including the status and output of each step. Use this to check on a previously triggered execution. Auth: Accepts either JWT or API key (danube-api-key header). Only the user who triggered the execution can retrieve it.

Path Parameters

execution_id

string

required

The execution UUID returned when the workflow was executed

Response

Returns a WorkflowExecutionResponse object. See Execute Workflow for the full response shape.

Example

curl -X GET "https://api.danubeai.com/v1/workflows/executions/exec_xyz789" \
  -H "danube-api-key: YOUR_API_KEY"

from danube import DanubeClient

with DanubeClient(api_key="dk_...") as client:
    execution = client.workflows.get_execution("exec_xyz789")
    print(f"Status: {execution.status}")
    if execution.error:
        print(f"Error: {execution.error}")

{
  "id": "exec_xyz789",
  "workflow_id": "wf_abc123",
  "user_id": "user_456",
  "status": "success",
  "inputs": {
    "city": "San Francisco"
  },
  "step_results": [
    {
      "step_number": 1,
      "tool_id": "tool_001",
      "tool_name": "Weather - Get Forecast",
      "status": "success",
      "result": {"forecast": "Sunny, 22C"},
      "error": null,
      "execution_time_ms": 280
    }
  ],
  "error": null,
  "execution_time_ms": 280,
  "started_at": "2026-02-16T12:00:00Z",
  "completed_at": "2026-02-16T12:00:01Z",
  "created_at": "2026-02-16T12:00:00Z"
}

MCP Tool

This endpoint is also available as the get_workflow_execution MCP tool:

result = await mcp.call_tool("get_workflow_execution", {
    "execution_id": "exec_xyz789"
})

Execute Workflow List Sites

​Overview

​Path Parameters

​Response

​Example

​MCP Tool

Overview

Path Parameters

Response

Example

MCP Tool