Playbook

Tell your storefront agent how to pitch, package and price, including the floors it may never cross.

The playbook is your selling doctrine: how the storefront agent should talk about your inventory, how it packages products together, and how it prices. It has two parts.

Operating instructions

Markdown in your own words: what to lead with, which products pair well, which buyers to prioritize, what never to promise. Each save creates a new version and activates it; history is kept and older versions can be reactivated from the page. Over REST, POST /api/v2/storefront/operating-instructions creates an inactive version unless you send activate: true; activate it later with POST /operating-instructions/{version}/activate.

Pricing facts

Each pricing fact has a label, a plain-language condition for when it applies, a price, and a strength:

Strength	What the agent does with it
default	The anchor price it starts from.
hard_floor	Never priced below. This is enforced, not advice.
guidance	Advisory context it may cite, such as seasonal demand.

A targetPercentile (p50, p75 or p90) tells the agent where to aim within market guidance. House discounts give a fixed percentage off to a buyer’s brand or operator domain.

For example, a playbook might anchor premium video at a $32 CPM with a$24 hard floor, anchor display at $8 with a$6 floor, and say in its instructions that package discounts never exceed 15%.

Saving

save_playbook

{
  "content": "Lead with premium CTV for brand campaigns. Pair CTV with streaming audio for reach. Never promise exact age targeting below 25.",
  "notes": "Holiday season update"
}

Open the page with “Show me my playbook” or open_page (page: "playbook"). Changes apply to the next brief; proposals already sent keep the version they were composed under.

Merchandising

Which fact lives where, and why.

The storefront agent

How the playbook shapes each answer.