/api/products* endpoints — see the API reference under the Products group for full request / response shapes.
Mutations fire the same per-order COGS recalculation as the web UI.
Subcommands
search
Search products by title / SKU / variant. Cursor-paginated.--page-size accepts 1–100 (default 20). Pass the nextCursor from the response into --cursor to page.
Required scope: costs:read.
cost
Show the resolved cost breakdown for a single variant — the per-unit effective cost, handling fee, and which configuration tier supplied it (per-variant COG line, global override, or default fallback).costs:read.
handling-fee set
Set the per-variant handling fee, charged on every unit sold. Must be>= 0. Setting it replaces the global default handling fee for this variant — use 0 to charge no handling fee.
costs:write.
cogs add
Append a new COG line to a variant’s manual cost history. The server assigns a ULID for the new line.--end is optional — omit for an open-ended interval.
Required scope: costs:write.
cogs update
Update an existing COG line by its server-assigned ID. Pass any combination of--cost, --start, --end, --description. Use --end null to clear an end date (make the line open-ended).
costs:write.
cogs delete
Delete a COG line by its ID. The CLI prompts for confirmation;--yes (or -y) skips it.
costs:write.