Delete tags from a New Relic entity

Removes one or more tag keys and all values under them from a New Relic entity.

For prerequisites, see New Relic Tagging actions.

Delete tags

The action identifier is newrelic.tagging.deleteTags.

Removes one or more tag keys and all values under them from a New Relic entity. To remove only specific values while keeping other values under the same key, use newrelic.tagging.deleteTagValues instead. Built on newrelic.nerdgraph.execute.

The following table describes all available input fields for this action.

Input	Type	Description	Example
entityGuid	String	Required. The GUID of the New Relic entity to untag.	`"MTIzNDU2fEFQTXxBUFBMSUNBVElPTnwxMjM0NQ"`
tagKeys	List	Required. The tag keys to remove entirely, including all values under each key.	`tagKeys: ["team", "environment"]`
selectors	List	Optional. JQ selectors to extract specific values from the response.	`selectors: - name: errors expression: ".data.taggingDeleteTagFromEntity.errors"`

The following table describes all output fields returned by this action.

Output	Type	Description
success	Boolean	`true` when the step executed without error, `false` on failure. Covers both transport failures and NerdGraph business-logic errors.
errorMessage	String	Error message on failure, whether transport-level or a NerdGraph business-logic error. `null` on success.
data	Map	NerdGraph response: `{ "data": { "taggingDeleteTagFromEntity": { "errors": null } } }` Use `selectors` to extract specific fields from `data`.

Output

Type

Description

success

Boolean

true when the step executed without error, false on failure. Covers both transport failures and NerdGraph business-logic errors.

errorMessage

String

Error message on failure, whether transport-level or a NerdGraph business-logic error. null on success.

data

Map

NerdGraph response:

{
  "data": {
    "taggingDeleteTagFromEntity": {
      "errors": null
    }
  }
}

Use selectors to extract specific fields from data.

The following example removes the team tag key and all its values from an entity.

Workflow example
`name: newrelic_tagging_deletetags_workflow workflowInputs: entityGuid: type: String steps: - name: untagCheckoutApp type: action action: newrelic.tagging.deleteTags version: 1 inputs: entityGuid: ${{ .workflowInputs.entityGuid }} tagKeys: ["team"] next: end`

Workflow example

name: newrelic_tagging_deletetags_workflow
workflowInputs:
  entityGuid:
    type: String
steps:
  - name: untagCheckoutApp
    type: action
    action: newrelic.tagging.deleteTags
    version: 1
    inputs:
      entityGuid: ${{ .workflowInputs.entityGuid }}
      tagKeys: ["team"]
    next: end

Delete tags.css-21sua1{background:none;border:none;width:0;padding:0;}

Delete tags