Get the Cloud Cost Management description for a single tag key. Use filter[cloud] to scope the lookup to a specific cloud provider; when omitted, the response resolves the description in fallback order (cloud-specific organization override, then cloudless organization default, then Datadog’s global default).
This endpoint requires the cloud_cost_management_read permission.
OAuth apps require the cloud_cost_management_read authorization scope to access this endpoint.
Arguments
Path Parameters
Name
Type
Description
tag_key [required]
string
The tag key whose description is being fetched.
Query Strings
Name
Type
Description
filter[cloud]
string
Cloud provider to scope the lookup to (for example, aws). Omit to use the resolved fallback.
Single Cloud Cost Management tag key description returned by the get-by-key endpoint.
Expand All
Field
Type
Description
data [required]
object
A Cloud Cost Management tag key description, either cross-cloud or scoped to a single cloud provider.
attributes [required]
object
Human-readable description and metadata attached to a Cloud Cost Management tag key, optionally scoped to a single cloud provider.
cloud [required]
string
Cloud provider this description applies to (for example, aws). Empty when the description is the cross-cloud default for the tag key.
created_at [required]
string
Timestamp when the description was created, in RFC 3339 format.
description [required]
string
The human-readable description for the tag key.
source [required]
enum
Origin of the description. human indicates the description was written by a user, ai_generated was produced by AI, and datadog is a default supplied by Datadog.
Allowed enum values: human,ai_generated,datadog
tag_key [required]
string
The tag key this description applies to.
updated_at [required]
string
Timestamp when the description was last updated, in RFC 3339 format.
id [required]
string
Stable identifier of the tag description. Equals the tag key when the description is the cross-cloud default; encodes both the cloud and the tag key when the description is cloud-specific.
type [required]
enum
Type of the Cloud Cost Management tag description resource.
Allowed enum values: cost_tag_description
default: cost_tag_description
{"data":{"attributes":{"cloud":"aws","created_at":"2026-01-01T12:00:00Z","description":"AWS account that owns this cost.","source":"human","tag_key":"account_id","updated_at":"2026-01-01T12:00:00Z"},"id":"account_id","type":"cost_tag_description"}}
