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

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

# Tag Rules
Copy pageCopied
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{% #list-tag-rules %}

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

## Create a tag rule → preview{% #create-a-tag-rule %}

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

## Get a tag rule → preview{% #get-a-tag-rule %}

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

## Update a tag rule → preview{% #update-a-tag-rule %}

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

## Delete a tag rule → preview{% #delete-a-tag-rule %}

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

## Get a tag rule compliance score → preview{% #get-a-tag-rule-compliance-score %}

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