Delete a Tag



Deletes the tag that has the specified key and value. The value may be an empty string to match a tag that has an empty value.

Only a user-defined tag can be deleted.

Set the optional ?removeAssignments query parameter to true to remove the tag and any existing assignments that match the specified key and value.


Path Parameters
Query Parameters


204 Response

No Content.

Successfully deleted the tag. There is no response body.

400 Response

Bad request.

An attempt was made to delete a tag that cannot be removed (for example, a system-provided tag cannot be deleted).

404 Response

Not found.

No tag with the specified key/value was found.

409 Response


The tag is assigned to one or more resources, and the removeAssignments query parameter was not set to true.