> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quixa.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Scheduled Executions (Hangfire)

> Automate recurring workflow runs, nightly test regressions, and contract drift audits via Cron.

Quixa includes a production-grade, SQL Server-backed **Hangfire Execution Scheduler** that automatically executes workflows, regression suites, and contract drift checks on recurring schedules.

***

## 1. Setting Up a Schedule

1. Open any saved Flow or Suite on the canvas.
2. In the header toolbar, click the **Schedule** icon (`⏰`).
3. Configure the trigger:
   * **Schedule Frequency**: Choose standard presets (*Every 15 minutes*, *Hourly*, *Daily at Midnight*, *Weekly*) or specify a custom 5-field **Cron Expression** (e.g. `0 2 * * *` for 2:00 AM daily).
   * **Target Environment**: Select which environment configuration (`Staging`, `Prod`, `Sandbox`) should be injected at runtime.
   * **Enabled Toggle**: Activate or pause the schedule without deleting the configuration.

***

## 2. Supported Schedule Targets

* **Flow Schedules**: Run recurring business workflows (e.g. nightly synthetic test data seeding, health probe heartbeats).
* **Suite Schedules**: Run end-to-end regression suites periodically to ensure staging environments remain healthy.
* **Collection Drift Audits**: Periodically crawl upstream Swagger specs and compare SHA-256 hashes to detect API contract changes automatically.

***

## 3. Reliability & Monitoring

* **Persistent Execution**: Schedules run as durable background jobs resilient to server restarts.
* **Audit Trail**: Every scheduled run records a complete `FlowExecution` with `TriggerType: "scheduled"`, accessible in the execution history.
* **Failure Alerts**: Integrate webhooks to receive instant Slack, Discord, or Microsoft Teams notifications when a scheduled regression fails.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.