# Operations / Airflow (Admin) — Finradar API
> Version: 3.61.0 | Generated: 2026-06-20 | Content Hash: 7bed41de
> Fetch this file at: https://uat.finradarapi.com/llms/operations-airflow-admin.txt

## Authentication
All endpoints require an API key. Pass it via query parameter `?apiKey=YOUR_KEY` or header `X-API-Key: YOUR_KEY`. WebSocket endpoints accept the key in the `token` auth payload or query parameter.

---

## Operations / Airflow (Admin)

Proxy endpoints for the Airflow REST API v2. Admin-only access. Enables monitoring and controlling DAG pipelines from the FinRadar dashboard without direct Airflow UI access.

### GET /api/v1/admin/airflow/dags

List all Airflow DAGs with merged run statistics.

**Token cost:** 0 (EXEMPT — auth / billing / account / admin / health)

**Utility:** Get a combined view of DAG definitions and their execution state counts.

**Use case:** Populating the Operations dashboard DAG table with status badges and last-run info.

### GET /api/v1/admin/airflow/dags/{dag_id}/runs

List recent runs for a specific DAG.

**Token cost:** 0 (EXEMPT — auth / billing / account / admin / health)

**Utility:** View execution history and status of a pipeline.

**Use case:** Drilling into a DAG to see its recent run outcomes, durations, and failure details.

**Parameters:**
- `dag_id` (path, required): The DAG identifier
- `limit` (query, optional): Max runs to return (default 10)

### POST /api/v1/admin/airflow/dags/{dag_id}/trigger

Trigger a new DAG run.

**Token cost:** 0 (EXEMPT — auth / billing / account / admin / health)

**Utility:** Manually start a pipeline execution on demand.

**Use case:** Ad-hoc execution of data pipelines (e.g., re-running XBRL sync after a fix).

**Parameters:**
- `dag_id` (path, required): The DAG identifier

### GET /api/v1/admin/airflow/health

Check Airflow scheduler and API server health.

**Token cost:** 0 (EXEMPT — auth / billing / account / admin / health)

**Utility:** Verify the orchestration layer is operational.

**Use case:** Health monitoring badge on the Operations dashboard.

### PATCH /api/v1/admin/airflow/dags/{dag_id}/toggle

Pause or unpause a DAG.

**Token cost:** 0 (EXEMPT — auth / billing / account / admin / health)

**Utility:** Enable or disable scheduled execution of a pipeline.

**Use case:** Emergency pause of a misbehaving pipeline from the dashboard.

**Parameters:**
- `dag_id` (path, required): The DAG identifier
- `is_paused` (body, required): Boolean — true to pause, false to unpause