Skip to main content
Only users with the ADMINISTRATOR scope in the current context can delete hierarchy levels. Make sure your API token grants administrator privileges. See Understanding Scopes for more information.
To delete a hierarchy level, use the deleteHierarchyLevel mutation.
Important: this operation is irreversible. After deletion, the hierarchy level is removed and will no longer appear in the hierarchy tree or any assignments where it was used.
Access policy:
  • The API user context must have permission to manage hierarchy levels.
  • A hierarchy level with the given id must exist.
The mutation accepts the following argument:
ArgumentTypeDescriptionDefault
idIDRequired. The ID of the hierarchy level to delete.—
mutation deleteHierarchyLevel {
  deleteHierarchyLevel(
    id: "23"
  ){
    errors
    response 
  }
}