> ## 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. # 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 ## OpenAPI ````yaml /openapi/em-data-readiness-v2.yaml get /api/data-readiness/workflows/runs openapi: 3.1.0 info: title: EM Data Readiness Service description: Data Readiness Service API for managing workflows, metrics, and data quality version: 4.3.0-dev1 servers: [] security: - BearerAuth: [] tags: - name: Health description: Service health monitoring. Check service status and version information. - name: Root description: Root endpoint providing service information and navigation links. - name: Configuration description: Service configuration endpoints. View current configuration values. - name: Workflows description: >- Workflow configuration and execution management. Create, configure, and run data quality workflows including definitions, configurations, runs, and tasks. - name: Data Assets description: >- Data catalog entity management. Manage databases, schemas, and tables metadata. - name: Metrics description: >- Data quality metrics and scorecards. Calculate scores, view trends, and analyze dimensions. - name: Violations description: >- Data quality violation management. View, acknowledge, and remediate detected violations. - name: Glossary description: >- Business glossary management. Create, verify, and organize business terms and definitions. paths: /api/data-readiness/workflows/runs: get: tags: - Workflows summary: List All Workflow Runs description: >- 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 operationId: list_all_workflow_runs parameters: - name: page in: query required: false schema: type: integer minimum: 1 description: Page number default: 1 title: Page description: Page number - name: per_page in: query required: false schema: type: integer maximum: 100 minimum: 1 description: Items per page default: 20 title: Per Page description: Items per page - name: asset_fqn in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by asset FQN (prefix match) title: Asset Fqn description: Filter by asset FQN (prefix match) - name: workflow_type in: query required: false schema: anyOf: - $ref: '#/components/schemas/WorkflowType' - type: 'null' description: Filter by workflow type title: Workflow Type description: Filter by workflow type - name: status in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Comma-separated status list (e.g., 'running,failed,completed'). Case-insensitive. title: Status description: >- Comma-separated status list (e.g., 'running,failed,completed'). Case-insensitive. - name: start_date in: query required: false schema: anyOf: - type: string - type: 'null' description: Start date (ISO 8601) title: Start Date description: Start date (ISO 8601) - name: end_date in: query required: false schema: anyOf: - type: string - type: 'null' description: End date (ISO 8601) title: End Date description: End date (ISO 8601) - name: sort in: query required: false schema: anyOf: - type: string - type: 'null' description: >- 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 title: Sort description: >- 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 responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PaginatedCrossWorkflowRunResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - BearerAuth: [] components: schemas: WorkflowType: type: string enum: - 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 title: WorkflowType description: >- 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. PaginatedCrossWorkflowRunResponse: properties: data: items: $ref: '#/components/schemas/CrossWorkflowRunListItem' type: array title: Data description: List of workflow run items pagination: $ref: '#/components/schemas/PaginationMeta' description: Pagination metadata type: object required: - pagination title: PaginatedCrossWorkflowRunResponse description: Paginated list of workflow runs across all configurations. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ErrorResponse: properties: error: $ref: '#/components/schemas/ErrorInfo' description: >- Error information object containing code, message, and optional details request_id: anyOf: - type: string - type: 'null' title: Request Id description: Request ID for debugging and support examples: - req_abc123xyz type: object required: - error title: ErrorResponse description: >- Standard error response model for API errors. Matches the structure returned by _handle_service_error in workflows/routes.py. The actual API response format is: { "error": { "code": "ERROR_CODE", "message": "Error message", "details": {...} }, "request_id": "optional-request-id" } CrossWorkflowRunListItem: properties: id: type: string format: uuid title: Id description: Unique run identifier examples: - 123e4567-e89b-12d3-a456-426614174002 configuration_id: type: string format: uuid title: Configuration Id description: Workflow configuration ID examples: - 123e4567-e89b-12d3-a456-426614174000 workflow_name: type: string title: Workflow Name description: Workflow name examples: - PII Detection - Production workflow_type: $ref: '#/components/schemas/WorkflowType' description: Type of workflow examples: - generate-pii-tags asset_fqn: anyOf: - type: string - type: 'null' title: Asset Fqn description: Fully qualified name of the data asset examples: - PostgreSQL.dvdrental.public.customer service_name: anyOf: - type: string - type: 'null' title: Service Name description: Service/connection name (derived from asset_fqn) examples: - PostgreSQL database_name: anyOf: - type: string - type: 'null' title: Database Name description: Database name (derived from asset_fqn) examples: - dvdrental schema_name: anyOf: - type: string - type: 'null' title: Schema Name description: Schema name (derived from asset_fqn) examples: - public table_name: anyOf: - type: string - type: 'null' title: Table Name description: Table name (derived from asset_fqn, null for schema-level workflows) examples: - customer status: type: string title: Status description: Run status examples: - completed started_at: anyOf: - type: string - type: 'null' title: Started At description: Run start timestamp (ISO 8601) examples: - '2024-01-15T10:30:00Z' completed_at: anyOf: - type: string - type: 'null' title: Completed At description: Run completion timestamp (ISO 8601) examples: - '2024-01-15T10:35:00Z' duration_seconds: anyOf: - type: number - type: 'null' title: Duration Seconds description: Total run duration in seconds examples: - 300.5 error_message: anyOf: - type: string - type: 'null' title: Error Message description: Error message if run failed examples: - null input: anyOf: - additionalProperties: true type: object - type: 'null' title: Input description: Input parameters for the run examples: - asset_fqn: PostgreSQL.dvdrental.public.customer type: object required: - id - configuration_id - workflow_name - workflow_type - status title: CrossWorkflowRunListItem description: Workflow run item for cross-workflow list responses. example: 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 PaginationMeta: properties: page: type: integer title: Page description: Current page number (1-indexed) per_page: type: integer title: Per Page description: Items per page total: type: integer title: Total description: Total number of items total_pages: type: integer title: Total Pages description: Total number of pages has_next: type: boolean title: Has Next description: Whether there is a next page has_prev: type: boolean title: Has Prev description: Whether there is a previous page type: object required: - page - per_page - total - total_pages - has_next - has_prev title: PaginationMeta description: >- Standard pagination metadata for list responses. This model provides consistent pagination information across all paginated API responses in the service. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError ErrorInfo: properties: code: type: string title: Code description: >- Error code identifier (e.g., 'WORKFLOW_NOT_FOUND', 'VALIDATION_ERROR') examples: - WORKFLOW_NOT_FOUND message: type: string title: Message description: Human-readable error message examples: - >- Workflow configuration with id '123e4567-e89b-12d3-a456-426614174000' not found details: anyOf: - additionalProperties: true type: object - type: 'null' title: Details description: >- Additional error details as a dictionary (flexible structure for business logic errors) examples: - workflow_id: 123e4567-e89b-12d3-a456-426614174000 type: object required: - code - message title: ErrorInfo description: >- Nested error information object. Note: This model uses an untyped dict for `details` to match the flexible error structure used throughout the service layer (see WorkflowServiceError and similar). This is distinct from ErrorDetail, which is used for structured validation errors. securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- JWT Bearer token authentication. Include the token in the Authorization header as: `Authorization: Bearer `. The JWT must contain valid client_id, and project_id claims for tenant isolation and SDK routing. ````