Remove tags from Amazon Pinpoint resources programmatically

The following examples show how to remove a tag (both the key and value) from an Amazon Pinpoint resource by using the AWS CLI and the Amazon Pinpoint REST API. You can also use any supported AWS SDK to remove a tag from a resource.

To remove a tag from multiple Amazon Pinpoint resources in a single operation, use the resource groups tagging operations of the AWS CLI or the AWS Resource Groups Tagging API. To remove only a specific tag value (not a tag key) from a resource, update the tag for the resource.

Remove tags by using the API

To remove a tag from a resource by using the Amazon Pinpoint REST API, send a DELETE request to the Tags URI. In the URI, include the Amazon Resource Name (ARN) of the resource that you want to remove a tag from, followed by the tagKeys parameter and the tag to remove. For example:

https://endpoint/v1/tags/resource-arn?tagKeys=key

Where:

All the parameters should be URL encoded.

To remove multiple tag keys and their associated values from a resource, append the tagKeys parameter and argument for each additional tag to remove, separated by an ampersand (&). For example:

https://endpoint/v1/tags/resource-arn?tagKeys=key1&tagKeys=key2

All the parameters should be URL encoded.

Remove tags by using the AWS CLI

To remove a tag from a resource by using the AWS CLI, run the untag-resource command. Include the tag-keys parameter and argument, as shown in the following example.

$ aws pinpoint untag-resource \
  --resource-arn resource-arn \
  --tag-keys key1 key2

In the preceding example, make the following changes: