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 for more information.

Get the Governance Console configuration preview

GET https://api.ap1.datadoghq.com/api/v2/governance/confighttps://api.ap2.datadoghq.com/api/v2/governance/confighttps://api.datadoghq.eu/api/v2/governance/confighttps://api.ddog-gov.com/api/v2/governance/confighttps://api.us2.ddog-gov.com/api/v2/governance/confighttps://api.uk1.datadoghq.com/api/v2/governance/confighttps://api.datadoghq.com/api/v2/governance/confighttps://api.us3.datadoghq.com/api/v2/governance/confighttps://api.us5.datadoghq.com/api/v2/governance/config

List insights preview

GET https://api.ap1.datadoghq.com/api/v2/governance/insightshttps://api.ap2.datadoghq.com/api/v2/governance/insightshttps://api.datadoghq.eu/api/v2/governance/insightshttps://api.ddog-gov.com/api/v2/governance/insightshttps://api.us2.ddog-gov.com/api/v2/governance/insightshttps://api.uk1.datadoghq.com/api/v2/governance/insightshttps://api.datadoghq.com/api/v2/governance/insightshttps://api.us3.datadoghq.com/api/v2/governance/insightshttps://api.us5.datadoghq.com/api/v2/governance/insights

List controls preview

GET https://api.ap1.datadoghq.com/api/v2/governance/controlhttps://api.ap2.datadoghq.com/api/v2/governance/controlhttps://api.datadoghq.eu/api/v2/governance/controlhttps://api.ddog-gov.com/api/v2/governance/controlhttps://api.us2.ddog-gov.com/api/v2/governance/controlhttps://api.uk1.datadoghq.com/api/v2/governance/controlhttps://api.datadoghq.com/api/v2/governance/controlhttps://api.us3.datadoghq.com/api/v2/governance/controlhttps://api.us5.datadoghq.com/api/v2/governance/control

Get a control preview

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

Update a control preview

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

List control detections preview

GET https://api.ap1.datadoghq.com/api/v2/governance/control/{detection_type}/detectionshttps://api.ap2.datadoghq.com/api/v2/governance/control/{detection_type}/detectionshttps://api.datadoghq.eu/api/v2/governance/control/{detection_type}/detectionshttps://api.ddog-gov.com/api/v2/governance/control/{detection_type}/detectionshttps://api.us2.ddog-gov.com/api/v2/governance/control/{detection_type}/detectionshttps://api.uk1.datadoghq.com/api/v2/governance/control/{detection_type}/detectionshttps://api.datadoghq.com/api/v2/governance/control/{detection_type}/detectionshttps://api.us3.datadoghq.com/api/v2/governance/control/{detection_type}/detectionshttps://api.us5.datadoghq.com/api/v2/governance/control/{detection_type}/detections

Get a detection preview

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

Update a detection preview

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

Mitigate detections preview

POST https://api.ap1.datadoghq.com/api/v2/governance/detections/mitigatehttps://api.ap2.datadoghq.com/api/v2/governance/detections/mitigatehttps://api.datadoghq.eu/api/v2/governance/detections/mitigatehttps://api.ddog-gov.com/api/v2/governance/detections/mitigatehttps://api.us2.ddog-gov.com/api/v2/governance/detections/mitigatehttps://api.uk1.datadoghq.com/api/v2/governance/detections/mitigatehttps://api.datadoghq.com/api/v2/governance/detections/mitigatehttps://api.us3.datadoghq.com/api/v2/governance/detections/mitigatehttps://api.us5.datadoghq.com/api/v2/governance/detections/mitigate

Get control notification settings preview

GET https://api.ap1.datadoghq.com/api/v2/governance/control/{detection_type}/notification_settingshttps://api.ap2.datadoghq.com/api/v2/governance/control/{detection_type}/notification_settingshttps://api.datadoghq.eu/api/v2/governance/control/{detection_type}/notification_settingshttps://api.ddog-gov.com/api/v2/governance/control/{detection_type}/notification_settingshttps://api.us2.ddog-gov.com/api/v2/governance/control/{detection_type}/notification_settingshttps://api.uk1.datadoghq.com/api/v2/governance/control/{detection_type}/notification_settingshttps://api.datadoghq.com/api/v2/governance/control/{detection_type}/notification_settingshttps://api.us3.datadoghq.com/api/v2/governance/control/{detection_type}/notification_settingshttps://api.us5.datadoghq.com/api/v2/governance/control/{detection_type}/notification_settings

Update control notification settings preview

PUT https://api.ap1.datadoghq.com/api/v2/governance/control/{detection_type}/notification_settingshttps://api.ap2.datadoghq.com/api/v2/governance/control/{detection_type}/notification_settingshttps://api.datadoghq.eu/api/v2/governance/control/{detection_type}/notification_settingshttps://api.ddog-gov.com/api/v2/governance/control/{detection_type}/notification_settingshttps://api.us2.ddog-gov.com/api/v2/governance/control/{detection_type}/notification_settingshttps://api.uk1.datadoghq.com/api/v2/governance/control/{detection_type}/notification_settingshttps://api.datadoghq.com/api/v2/governance/control/{detection_type}/notification_settingshttps://api.us3.datadoghq.com/api/v2/governance/control/{detection_type}/notification_settingshttps://api.us5.datadoghq.com/api/v2/governance/control/{detection_type}/notification_settings

Get notification settings preview

GET https://api.ap1.datadoghq.com/api/v2/governance/notification_settingshttps://api.ap2.datadoghq.com/api/v2/governance/notification_settingshttps://api.datadoghq.eu/api/v2/governance/notification_settingshttps://api.ddog-gov.com/api/v2/governance/notification_settingshttps://api.us2.ddog-gov.com/api/v2/governance/notification_settingshttps://api.uk1.datadoghq.com/api/v2/governance/notification_settingshttps://api.datadoghq.com/api/v2/governance/notification_settingshttps://api.us3.datadoghq.com/api/v2/governance/notification_settingshttps://api.us5.datadoghq.com/api/v2/governance/notification_settings

Update notification settings preview

PATCH https://api.ap1.datadoghq.com/api/v2/governance/notification_settingshttps://api.ap2.datadoghq.com/api/v2/governance/notification_settingshttps://api.datadoghq.eu/api/v2/governance/notification_settingshttps://api.ddog-gov.com/api/v2/governance/notification_settingshttps://api.us2.ddog-gov.com/api/v2/governance/notification_settingshttps://api.uk1.datadoghq.com/api/v2/governance/notification_settingshttps://api.datadoghq.com/api/v2/governance/notification_settingshttps://api.us3.datadoghq.com/api/v2/governance/notification_settingshttps://api.us5.datadoghq.com/api/v2/governance/notification_settings