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:
ArgumentTypeDescriptionDefault
taxonomyTermIdIDRequired. The unique identifier of the taxonomy term to unassign.—
hierarchyLevelIdIDRequired. 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
  }
}