---
title: Governance Console
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > API Reference > Governance Console
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Governance Console

The Governance Console finds issues that build up across a Datadog organization over time, such as API keys nobody uses, users who no longer need access, or custom metrics that are never queried, and tracks them through to a fix.

These endpoints allow you to:

- Read insights: measures of how your organization uses Datadog, each with the query behind it.
- Configure controls: the rules deciding how one kind of issue is found and what is done about it.
- Act on detections: the issues a control found. Assign, defer, accept as an exception, or fix.
- Manage settings: organization-wide configuration and notification destinations.

See the [Governance Console page](https://docs.datadoghq.com/account_management/governance_console.md) for more information.

## [Get the Governance Console configuration →](https://docs.datadoghq.com/api/latest/governance-console/get-the-governance-console-configuration.md) preview{% #get-the-governance-console-configuration %}

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

## [List insights →](https://docs.datadoghq.com/api/latest/governance-console/list-insights.md) preview{% #list-insights %}

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

## [List controls →](https://docs.datadoghq.com/api/latest/governance-console/list-controls.md) preview{% #list-controls %}

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

## [Get a control →](https://docs.datadoghq.com/api/latest/governance-console/get-a-control.md) preview{% #get-a-control %}

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

## [Update a control →](https://docs.datadoghq.com/api/latest/governance-console/update-a-control.md) preview{% #update-a-control %}

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

## [List control detections →](https://docs.datadoghq.com/api/latest/governance-console/list-control-detections.md) preview{% #list-control-detections %}

| Datadog site      | API endpoint                                                                            |
| ----------------- | --------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/governance/control/{detection_type}/detections |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/governance/control/{detection_type}/detections |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/governance/control/{detection_type}/detections      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/governance/control/{detection_type}/detections      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/governance/control/{detection_type}/detections  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/governance/control/{detection_type}/detections |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/governance/control/{detection_type}/detections     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/governance/control/{detection_type}/detections |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/governance/control/{detection_type}/detections |

## [Get a detection →](https://docs.datadoghq.com/api/latest/governance-console/get-a-detection.md) preview{% #get-a-detection %}

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

## [Update a detection →](https://docs.datadoghq.com/api/latest/governance-console/update-a-detection.md) preview{% #update-a-detection %}

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

## [Mitigate detections →](https://docs.datadoghq.com/api/latest/governance-console/mitigate-detections.md) preview{% #mitigate-detections %}

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

## [Get control notification settings →](https://docs.datadoghq.com/api/latest/governance-console/get-control-notification-settings.md) preview{% #get-control-notification-settings %}

| Datadog site      | API endpoint                                                                                       |
| ----------------- | -------------------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/governance/control/{detection_type}/notification_settings |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/governance/control/{detection_type}/notification_settings |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/governance/control/{detection_type}/notification_settings      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/governance/control/{detection_type}/notification_settings      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/governance/control/{detection_type}/notification_settings  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/governance/control/{detection_type}/notification_settings |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/governance/control/{detection_type}/notification_settings     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/governance/control/{detection_type}/notification_settings |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/governance/control/{detection_type}/notification_settings |

## [Update control notification settings →](https://docs.datadoghq.com/api/latest/governance-console/update-control-notification-settings.md) preview{% #update-control-notification-settings %}

| Datadog site      | API endpoint                                                                                       |
| ----------------- | -------------------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | PUT https://api.ap1.datadoghq.com/api/v2/governance/control/{detection_type}/notification_settings |
| ap2.datadoghq.com | PUT https://api.ap2.datadoghq.com/api/v2/governance/control/{detection_type}/notification_settings |
| app.datadoghq.eu  | PUT https://api.datadoghq.eu/api/v2/governance/control/{detection_type}/notification_settings      |
| app.ddog-gov.com  | PUT https://api.ddog-gov.com/api/v2/governance/control/{detection_type}/notification_settings      |
| us2.ddog-gov.com  | PUT https://api.us2.ddog-gov.com/api/v2/governance/control/{detection_type}/notification_settings  |
| uk1.datadoghq.com | PUT https://api.uk1.datadoghq.com/api/v2/governance/control/{detection_type}/notification_settings |
| app.datadoghq.com | PUT https://api.datadoghq.com/api/v2/governance/control/{detection_type}/notification_settings     |
| us3.datadoghq.com | PUT https://api.us3.datadoghq.com/api/v2/governance/control/{detection_type}/notification_settings |
| us5.datadoghq.com | PUT https://api.us5.datadoghq.com/api/v2/governance/control/{detection_type}/notification_settings |

## [Get notification settings →](https://docs.datadoghq.com/api/latest/governance-console/get-notification-settings.md) preview{% #get-notification-settings %}

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

## [Update notification settings →](https://docs.datadoghq.com/api/latest/governance-console/update-notification-settings.md) preview{% #update-notification-settings %}

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