Delete a hierarchy level

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:

Argument	Type	Description	Default
`id`	`ID`	Required. The ID of the hierarchy level to delete.	—

mutation deleteHierarchyLevel {
  deleteHierarchyLevel(
    id: "23"
  ){
    errors
    response 
  }
}

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

⌘I

Getting started

Integration & Concepts

Use cases

Hierarchy Management

Zapier Integration

Mobile application

Delete a hierarchy level