> ## Documentation Index
> Fetch the complete documentation index at: https://docs.opigno.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete a taxonomy term

To delete a taxonomy term, `deleteTaxonomyTerm` mutation should be used.

<Note>
  **Important:** this operation is irreversible. After the term deletion, it will disappear from all content items where it  was used.
</Note>

**Access policy:**

* The API user context should have permission to update the given taxonomy term.
* A term with the given ID should exist on the site.

The only argument that is used in the mutation is `termId` (required).

Now let's delete the term that was created before (see [Create a taxonomy term](/OpignoEnterpriseAPI/Taxonomy/CreateTaxonomyTerm) for more details).

<CodeGroup>
  ```filename GraphQL [expandable] theme={null}
  mutation deleteTaxonomyTerm {
    deleteTaxonomyTerm(termId: "11") {
      errors
      response
    }
  }
  ```

  ```File Query result [expandable] theme={null}
  {
    "data": {
      "deleteTaxonomyTerm": {
        "errors": [],
        "response": true
      }
    }
  }
  ```
</CodeGroup>

After the mutation execution the term was deleted:

<img style={{ borderRadius:"0.3rem" }} src="https://mintcdn.com/connect-i/duHonZHPe3F63_yi/images/after-term-delete.png?fit=max&auto=format&n=duHonZHPe3F63_yi&q=85&s=92e6978d5b852d662beeba5f2444d666" alt="After term deletion" title="After term deletion" width="2430" height="936" data-path="images/after-term-delete.png" />
