> ## 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 Workflow Configurations > Retrieve a paginated list of workflow configurations available to the current user. Supports filtering by: - `data_asset_type`: Filter configurations linked to a specific data asset type - `workflow_type`: Filter by type (generate-pii-tags, generate-dq-tags, etc.) - `status`: Filter by configuration status - `has_schedule`: Filter configurations with active schedules - `has_triggers`: Filter configurations with active triggers - `search`: Search by workflow name/description - `is_default`: Filter by default configuration status (pass `true` to list only the canonical default per workflow type) The response includes summary schedule information and triggers. Use the Get Configuration endpoint for full configuration details. ## OpenAPI ````yaml /openapi/em-data-readiness-v2.yaml get /api/data-readiness/workflows 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: get: tags: - Workflows summary: List Workflow Configurations description: >- Retrieve a paginated list of workflow configurations available to the current user. Supports filtering by: - `data_asset_type`: Filter configurations linked to a specific data asset type - `workflow_type`: Filter by type (generate-pii-tags, generate-dq-tags, etc.) - `status`: Filter by configuration status - `has_schedule`: Filter configurations with active schedules - `has_triggers`: Filter configurations with active triggers - `search`: Search by workflow name/description - `is_default`: Filter by default configuration status (pass `true` to list only the canonical default per workflow type) The response includes summary schedule information and triggers. Use the Get Configuration endpoint for full configuration details. operationId: list_workflow_configurations parameters: - name: page in: query required: false schema: type: integer minimum: 1 description: Page number (1-indexed) examples: - 1 default: 1 title: Page description: Page number (1-indexed) - name: per_page in: query required: false schema: type: integer maximum: 100 minimum: 1 description: Items per page (max 100) examples: - 20 default: 20 title: Per Page description: Items per page (max 100) - name: data_asset_type in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter configurations linked to a specific data asset type examples: - table - topic title: Data Asset Type description: Filter configurations linked to a specific data asset type - name: workflow_type in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by workflow type examples: - generate-pii-tags - generate-dq-tags title: Workflow Type description: Filter by workflow type - name: status in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by configuration status examples: - active - inactive title: Status description: Filter by configuration status - name: has_schedule in: query required: false schema: anyOf: - type: boolean - type: 'null' description: Filter configurations with active schedules title: Has Schedule description: Filter configurations with active schedules - name: has_triggers in: query required: false schema: anyOf: - type: boolean - type: 'null' description: Filter configurations with active triggers title: Has Triggers description: Filter configurations with active triggers - name: search in: query required: false schema: anyOf: - type: string maxLength: 255 - type: 'null' description: Search by workflow name/description title: Search description: Search by workflow name/description - name: is_default in: query required: false schema: anyOf: - type: boolean - type: 'null' description: Filter by default configuration status title: Is Default description: Filter by default configuration status responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PaginatedWorkflowConfigurationResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - BearerAuth: [] components: schemas: PaginatedWorkflowConfigurationResponse: properties: data: items: $ref: '#/components/schemas/WorkflowConfigurationListItem' type: array title: Data description: List of configuration items pagination: $ref: '#/components/schemas/PaginationMeta' description: Pagination metadata type: object required: - pagination title: PaginatedWorkflowConfigurationResponse description: Paginated list of workflow configurations. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError WorkflowConfigurationListItem: properties: workflow_type: $ref: '#/components/schemas/WorkflowType' description: Type of workflow examples: - generate-pii-tags id: type: string format: uuid title: Id description: Unique configuration identifier examples: - 123e4567-e89b-12d3-a456-426614174000 name: type: string title: Name description: Workflow name examples: - PII Detection - Production category: $ref: '#/components/schemas/WorkflowCategory' description: Workflow category examples: - enrichment data_asset_types: items: type: string type: array title: Data Asset Types description: Supported data asset types examples: - - table description: anyOf: - type: string - type: 'null' title: Description description: Workflow description from the workflow definition examples: - Detects and tags PII in production tables status: type: string title: Status description: Configuration status examples: - active is_default: type: boolean title: Is Default description: Whether this is the default configuration examples: - false schedule: anyOf: - $ref: '#/components/schemas/ScheduleSummary' - type: 'null' description: Schedule summary triggers: items: $ref: '#/components/schemas/TriggerSummary' type: array title: Triggers description: List of triggers created_at: type: string title: Created At description: Creation timestamp (ISO 8601) examples: - '2024-01-15T10:30:00Z' require_reference_pack: type: boolean title: Require Reference Pack readOnly: true supports_multi_table_selection: type: boolean title: Supports Multi Table Selection readOnly: true type: object required: - workflow_type - id - name - category - data_asset_types - status - is_default - created_at - require_reference_pack - supports_multi_table_selection title: WorkflowConfigurationListItem description: Summary workflow configuration information for list responses. example: category: enrichment created_at: '2024-01-15T10:30:00Z' data_asset_types: - table description: Detects and tags PII in production tables id: 123e4567-e89b-12d3-a456-426614174000 is_default: false name: PII Detection - Production require_reference_pack: true schedule: cron_expression: 0 0 * * * enabled: true status: active supports_multi_table_selection: false triggers: [] 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 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. WorkflowCategory: type: string enum: - ingestion - enrichment - data_quality - assessment - intelligence title: WorkflowCategory description: |- Workflow categories for grouping workflows. Categories help organize workflows into logical groups for UI display and filtering purposes. ScheduleSummary: properties: enabled: type: boolean title: Enabled description: Whether the schedule is active examples: - true cron_expression: anyOf: - type: string - type: 'null' title: Cron Expression description: Cron expression for schedule examples: - 0 0 * * * type: object required: - enabled title: ScheduleSummary description: Summary schedule information for list responses. example: cron_expression: 0 0 * * * enabled: true TriggerSummary: properties: type: type: string title: Type description: Trigger type examples: - event event_type: anyOf: - type: string - type: 'null' title: Event Type description: Event type that triggers execution examples: - table_created conditions: anyOf: - additionalProperties: true type: object - type: 'null' title: Conditions description: Conditions for trigger activation examples: - database: production type: object required: - type title: TriggerSummary description: Trigger information for responses. example: conditions: database: production event_type: table_created type: event 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. ````