Skip to main content
GET
https://api.usedari.com
/
public
/
workflows
/
{workflow_id}
from dari import Dari

client = Dari(api_key="YOUR_API_KEY")

executions = client.list_workflow_executions("wf_123456789")
print(f"Found {len(executions['executions'])} executions")
for execution in executions['executions']:
    print(f"- {execution['status']}: {execution['id']}")

{
  "executions": [
    {
      "id": "exec_abc123def456",
      "name": "My First Workflow",
      "workflow_id": "wf_123456789",
      "status": "completed",
      "created_at": "2025-01-15T14:30:00.123456+00:00",
      "completed_at": "2025-01-15T14:32:15.789012+00:00"
    },
    {
      "id": "exec_xyz789ghi012",
      "name": "My First Workflow",
      "workflow_id": "wf_123456789",
      "status": "running",
      "created_at": "2025-01-15T15:45:30.567890+00:00",
      "completed_at": null
    }
  ]
}
This endpoint allows you to retrieve a list of all executions for a specific workflow that your workspace has access to. When a workflow is executed, each run creates a new execution record with a unique execution ID.

​
Path Parameters

​
workflow_id
string
required
The unique identifier of the workflow

​
Headers

​
X-API-Key
string
required
Your API key for authentication

​
Response Fields

​
executions
array
Array of workflow execution objects
​
id
string
The unique identifier of the execution
​
name
string
The name of the workflow
​
workflow_id
string
The ID of the parent workflow
​
status
string
The current status of the execution. One of: "completed", "failed", or "running"
​
created_at
string
ISO 8601 timestamp when the execution was created
​
completed_at
string
ISO 8601 timestamp when the execution completed (null if still running or if failed)
from dari import Dari

client = Dari(api_key="YOUR_API_KEY")

executions = client.list_workflow_executions("wf_123456789")
print(f"Found {len(executions['executions'])} executions")
for execution in executions['executions']:
    print(f"- {execution['status']}: {execution['id']}")

{
  "executions": [
    {
      "id": "exec_abc123def456",
      "name": "My First Workflow",
      "workflow_id": "wf_123456789",
      "status": "completed",
      "created_at": "2025-01-15T14:30:00.123456+00:00",
      "completed_at": "2025-01-15T14:32:15.789012+00:00"
    },
    {
      "id": "exec_xyz789ghi012",
      "name": "My First Workflow",
      "workflow_id": "wf_123456789",
      "status": "running",
      "created_at": "2025-01-15T15:45:30.567890+00:00",
      "completed_at": null
    }
  ]
}

​
Usage Notes

  • API Key: Get your API key from the Dari dashboard
  • Workflow ID: Found in your workflow URL or dashboard
  • Workspace Access: Returns all executions in the workflow’s workspace, including executions created by other workspace members
  • Ordering: Executions are returned in reverse chronological order (most recent first)
  • Status Values:
    • "completed": Execution finished successfully
    • "failed": Execution encountered an error
    • "running": Execution is currently in progress

​
Error Responses

{
  "detail": "Invalid API key"
}

{
  "detail": "User {user_id} is not a member of the workflow's workspace"
}

{
  "detail": "Error getting workflow executions: {error_message}"
}