Taxonomy Toolswordpress_list_terms

wordpress_list_terms

List terms in a taxonomy with optional search and pagination.

wordpress_list_terms

List terms in a taxonomy.

Parameters

4 parameters, 1 required.

NameTypeRequiredWhat it is
taxonomystringyesTaxonomy name
searchstringnoSearch term
pagenumbernoPage number
per_pagenumbernoItems per page

Example call

The smallest valid call, with the required parameters only:

{
  "name": "wordpress_list_terms",
  "arguments": {
    "taxonomy": "value"
  }
}

Response

{
  "success": true,
  "taxonomy": "category",
  "terms": [
    {
      "id": 12,
      "name": "News",
      "slug": "news"
    }
  ]
}

What it changes

Nothing. It only reads, so there is nothing to approve and nothing to undo.

When it fails

The failures seen most often on real sites in the last 30 days, most common first:

  • respira_site_id_not_found: No connected site has that ID. Call respira_list_sites and use an ID from the result.

How long it takes

A typical call takes about 1.5 seconds. 19 in 20 finish within 2.9 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

  • "List terms in category"
  • "Search tags for 'seo'"
Was this page helpful?