List All Workflow Runs

Retrieve a paginated list of workflow runs across all workflows for the current tenant.

Supports filtering by:

• asset_fqn: Filter runs by asset FQN (prefix match)
• workflow_type: Filter by workflow type
• status: Comma-separated status list (e.g., ‘running,failed,completed’). Valid statuses: pending, scheduled, running, completed, failed, cancelled, retrying, cached, crashed
• start_date: Filter runs started after this date (ISO 8601)
• end_date: Filter runs started before this date (ISO 8601)

Supports sorting by:

• sort: Multi-sort format: field:order,field:order (e.g., ‘status:desc,started_at:asc’). Valid fields: workflow_name, started_at, status. Valid orders: asc, desc

GET /api/data-readiness/workflows/runs

List All Workflow Runs

cURL

curl --request GET \
  --url https://api.example.com/api/data-readiness/workflows/runs \
  --header 'Authorization: Bearer <token>'

200

{
  "pagination": {
    "page": 123,
    "per_page": 123,
    "total": 123,
    "total_pages": 123,
    "has_next": true,
    "has_prev": true
  },
  "data": [
    {
      "asset_fqn": "PostgreSQL.dvdrental.public.customer",
      "completed_at": "2024-01-15T10:35:00Z",
      "configuration_id": "123e4567-e89b-12d3-a456-426614174000",
      "database_name": "dvdrental",
      "duration_seconds": 300.5,
      "id": "123e4567-e89b-12d3-a456-426614174002",
      "input": {
        "asset_fqn": "PostgreSQL.dvdrental.public.customer"
      },
      "schema_name": "public",
      "service_name": "PostgreSQL",
      "started_at": "2024-01-15T10:30:00Z",
      "status": "completed",
      "table_name": "customer",
      "workflow_name": "PII Detection - Production",
      "workflow_type": "generate-pii-tags"
    }
  ]
}

Authorizations

Authorization · string · header · required

JWT Bearer token authentication. Include the token in the Authorization header as: Authorization: Bearer <token>. The JWT must contain valid client_id, and project_id claims for tenant isolation and SDK routing.

Query Parameters

page · integer · default: 1

Page number

Required range: x >= 1

per_page · integer · default: 20

Items per page

Required range: 1 <= x <= 100

asset_fqn · string | null

Filter by asset FQN (prefix match)

workflow_type · enum<string> | null

Filter by workflow type Workflow types available in the system.

These values match the Prefect deployment names defined in scripts/prefect/deploy.py to enable direct mapping when triggering workflows.

Available options: generate-table-description, generate-pii-tags, generate-dq-tags, generate-sensitivity-tags, enrich-table-columns, service-ingestion, profiling, dq-rule-generation, dq-execution, metadata-assessment, dq-assessment, dq-tag-generation, intelligence, metadata-enrichment, run-all-enrichment

status · string | null

Comma-separated status list (e.g., 'running,failed,completed'). Case-insensitive.

start_date · string | null

Start date (ISO 8601)

end_date · string | null

End date (ISO 8601)

sort · string | null

Multi-sort format: field:order,field:order (e.g., 'status:desc,started_at:asc'). Valid fields: workflow_name, started_at, status. Valid orders: asc, desc

Response

200

application/json

Successful Response

Paginated list of workflow runs across all configurations.

pagination · PaginationMeta · object · required

Pagination metadata

Show child attributes

data · CrossWorkflowRunListItem · object[]

List of workflow run items

Show child attributes