Skip to main content
POST /api/v2/storefront/operating-instructions Authors and activates a new operating-instructions 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, the request creates proposed Lessons instead, leaves the active version unchanged, and returns activeUnchanged: true, lessonsProposed, and deprecated: true. After that window, this historical conversion returns 410 Gone; historical reads continue to work.

Request

Parameters

Response

Returns 201 with the new active version. For the historical enabled-pilot exception, the conversion returns proposed Lesson identities instead and does not activate or replace Playbook prose. Use V3 save_playbook for the supported Lesson-conversion workflow; see Lessons.

Errors

  • 400 VALIDATION_ERROR — missing/oversized content, or the rules duplicate 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.

Activate version

Make this version the active one

Operating instructions tasks

All operating-instructions operations

Operating instructions overview

Concepts and versioning model