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

# run_saved_report

> Execute a saved report as configured and return the dataset the dashboard renders.

Runs the report with its stored attribution model, window, filters, sources, and group\_by — exactly as the dashboard would show it. Trust the user's saved config; for ad-hoc analysis with overrides, use [`query_ad_metrics`](https://docs.cometly.com/mcp/tools/query-ad-metrics) directly.

## Parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `report_id` | integer | Yes | |
| `format` | string | No | `json` (default), `csv`, or `yaml`. |

## Output

```json theme={null}
{
  "report_id": 42,
  "name": "ROAS by Source",
  "rows": [
    { "source": "facebook_ads", "roas": 3.82, "purchase": 412 },
    { "source": "google_ads",   "roas": 4.15, "purchase": 297 }
  ]
}
```

Custom event slot ids are rewritten to user labels in column names — `# label_map:` footer carries the mapping.

## Related

* [`get_report_definition`](https://docs.cometly.com/mcp/tools/get-report-definition) — inspect the report without running it.
* [`analyze_report`](https://docs.cometly.com/mcp/tools/analyze-report) — run the report AND get an AI-generated narrative summary (deducts AI credits).


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