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.

WooCommerce product abilities let you read and update your store catalog — from retrieving a single product’s pricing and stock data to converting product types, building out variation matrices, and applying bulk price changes across hundreds of items in one call. All product and variation abilities require an active Pro plan and WooCommerce to be installed and active.
All WooCommerce abilities require WooCommerce to be active on your site. If WooCommerce is not installed, every ability in this group returns an error. All abilities in this group are gated to the Pro plan.

​
All product abilities

AbilityDescriptionCapabilityPlan
maxi/get-productGet a product with full WooCommerce data — prices, stock, attributes, and variations.edit_productsPro
maxi/list-productsList products with WooCommerce-specific filters.edit_productsPro
maxi/update-productUpdate product data. Send only the fields you want to change.edit_productsPro
maxi/get-product-attributesGet attribute configuration for a product.edit_productsPro
maxi/set-product-attributesSet product attributes with automatic taxonomy detection.edit_productsPro
maxi/create-variationCreate a variation with an attribute combination, price, and stock.edit_productsPro
maxi/update-variationUpdate a variation’s attributes, price, stock, SKU, dimensions, or image.edit_productsPro
maxi/delete-variationDelete a product variation permanently.edit_productsPro
maxi/list-variationsList variations for one or more variable products.edit_productsPro
maxi/set-product-typeConvert a product between types (simple, variable, grouped, external).edit_productsPro
maxi/bulk-update-pricesUpdate prices for multiple products or variations with exact or percentage adjustments.edit_productsPro
maxi/bulk-update-productsBulk update products and variations across pricing, stock, SKU, and more.edit_productsPro

​
Products

​
maxi/get-product

Get full WooCommerce data for a single product — prices, stock level, attributes with taxonomy and term details, and a list of variation IDs. For variable products the response includes a price_range object with regular_min, regular_max, sale_min, sale_max, min, and max fields, so you can summarize pricing without fetching every variation individually. For simple, grouped, and external products price_range is null. 
{ "product_id": 123 }

​
maxi/list-products

List products with WooCommerce-specific filters. Each item in the response includes a price_range aggregate for variable products, so price-summary queries do not need a follow-up call to list-variations. 
{
  "type": "variable",
  "stock_status": "instock",
  "per_page": 20
}
All list-* abilities accept orderby, order, per_page, and page. For products, orderby also supports price. See listing conventions for the full reference.

​
maxi/update-product

Update WooCommerce product data — prices, stock quantity, SKU, dimensions, or visibility. Send only the fields you want to change; fields you omit are left untouched. 
{
  "product_id": 123,
  "regular_price": "49.99",
  "stock_quantity": 100
}
Always read the product with maxi/get-product before updating fields you haven’t seen in the current session. This ensures you do not overwrite data unintentionally.

​
Variations

​
maxi/get-product-attributes

Get the attribute configuration for a product — taxonomy attributes (pa_*), custom attributes, available terms, and which attributes are used for variations.

​
maxi/set-product-attributes

Set product attributes with automatic taxonomy detection. For taxonomy attributes (pa_*), the options array accepts term IDs, slugs, or names. Existing terms are resolved by ID, then slug, then name before any new term is created, which prevents duplicate slug suffixes. 
{
  "product_id": 123,
  "attributes": [
    {
      "name": "pa_color",
      "options": ["red", "blue"],
      "variation": true
    }
  ]
}

​
maxi/create-variation

Create a new variation for a variable product. Provide the parent product ID, an attribute combination, and any pricing or stock data you want to set on creation. 
{
  "product_id": 123,
  "attributes": { "pa_color": "red" },
  "regular_price": "39.99",
  "stock_quantity": 50
}

​
maxi/update-variation

Update a variation’s attributes, price, stock level, SKU, dimensions, or image. Send only the fields you want to change.

​
maxi/delete-variation

Delete a product variation permanently. This action cannot be undone — the variation and its data are removed from the database.
maxi/delete-variation is permanent. There is no trash for variations. Verify you have the correct variation_id before calling this ability.

​
maxi/list-variations

List variations for one or more variable products. Pass a single product_id or a batch of up to 20 IDs in product_ids. In batch mode, results are returned as a flat list and each item carries a product_id field identifying its parent. Pagination applies across the combined list. 
{
  "product_ids": [100, 101, 102]
}

​
maxi/set-product-type

Convert a WooCommerce product between types: simple, variable, grouped, or external. Conversion is applied in place on the existing product.

​
Bulk operations

​
maxi/bulk-update-prices

Update prices for multiple products or variations in one call. You can apply an exact amount or a percentage adjustment to all items in the list. 
{
  "ids": [100, 101, 102],
  "adjustment_type": "percentage",
  "amount": 10
}
Use adjustment_type: "percentage" to raise or lower prices by a relative amount (pass a negative value to decrease). Use adjustment_type: "exact" to set a fixed price on every item in the list.

​
maxi/bulk-update-products

Bulk update products and variations across pricing, stock, shipping, tax, SKU, title, slug, visibility, menu order, reviews policy, gallery images, short description, upsell and cross-sell IDs, and variation attributes. Handles up to 500 items per call. This ability accepts three input shapes depending on your goal:
Pass ids[] and an apply object. Every item in the list receives the same field changes.
{
  "ids": [100, 101, 102],
  "apply": {
    "stock_status": "instock",
    "visibility": "catalog"
  }
}
Pass updates[] — an array where each entry pairs an id with its own change set. Use this when different items need different values.
{
  "updates": [
    { "id": 100, "regular_price": "29.99" },
    { "id": 101, "regular_price": "39.99", "stock_quantity": 25 }
  ]
}
Pass parent_id and an apply object. The ability resolves every variation of that parent and applies the changes to all of them.
{
  "parent_id": 123,
  "apply": {
    "stock_status": "instock"
  }
}
Deep semantics — atomicity, skip rules, and clearing behavior — are delivered in the ability’s rule body on the first call to maxi/bulk-update-products. Fetch the rule via maxi/get-ability-rule before your first write.