PATCH https://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.datadoghq.eu/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}/tagshttps://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}/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
Request
Body Data (required)
Response
Code Example
// Update App Tags returns "No Content" response
package main
import (
"context"
"fmt"
"os"
"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
"github.com/DataDog/datadog-api-client-go/v2/api/datadogV2"
"github.com/google/uuid"
)
func main() {
body := datadogV2.UpdateAppTagsRequest{
Data: &datadogV2.UpdateAppTagsRequestData{
Attributes: &datadogV2.UpdateAppTagsRequestDataAttributes{
Tags: []string{
"team:platform",
"service:ops",
},
},
Type: datadogV2.APPTAGSTYPE_TAGS.Ptr(),
},
}
ctx := datadog.NewDefaultContext(context.Background())
configuration := datadog.NewConfiguration()
apiClient := datadog.NewAPIClient(configuration)
api := datadogV2.NewAppBuilderApi(apiClient)
r, err := api.UpdateAppTags(ctx, uuid.MustParse("9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d"), body)
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `AppBuilderApi.UpdateAppTags`: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
}
Instructions
First install the library and its dependencies and then save the example to main.go and run following commands:
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comddog-gov.comus2.ddog-gov.com" DD_API_KEY="<API-KEY>" DD_APP_KEY="<APP-KEY>" go run "main.go"
// Update App Tags returns "No Content" response
import com.datadog.api.client.ApiClient;
import com.datadog.api.client.ApiException;
import com.datadog.api.client.v2.api.AppBuilderApi;
import com.datadog.api.client.v2.model.AppTagsType;
import com.datadog.api.client.v2.model.UpdateAppTagsRequest;
import com.datadog.api.client.v2.model.UpdateAppTagsRequestData;
import com.datadog.api.client.v2.model.UpdateAppTagsRequestDataAttributes;
import java.util.Arrays;
import java.util.UUID;
public class Example {
public static void main(String[] args) {
ApiClient defaultClient = ApiClient.getDefaultApiClient();
AppBuilderApi apiInstance = new AppBuilderApi(defaultClient);
UpdateAppTagsRequest body =
new UpdateAppTagsRequest()
.data(
new UpdateAppTagsRequestData()
.attributes(
new UpdateAppTagsRequestDataAttributes()
.tags(Arrays.asList("team:platform", "service:ops")))
.type(AppTagsType.TAGS));
try {
apiInstance.updateAppTags(UUID.fromString("65bb1f25-52e1-4510-9f8d-22d1516ed693"), body);
} catch (ApiException e) {
System.err.println("Exception when calling AppBuilderApi#updateAppTags");
System.err.println("Status code: " + e.getCode());
System.err.println("Reason: " + e.getResponseBody());
System.err.println("Response headers: " + e.getResponseHeaders());
e.printStackTrace();
}
}
}
Instructions
First install the library and its dependencies and then save the example to Example.java and run following commands:
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comddog-gov.comus2.ddog-gov.com" DD_API_KEY="<API-KEY>" DD_APP_KEY="<APP-KEY>" java "Example.java"
"""
Update App Tags returns "No Content" response
"""
from datadog_api_client import ApiClient, Configuration
from datadog_api_client.v2.api.app_builder_api import AppBuilderApi
from datadog_api_client.v2.model.app_tags_type import AppTagsType
from datadog_api_client.v2.model.update_app_tags_request import UpdateAppTagsRequest
from datadog_api_client.v2.model.update_app_tags_request_data import UpdateAppTagsRequestData
from datadog_api_client.v2.model.update_app_tags_request_data_attributes import UpdateAppTagsRequestDataAttributes
from uuid import UUID
body = UpdateAppTagsRequest(
data=UpdateAppTagsRequestData(
attributes=UpdateAppTagsRequestDataAttributes(
tags=[
"team:platform",
"service:ops",
],
),
type=AppTagsType.TAGS,
),
)
configuration = Configuration()
with ApiClient(configuration) as api_client:
api_instance = AppBuilderApi(api_client)
api_instance.update_app_tags(app_id=UUID("9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d"), body=body)
Instructions
First install the library and its dependencies and then save the example to example.py and run following commands:
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comddog-gov.comus2.ddog-gov.com" DD_API_KEY="<API-KEY>" DD_APP_KEY="<APP-KEY>" python3 "example.py"
# Update App Tags returns "No Content" response
require "datadog_api_client"
api_instance = DatadogAPIClient::V2::AppBuilderAPI.new
body = DatadogAPIClient::V2::UpdateAppTagsRequest.new({
data: DatadogAPIClient::V2::UpdateAppTagsRequestData.new({
attributes: DatadogAPIClient::V2::UpdateAppTagsRequestDataAttributes.new({
tags: [
"team:platform",
"service:ops",
],
}),
type: DatadogAPIClient::V2::AppTagsType::TAGS,
}),
})
api_instance.update_app_tags("9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d", body)
Instructions
First install the library and its dependencies and then save the example to example.rb and run following commands:
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comddog-gov.comus2.ddog-gov.com" DD_API_KEY="<API-KEY>" DD_APP_KEY="<APP-KEY>" rb "example.rb"
// Update App Tags returns "No Content" response
use datadog_api_client::datadog;
use datadog_api_client::datadogV2::api_app_builder::AppBuilderAPI;
use datadog_api_client::datadogV2::model::AppTagsType;
use datadog_api_client::datadogV2::model::UpdateAppTagsRequest;
use datadog_api_client::datadogV2::model::UpdateAppTagsRequestData;
use datadog_api_client::datadogV2::model::UpdateAppTagsRequestDataAttributes;
use uuid::Uuid;
#[tokio::main]
async fn main() {
let body = UpdateAppTagsRequest::new().data(
UpdateAppTagsRequestData::new()
.attributes(UpdateAppTagsRequestDataAttributes::new(vec![
"team:platform".to_string(),
"service:ops".to_string(),
]))
.type_(AppTagsType::TAGS),
);
let configuration = datadog::Configuration::new();
let api = AppBuilderAPI::with_config(configuration);
let resp = api
.update_app_tags(
Uuid::parse_str("00000000-0000-0000-0000-000000000000").expect("invalid UUID"),
body,
)
.await;
if let Ok(value) = resp {
println!("{:#?}", value);
} else {
println!("{:#?}", resp.unwrap_err());
}
}
Instructions
First install the library and its dependencies and then save the example to src/main.rs and run following commands:
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comddog-gov.comus2.ddog-gov.com" DD_API_KEY="<API-KEY>" DD_APP_KEY="<APP-KEY>" cargo run
/**
* Update App Tags returns "No Content" response
*/
import { client, v2 } from "@datadog/datadog-api-client";
const configuration = client.createConfiguration();
const apiInstance = new v2.AppBuilderApi(configuration);
const params: v2.AppBuilderApiUpdateAppTagsRequest = {
body: {
data: {
attributes: {
tags: ["team:platform", "service:ops"],
},
type: "tags",
},
},
appId: "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
};
apiInstance
.updateAppTags(params)
.then((data: any) => {
console.log(
"API called successfully. Returned data: " + JSON.stringify(data)
);
})
.catch((error: any) => console.error(error));
Instructions
First install the library and its dependencies and then save the example to example.ts and run following commands:
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comddog-gov.comus2.ddog-gov.com" DD_API_KEY="<API-KEY>" DD_APP_KEY="<APP-KEY>" tsc "example.ts"