Unassign taxonomy term from hierarchy level

Only users with the ADMINISTRATOR scope in the current context can unassign taxonomy terms from hierarchy levels. Make sure your API token grants administrator privileges. See Understanding Scopes for more information.

To remove a taxonomy term assignment from a specific hierarchy level, use the unassignTaxonomyTermFromLevel mutation. Access policy:

The API user context must have permission to manage taxonomy term assignments.
The specified taxonomyTermId must exist and be accessible.
The specified hierarchyLevelId must exist and be accessible.

The mutation accepts the following arguments:

Argument	Type	Description	Default
`taxonomyTermId`	`ID`	Required. The unique identifier of the taxonomy term to unassign.	—
`hierarchyLevelId`	`ID`	Required. The unique identifier of the hierarchy level to unassign the taxonomy term from.	—

This operation removes the relationship between a taxonomy term and a hierarchy level, which affects categorization and filtering capabilities.

mutation unassignTaxonomyTermFromLevel {
  unassignTaxonomyTermFromLevel(
    taxonomyTermId: 9
    hierarchyLevelId: 1
  ) {
    errors
    response
  }
}

{
  "data": {
    "unassignTaxonomyTermFromLevel": {
      "errors": [],
      "response": true
    }
  }
}

Assign taxonomy term to hierarchy level Webhook Subscriptions API

⌘I

Getting started

Integration & Concepts

Use cases

Hierarchy Management

Zapier Integration

Mobile application

Unassign taxonomy term from hierarchy level