Language

English Français 日本語 한국어 Español

Datadog Site

Site help
US1 US3 US5 EU AP1 AP2 UK1 US1-FED US2-FED

Tag Policies

copy Copy pageCopied

Tag Policies 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). Policies can be blocking (data not matching the policy is rejected) or surfacing (matching data is highlighted but not blocked). Each policy reports a compliance score derived from how much recent telemetry adheres to the policy.

List tag policies → preview

GET https://api.ap1.datadoghq.com/api/v2/tag-policieshttps://api.ap2.datadoghq.com/api/v2/tag-policieshttps://api.datadoghq.eu/api/v2/tag-policieshttps://api.ddog-gov.com/api/v2/tag-policieshttps://api.us2.ddog-gov.com/api/v2/tag-policieshttps://api.uk1.datadoghq.com/api/v2/tag-policieshttps://api.datadoghq.com/api/v2/tag-policieshttps://api.us3.datadoghq.com/api/v2/tag-policieshttps://api.us5.datadoghq.com/api/v2/tag-policies

Create a tag policy → preview

POST https://api.ap1.datadoghq.com/api/v2/tag-policieshttps://api.ap2.datadoghq.com/api/v2/tag-policieshttps://api.datadoghq.eu/api/v2/tag-policieshttps://api.ddog-gov.com/api/v2/tag-policieshttps://api.us2.ddog-gov.com/api/v2/tag-policieshttps://api.uk1.datadoghq.com/api/v2/tag-policieshttps://api.datadoghq.com/api/v2/tag-policieshttps://api.us3.datadoghq.com/api/v2/tag-policieshttps://api.us5.datadoghq.com/api/v2/tag-policies

Get a tag policy → preview

GET https://api.ap1.datadoghq.com/api/v2/tag-policies/{policy_id}https://api.ap2.datadoghq.com/api/v2/tag-policies/{policy_id}https://api.datadoghq.eu/api/v2/tag-policies/{policy_id}https://api.ddog-gov.com/api/v2/tag-policies/{policy_id}https://api.us2.ddog-gov.com/api/v2/tag-policies/{policy_id}https://api.uk1.datadoghq.com/api/v2/tag-policies/{policy_id}https://api.datadoghq.com/api/v2/tag-policies/{policy_id}https://api.us3.datadoghq.com/api/v2/tag-policies/{policy_id}https://api.us5.datadoghq.com/api/v2/tag-policies/{policy_id}

Update a tag policy → preview

PATCH https://api.ap1.datadoghq.com/api/v2/tag-policies/{policy_id}https://api.ap2.datadoghq.com/api/v2/tag-policies/{policy_id}https://api.datadoghq.eu/api/v2/tag-policies/{policy_id}https://api.ddog-gov.com/api/v2/tag-policies/{policy_id}https://api.us2.ddog-gov.com/api/v2/tag-policies/{policy_id}https://api.uk1.datadoghq.com/api/v2/tag-policies/{policy_id}https://api.datadoghq.com/api/v2/tag-policies/{policy_id}https://api.us3.datadoghq.com/api/v2/tag-policies/{policy_id}https://api.us5.datadoghq.com/api/v2/tag-policies/{policy_id}

Delete a tag policy → preview

DELETE https://api.ap1.datadoghq.com/api/v2/tag-policies/{policy_id}https://api.ap2.datadoghq.com/api/v2/tag-policies/{policy_id}https://api.datadoghq.eu/api/v2/tag-policies/{policy_id}https://api.ddog-gov.com/api/v2/tag-policies/{policy_id}https://api.us2.ddog-gov.com/api/v2/tag-policies/{policy_id}https://api.uk1.datadoghq.com/api/v2/tag-policies/{policy_id}https://api.datadoghq.com/api/v2/tag-policies/{policy_id}https://api.us3.datadoghq.com/api/v2/tag-policies/{policy_id}https://api.us5.datadoghq.com/api/v2/tag-policies/{policy_id}

Get a tag policy compliance score → preview

GET https://api.ap1.datadoghq.com/api/v2/tag-policies/{policy_id}/scorehttps://api.ap2.datadoghq.com/api/v2/tag-policies/{policy_id}/scorehttps://api.datadoghq.eu/api/v2/tag-policies/{policy_id}/scorehttps://api.ddog-gov.com/api/v2/tag-policies/{policy_id}/scorehttps://api.us2.ddog-gov.com/api/v2/tag-policies/{policy_id}/scorehttps://api.uk1.datadoghq.com/api/v2/tag-policies/{policy_id}/scorehttps://api.datadoghq.com/api/v2/tag-policies/{policy_id}/scorehttps://api.us3.datadoghq.com/api/v2/tag-policies/{policy_id}/scorehttps://api.us5.datadoghq.com/api/v2/tag-policies/{policy_id}/score