Delete tag values from a New Relic entity

Removes specific tag values from a New Relic entity, leaving other values under the same key untouched.

For prerequisites, see New Relic Tagging actions.

Delete tag values

The action identifier is newrelic.tagging.deleteTagValues.

Removes specific key/value pairs from a New Relic entity's tags. We keep other values under the same key. To remove an entire tag key and all its values, use newrelic.tagging.deleteTags 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 update.	`"MTIzNDU2fEFQTXxBUFBMSUNBVElPTnwxMjM0NQ"`
tagValues	List	Required. The specific key/value pairs to remove. Other values under the same key are kept.	`tagValues: - key: team value: ui`
selectors	List	Optional. JQ selectors to extract specific values from the response.	`selectors: - name: errors expression: ".data.taggingDeleteTagValuesFromEntity.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": { "taggingDeleteTagValuesFromEntity": { "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": {
    "taggingDeleteTagValuesFromEntity": {
      "errors": null
    }
  }
}

Use selectors to extract specific fields from data.

The following example removes the ui value from the team tag key, leaving any other values under team intact.

Workflow example
`name: newrelic_tagging_deletetagvalues_workflow workflowInputs: entityGuid: type: String steps: - name: removeUiTagValue type: action action: newrelic.tagging.deleteTagValues version: 1 inputs: entityGuid: ${{ .workflowInputs.entityGuid }} tagValues: - key: team value: ui next: end`

Workflow example

name: newrelic_tagging_deletetagvalues_workflow
workflowInputs:
  entityGuid:
    type: String
steps:
  - name: removeUiTagValue
    type: action
    action: newrelic.tagging.deleteTagValues
    version: 1
    inputs:
      entityGuid: ${{ .workflowInputs.entityGuid }}
      tagValues:
        - key: team
          value: ui
    next: end

Delete tag values from a New Relic entity

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

Delete tag values