Taxonomy Toolswordpress_delete_term

wordpress_delete_term

Delete a taxonomy term.

wordpress_delete_term

Delete a term.

Parameters

3 parameters, 2 required.

NameTypeRequiredWhat it is
taxonomystringyesTaxonomy name
idnumberyesTerm ID
approval_tokenstringnoOne-time token from a prior respira_approval_required response. Omit on the first call; the tool will reject with a token if approval is required, then re-call with this parameter set to that token to confirm and execute.

Example call

The smallest valid call, with the required parameters only:

{
  "name": "wordpress_delete_term",
  "arguments": {
    "taxonomy": "value",
    "id": 123
  }
}

Response

{
  "success": true,
  "deleted": true,
  "taxonomy": "category",
  "id": 123
}

What it changes

It removes or overwrites something on the site, so treat it as the careful kind of call. Respira takes a snapshot before the write, and the change can be undone from that snapshot for 90 days. On a page or post the edit lands on a copy first. The live page changes only when a person approves the copy in wp-admin. Calling it twice with the same arguments leaves the site in the same state as calling it once. On a connection set to read-only it is refused with respira_scope_denied.

How long it takes

A typical call takes about 2.0 seconds. 19 in 20 finish within 3.3 seconds. Measured on real sites over the last week, so it includes the site's own hosting.

Availability

Works on any WordPress site, whichever page builder it uses. Available since Respira 1.0.0.

Example Prompts

  • "Delete category 123"
  • "Remove the unused tag 99"