Tag Rules define rules that govern which tag values are accepted for a given tag key, scoped to a particular telemetry source (such as logs, spans, or metrics). Rules can be blocking (data not matching the rule is rejected) or surfacing (matching data is highlighted but not blocked). Each rule reports a compliance score derived from how much recent telemetry adheres to the rule.

List tag rules preview

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

Create a tag rule preview

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

Get a tag rule preview

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

Update a tag rule preview

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

Delete a tag rule preview

DELETE https://api.ap1.datadoghq.com/api/v2/governance/tag_rules/{rule_id}https://api.ap2.datadoghq.com/api/v2/governance/tag_rules/{rule_id}https://api.datadoghq.eu/api/v2/governance/tag_rules/{rule_id}https://api.ddog-gov.com/api/v2/governance/tag_rules/{rule_id}https://api.us2.ddog-gov.com/api/v2/governance/tag_rules/{rule_id}https://api.uk1.datadoghq.com/api/v2/governance/tag_rules/{rule_id}https://api.datadoghq.com/api/v2/governance/tag_rules/{rule_id}https://api.us3.datadoghq.com/api/v2/governance/tag_rules/{rule_id}https://api.us5.datadoghq.com/api/v2/governance/tag_rules/{rule_id}

Get a tag rule compliance score preview

GET https://api.ap1.datadoghq.com/api/v2/governance/tag_rules/{rule_id}/scorehttps://api.ap2.datadoghq.com/api/v2/governance/tag_rules/{rule_id}/scorehttps://api.datadoghq.eu/api/v2/governance/tag_rules/{rule_id}/scorehttps://api.ddog-gov.com/api/v2/governance/tag_rules/{rule_id}/scorehttps://api.us2.ddog-gov.com/api/v2/governance/tag_rules/{rule_id}/scorehttps://api.uk1.datadoghq.com/api/v2/governance/tag_rules/{rule_id}/scorehttps://api.datadoghq.com/api/v2/governance/tag_rules/{rule_id}/scorehttps://api.us3.datadoghq.com/api/v2/governance/tag_rules/{rule_id}/scorehttps://api.us5.datadoghq.com/api/v2/governance/tag_rules/{rule_id}/score