Generate a Cloud Cost Management tag description

GET https://api.ap1.datadoghq.com/api/v2/cost/tag_descriptions/{tag_key}/generatehttps://api.ap2.datadoghq.com/api/v2/cost/tag_descriptions/{tag_key}/generatehttps://api.datadoghq.eu/api/v2/cost/tag_descriptions/{tag_key}/generatehttps://api.ddog-gov.com/api/v2/cost/tag_descriptions/{tag_key}/generatehttps://api.us2.ddog-gov.com/api/v2/cost/tag_descriptions/{tag_key}/generatehttps://api.datadoghq.com/api/v2/cost/tag_descriptions/{tag_key}/generatehttps://api.us3.datadoghq.com/api/v2/cost/tag_descriptions/{tag_key}/generatehttps://api.us5.datadoghq.com/api/v2/cost/tag_descriptions/{tag_key}/generate

Overview

Use AI to draft a Cloud Cost Management tag key description based on associated cost data. The generated description is returned in the response and is not persisted by this endpoint; follow up with UpsertCostTagDescriptionByKey to save it. 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

Response

• 200
• 400
• 403
• 429

{
  "data": {
    "attributes": {
      "description": "AWS account that owns this cost."
    },
    "id": "account_id",
    "type": "cost_generated_tag_description"
  }
}

{
  "errors": [
    "Bad Request"
  ]
}

{
  "errors": [
    "Bad Request"
  ]
}

{
  "errors": [
    "Bad Request"
  ]
}

Code Example

                  # Path parameters
export tag_key="CHANGE_ME"
# Curl command
curl -X GET "https://api.ap1.datadoghq.com"https://api.ap2.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.us2.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/cost/tag_descriptions/${tag_key}/generate" \
-H "Accept: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}"