For AI agents: A markdown version of this page is available at https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/api/latest/app-builder/update-app-tags.md. A documentation index is available at /llms.txt.
Language
Datadog site
CAUTIONThis product is not supported for your selected Datadog site. (US2-FED).

Update App Tags

PATCHhttps://api.datadoghq.com/api/v2/app-builder/apps/{app_id}/tagshttps://api.us3.datadoghq.com/api/v2/app-builder/apps/{app_id}/tagshttps://api.us5.datadoghq.com/api/v2/app-builder/apps/{app_id}/tagshttps://api.datadoghq.eu/api/v2/app-builder/apps/{app_id}/tagshttps://api.ap1.datadoghq.com/api/v2/app-builder/apps/{app_id}/tagshttps://api.ap2.datadoghq.com/api/v2/app-builder/apps/{app_id}/tagshttps://api.uk1.datadoghq.com/api/v2/app-builder/apps/{app_id}/tagshttps://api.ddog-gov.com/api/v2/app-builder/apps/{app_id}/tagshttps://api.us2.ddog-gov.com/api/v2/app-builder/apps/{app_id}/tags

Overview

Replace the tags on an app. The provided list overwrites the existing tags entirely; tags not present in the request body are removed.

This endpoint requires the apps_write permission.

Arguments

Path Parameters

Name
Type
Description
app_id [required]
string

The ID of the app.

Request

Body Data (required)

Field
Type
Description
data
object

Data for replacing an app's tags.

Response

No Content

Code Example

Update App Tags returns "No Content" response
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"

# Set your Datadog site and credentials
export DD_SITE="datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X PATCH "https://api.${DD_SITE}/api/v2/app-builder/apps/${app_id}/tags" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "tags": [
        "team:platform",
        "service:ops"
      ]
    },
    "type": "tags"
  }
}
EOF
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"

# Set your Datadog site and credentials
export DD_SITE="us3.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X PATCH "https://api.${DD_SITE}/api/v2/app-builder/apps/${app_id}/tags" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "tags": [
        "team:platform",
        "service:ops"
      ]
    },
    "type": "tags"
  }
}
EOF
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"

# Set your Datadog site and credentials
export DD_SITE="us5.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X PATCH "https://api.${DD_SITE}/api/v2/app-builder/apps/${app_id}/tags" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "tags": [
        "team:platform",
        "service:ops"
      ]
    },
    "type": "tags"
  }
}
EOF
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"

# Set your Datadog site and credentials
export DD_SITE="datadoghq.eu"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X PATCH "https://api.${DD_SITE}/api/v2/app-builder/apps/${app_id}/tags" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "tags": [
        "team:platform",
        "service:ops"
      ]
    },
    "type": "tags"
  }
}
EOF
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"

# Set your Datadog site and credentials
export DD_SITE="ap1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X PATCH "https://api.${DD_SITE}/api/v2/app-builder/apps/${app_id}/tags" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "tags": [
        "team:platform",
        "service:ops"
      ]
    },
    "type": "tags"
  }
}
EOF
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"

# Set your Datadog site and credentials
export DD_SITE="ap2.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X PATCH "https://api.${DD_SITE}/api/v2/app-builder/apps/${app_id}/tags" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "tags": [
        "team:platform",
        "service:ops"
      ]
    },
    "type": "tags"
  }
}
EOF
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"

# Set your Datadog site and credentials
export DD_SITE="uk1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X PATCH "https://api.${DD_SITE}/api/v2/app-builder/apps/${app_id}/tags" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "tags": [
        "team:platform",
        "service:ops"
      ]
    },
    "type": "tags"
  }
}
EOF
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"

# Set your Datadog site and credentials
export DD_SITE="ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X PATCH "https://api.${DD_SITE}/api/v2/app-builder/apps/${app_id}/tags" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "tags": [
        "team:platform",
        "service:ops"
      ]
    },
    "type": "tags"
  }
}
EOF
# Path parameters
export app_id="65bb1f25-52e1-4510-9f8d-22d1516ed693"

# Set your Datadog site and credentials
export DD_SITE="us2.ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X PATCH "https://api.${DD_SITE}/api/v2/app-builder/apps/${app_id}/tags" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "tags": [
        "team:platform",
        "service:ops"
      ]
    },
    "type": "tags"
  }
}
EOF