---
title: Report Schedules
description: Create and manage scheduled reports.
breadcrumbs: Docs > API > Report Schedules
---

> For the complete documentation index, see [llms.txt](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/llms.txt).

# Report Schedules

Create and manage scheduled reports. A scheduled report renders a dashboard or integration
dashboard on a recurring cadence and delivers it to a set of recipients over email, Slack,
or Microsoft Teams.

## [Create a report schedule](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/report-schedules/create-a-report-schedule.md) (preview)

| Datadog site      | API endpoint                                                 |
| ----------------- | ------------------------------------------------------------ |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/reporting/schedule     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/reporting/schedule |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/reporting/schedule |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/reporting/schedule      |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/reporting/schedule |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/reporting/schedule |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/reporting/schedule |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/reporting/schedule      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/reporting/schedule  |

## [Update a report schedule](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/report-schedules/update-a-report-schedule.md) (preview)

| Datadog site      | API endpoint                                                                  |
| ----------------- | ----------------------------------------------------------------------------- |
| app.datadoghq.com | PATCH https://api.datadoghq.com/api/v2/reporting/schedule/{schedule_uuid}     |
| us3.datadoghq.com | PATCH https://api.us3.datadoghq.com/api/v2/reporting/schedule/{schedule_uuid} |
| us5.datadoghq.com | PATCH https://api.us5.datadoghq.com/api/v2/reporting/schedule/{schedule_uuid} |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/v2/reporting/schedule/{schedule_uuid}      |
| ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/v2/reporting/schedule/{schedule_uuid} |
| ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/v2/reporting/schedule/{schedule_uuid} |
| uk1.datadoghq.com | PATCH https://api.uk1.datadoghq.com/api/v2/reporting/schedule/{schedule_uuid} |
| app.ddog-gov.com  | PATCH https://api.ddog-gov.com/api/v2/reporting/schedule/{schedule_uuid}      |
| us2.ddog-gov.com  | PATCH https://api.us2.ddog-gov.com/api/v2/reporting/schedule/{schedule_uuid}  |

## [Get a report schedule](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/report-schedules/get-a-report-schedule.md)

| Datadog site      | API endpoint                                                                |
| ----------------- | --------------------------------------------------------------------------- |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/reporting/schedule/{schedule_uuid}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/reporting/schedule/{schedule_uuid} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/reporting/schedule/{schedule_uuid} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/reporting/schedule/{schedule_uuid}      |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/reporting/schedule/{schedule_uuid} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/reporting/schedule/{schedule_uuid} |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/reporting/schedule/{schedule_uuid} |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/reporting/schedule/{schedule_uuid}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/reporting/schedule/{schedule_uuid}  |

## [Toggle a report schedule](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/report-schedules/toggle-a-report-schedule.md)

| Datadog site      | API endpoint                                                                         |
| ----------------- | ------------------------------------------------------------------------------------ |
| app.datadoghq.com | PATCH https://api.datadoghq.com/api/v2/reporting/schedule/{schedule_uuid}/toggle     |
| us3.datadoghq.com | PATCH https://api.us3.datadoghq.com/api/v2/reporting/schedule/{schedule_uuid}/toggle |
| us5.datadoghq.com | PATCH https://api.us5.datadoghq.com/api/v2/reporting/schedule/{schedule_uuid}/toggle |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/v2/reporting/schedule/{schedule_uuid}/toggle      |
| ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/v2/reporting/schedule/{schedule_uuid}/toggle |
| ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/v2/reporting/schedule/{schedule_uuid}/toggle |
| uk1.datadoghq.com | PATCH https://api.uk1.datadoghq.com/api/v2/reporting/schedule/{schedule_uuid}/toggle |
| app.ddog-gov.com  | PATCH https://api.ddog-gov.com/api/v2/reporting/schedule/{schedule_uuid}/toggle      |
| us2.ddog-gov.com  | PATCH https://api.us2.ddog-gov.com/api/v2/reporting/schedule/{schedule_uuid}/toggle  |

## [Get report schedules for a resource](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/report-schedules/get-report-schedules-for-a-resource.md)

| Datadog site      | API endpoint                                                                              |
| ----------------- | ----------------------------------------------------------------------------------------- |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/reporting/schedule/{resource_type}/{resource_id}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/reporting/schedule/{resource_type}/{resource_id} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/reporting/schedule/{resource_type}/{resource_id} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/reporting/schedule/{resource_type}/{resource_id}      |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/reporting/schedule/{resource_type}/{resource_id} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/reporting/schedule/{resource_type}/{resource_id} |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/reporting/schedule/{resource_type}/{resource_id} |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/reporting/schedule/{resource_type}/{resource_id}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/reporting/schedule/{resource_type}/{resource_id}  |

## [List report schedules](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/report-schedules/list-report-schedules.md)

| Datadog site      | API endpoint                                                     |
| ----------------- | ---------------------------------------------------------------- |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/reporting/schedule/list     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/reporting/schedule/list |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/reporting/schedule/list |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/reporting/schedule/list      |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/reporting/schedule/list |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/reporting/schedule/list |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/reporting/schedule/list |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/reporting/schedule/list      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/reporting/schedule/list  |

## [Delete a report schedule](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/report-schedules/delete-a-report-schedule.md)

| Datadog site      | API endpoint                                                                   |
| ----------------- | ------------------------------------------------------------------------------ |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/reporting/schedule/{schedule_uuid}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/reporting/schedule/{schedule_uuid} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/reporting/schedule/{schedule_uuid} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v2/reporting/schedule/{schedule_uuid}      |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/reporting/schedule/{schedule_uuid} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/reporting/schedule/{schedule_uuid} |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/api/v2/reporting/schedule/{schedule_uuid} |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v2/reporting/schedule/{schedule_uuid}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v2/reporting/schedule/{schedule_uuid}  |

## [List dataset report schedules](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/report-schedules/list-dataset-report-schedules.md)

| Datadog site      | API endpoint                                                                      |
| ----------------- | --------------------------------------------------------------------------------- |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/reporting/dataset/{dataset_id}/schedules     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/reporting/dataset/{dataset_id}/schedules |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/reporting/dataset/{dataset_id}/schedules |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/reporting/dataset/{dataset_id}/schedules      |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/reporting/dataset/{dataset_id}/schedules |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/reporting/dataset/{dataset_id}/schedules |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/reporting/dataset/{dataset_id}/schedules |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/reporting/dataset/{dataset_id}/schedules      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/reporting/dataset/{dataset_id}/schedules  |

## [Print a report](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/report-schedules/print-a-report.md)

| Datadog site      | API endpoint                                              |
| ----------------- | --------------------------------------------------------- |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/reporting/print     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/reporting/print |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/reporting/print |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/reporting/print      |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/reporting/print |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/reporting/print |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/reporting/print |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/reporting/print      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/reporting/print  |