Skip to main content
GET
/
api
/
data-readiness
/
workflows
/
runs
List All Workflow Runs
curl --request GET \
  --url https://api.example.com/api/data-readiness/workflows/runs \
  --header 'Authorization: Bearer <token>'
{
  "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"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.emergence.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

Successful Response

Paginated list of workflow runs across all configurations.

​
pagination
PaginationMeta · object
required

Pagination metadata

​
data
CrossWorkflowRunListItem · object[]

List of workflow run items