Skip to main content
Only users with the ADMINISTRATOR scope in the current context can assign taxonomy terms to hierarchy levels. Make sure your API token grants administrator privileges. See Understanding Scopes for more information.
To assign a taxonomy term to a specific hierarchy level, use the assignTaxonomyTermToLevel 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 assign.—
hierarchyLevelIdIDRequired. The unique identifier of the hierarchy level to assign the taxonomy term to.—
This operation creates a relationship between a taxonomy term and a hierarchy level, which can be used for categorization and filtering purposes.
mutation assignTaxonomyTermToLevel {
  assignTaxonomyTermToLevel(
    taxonomyTermId: 9
    hierarchyLevelId: 1
  ) {
    errors
    response
  }
}