Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.maxicore.ai/llms.txt

Use this file to discover all available pages before exploring further.

Taxonomy abilities let you manage terms in any registered WordPress taxonomy and control which terms are assigned to your posts, pages, and custom post types. You can assign terms one at a time, replace all terms in a taxonomy in a single call, or update terms across hundreds of posts at once with the bulk operation.

​
All taxonomy abilities

AbilityDescriptionCapabilityPlan
maxi/create-termCreate a new term in any taxonomy.manage_categoriesLite
maxi/get-termGet a term by its ID.readLite
maxi/update-termUpdate a term’s name, slug, description, or parent.manage_categoriesLite
maxi/delete-termDelete a term.manage_categoriesLite
maxi/list-termsList terms with optional filters for parent, search query, and order.readLite
maxi/assign-termsAppend terms to a post while keeping existing term assignments.edit_postsLite
maxi/remove-termsRemove specific terms from a post.edit_postsLite
maxi/set-termsReplace all terms on a post for a given taxonomy.edit_postsLite
maxi/bulk-update-termsAssign, append, or remove terms across up to 500 posts and 100 terms in a single call.edit_posts or edit_products + per-objectLite
All taxonomy abilities work with any registered taxonomy: category, post_tag, product_cat, or any custom taxonomy on your site.

​
Key ability examples

​
maxi/create-term

Create a new term. The slug is optional — if omitted, WordPress generates one from the name. 
{
  "taxonomy": "category",
  "name": "Technology",
  "slug": "technology"
}

​
maxi/assign-terms

Add terms to a post without removing any currently assigned terms. Pass term IDs. 
{
  "object_id": 123,
  "taxonomy": "category",
  "terms": [45, 67]
}

​
maxi/set-terms

Replace all terms on a post for a given taxonomy. Any terms not in the terms array are removed. 
{
  "object_id": 123,
  "taxonomy": "category",
  "terms": [45]
}
To clear all terms from a post in a taxonomy, use maxi/set-terms with an empty terms array: "terms": [].

​
maxi/bulk-update-terms

Update terms across many posts at once. Accepts either a single object_id or an object_ids array. Use the mode field to control how terms are applied. 
{
  "object_ids": [100, 101, 102],
  "taxonomy": "category",
  "terms": [45],
  "mode": "append"
}
Replaces all existing terms in the taxonomy with the provided list. Pass an empty terms array to clear all terms from every object in the batch.
Adds the provided terms to each object while keeping any terms already assigned. No existing term assignments are removed.
Removes only the specified terms from each object. Other term assignments are left untouched.
maxi/bulk-update-terms supports up to 500 objects and 100 terms per call. Requests that exceed these limits are rejected.

​
Yoast SEO integration

If the Yoast SEO plugin is active on your site, you can set SEO metadata on taxonomy terms using maxi/set-yoast-term-seo. 
{
  "taxonomy": "category",
  "term_id": 45,
  "title": "Technology articles — My Site",
  "description": "Browse all posts in the Technology category."
}
This ability creates the wpseo_taxonomy_meta record if it does not exist and merges with any existing Yoast keys — it does not overwrite other Yoast settings like canonical or noindex. When the Yoast Indexables table is available, the matching row is synced automatically. The response includes indexable_synced: true when that sync succeeded.
maxi/set-yoast-term-seo requires the Yoast SEO plugin to be installed and active (WPSEO_VERSION must be defined). The ability returns an error if Yoast is not available.