Skip to main content
POST /api/v2/storefront/operating-instructions/{version}/activate Sets your storefront’s active operating-instructions pointer to the given version, as this v2 endpoint has always done. To turn Playbook guidance into proposed seller Lessons, use V3 save_playbook; see Lessons. The only historical exception is a storefront that retained its enabled Lessons-pilot marker: during the deprecation window, this endpoint converts the selected version into proposed Lessons instead. It does not change the active pointer and returns activeUnchanged: true, lessonsProposed, and deprecated: true.

​
Request

​
Parameters

​
Response

Returns the newly-active OperatingInstructionsResponse with isActive: true. The previously-active version flips to isActive: false.

​
Errors

  • 400 VALIDATION_ERROR — the version is missing, belongs to another storefront, or repeats pricing, discount, market, or acceptance-policy facts owned by another surface.
  • 410 GONE — the historical enabled-pilot conversion window has ended for this storefront.
See Errors for the full error contract.

Create version

Author the version before activating it

Get active version

Confirm what is in force now

Operating instructions tasks

All operating-instructions operations

Operating instructions overview

Concepts and versioning model