---
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
Copy pageCopied
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 → 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 → 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 → 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 → 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 → 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 → 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 → 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 → 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 → 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 → 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 → 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 → 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 → 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 |