Inventory Manager API · catalogs

Choose how this catalog is priced

PUT /catalogs/{catalogId}/pricing

manual (the default): every price is a fact a person set. auto: derive a price for every SKU its base prices — { _tag: catalog, catalogId }, another catalog's stored rows (every SKU that catalog prices), or { _tag: cost }, the SKU's cost basis in the home currency (GET /items/:sku/cost; every SKU this catalog lists that has one) — converted at the recorded forex rate for the current hour when the currencies differ (PUT /fx/rates), stepped by the optional adjustment (markup, margin or discount, in basis points: cost + 40 % is markup 4000, a 40 % margin is margin 4000, less 10 % is discount 1000) and rounded up by the optional rounding table (bands by fromCents, each to the next figure ending in endingCents modulo stepCents). A base row's quantity breaks are derived the same way. Derived prices are served marked auto on every read and never stored; a price set by hand stands as an override until removed; with no rate for the pair only the manual rows are served. channel: the channel publishing this catalog prices it itself — manifold derives nothing, and hand-set rows are the fixed-price overrides a sync lays over its prices. 409 CatalogPricingInvalid for a base that is this catalog, missing, archived, or itself auto (derivation is one hop). Appends inventory.catalog-pricing-configured. Idempotent by content: a retry that changes nothing is acknowledged and appends nothing.

Access

Requires catalogs:write.

How scopes come from roles: Scopes and roles. Getting a token: Authentication and app tokens.

Retries

Idempotent by content: a retry that changes nothing is acknowledged and appends nothing.

Why every write carries a key: Idempotency and retries.

Facts appended

• inventory.catalog-pricing-configured

What a fact is: Facts and the journal.

AI agent tool

Agents call this as catalog_configure_pricing (Catalog: Configure pricing), in the pricing toolset.

Connecting an agent: AI agents.

Example

Price wholesale at 30 % off retail before GST, rounded up to the next 95 cents.

curl -X PUT 'https://inventory.getmanifold.io/catalogs/cat_019e394f-ed80-7da2-823a-3ff13eb84f30/pricing' \
  -H "Authorization: Bearer $MANIFOLD_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "_tag": "auto",
  "base": {
    "_tag": "catalog",
    "catalogId": "cat_019cadd3-8524-7934-9ee3-29b896f71f80"
  },
  "adjustment": {
    "_tag": "discount",
    "basisPoints": 3000
  },
  "rounding": [
    {
      "fromCents": 0,
      "stepCents": 100,
      "endingCents": 95
    }
  ]
}'

const response = await fetch("https://inventory.getmanifold.io/catalogs/cat_019e394f-ed80-7da2-823a-3ff13eb84f30/pricing", {
  method: "PUT",
  headers: { Authorization: `Bearer ${process.env.MANIFOLD_TOKEN}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "_tag": "auto",
    "base": {
      "_tag": "catalog",
      "catalogId": "cat_019cadd3-8524-7934-9ee3-29b896f71f80"
    },
    "adjustment": {
      "_tag": "discount",
      "basisPoints": 3000
    },
    "rounding": [
      {
        "fromCents": 0,
        "stepCents": 100,
        "endingCents": 95
      }
    ]
  }),
});
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
const answer = await response.json();

{
  "_tag": "auto",
  "base": {
    "_tag": "catalog",
    "catalogId": "cat_019cadd3-8524-7934-9ee3-29b896f71f80"
  },
  "adjustment": {
    "_tag": "discount",
    "basisPoints": 3000
  },
  "rounding": [
    {
      "fromCents": 0,
      "stepCents": 100,
      "endingCents": 95
    }
  ]
}

{
  "id": "cat_019e394f-ed80-7da2-823a-3ff13eb84f30",
  "name": "Wholesale",
  "currency": "AUD",
  "status": "active",
  "productCount": 2,
  "priceCount": 0,
  "pricing": {
    "_tag": "auto",
    "base": {
      "_tag": "catalog",
      "catalogId": "cat_019cadd3-8524-7934-9ee3-29b896f71f80"
    },
    "adjustment": {
      "_tag": "discount",
      "basisPoints": 3000
    },
    "rounding": [
      {
        "fromCents": 0,
        "stepCents": 100,
        "endingCents": 95
      }
    ]
  },
  "taxInclusive": "exclusive",
  "createdAt": "2026-05-18T04:20:00.000Z",
  "updatedAt": "2026-05-18T04:31:45.000Z"
}

The panel writes this call in other languages. It does not send it: Manifold's APIs do not take calls from a web page on another site, so run the call from your own code or terminal. The whole API as OpenAPI: inventory-manager.openapi.json. Base URL https://inventory.getmanifold.io.

Errors

Every refusal is a status and a JSON body whose _tag names it. A refused call changes nothing.

401

402

403

404

409

503

How refusals work everywhere: Errors.

Used in

• Curate a channel catalog, step 10: Put the US catalog on auto pricing
• Curate a channel catalog, step 16: Hold it to a 60 % margin, ending in .99