Version: 1.9.0

Mocart API

The Mocart public API. Every endpoint requires Authorization: Bearer mcf_…. The Read API (/products, /creatives, /assets, /campaigns, /deliveries) needs the read scope; the Create API (/runs) orders creatives — runs:read to price and poll, runs:write to create and stop, which spends credits; /upscales re-renders an image at 2K or 4K on the same two scopes. Keys are minted in Settings → API keys.

Glossary: productId vs sku

• productId — the Mocart product document id. A STABLE identity that is ALWAYS present and unique. This is the recommended join key.
• sku — the merchant stock-keeping number, sourced from core.mpn (manufacturer part number). MAY be null when the merchant left it empty, and is NOT guaranteed unique across products.

When sku is null (or shared by multiple products), join on productId. GET /products?sku= returns a LIST (a SKU is non-unique), so use GET /products/{id} — keyed on productId — for an unambiguous single-product lookup.

Authentication

HTTP: Bearer Auth

Security Scheme Type:	http
HTTP Authorization Scheme:	bearer