Skip to main content
POST /api/v2/storefront/operating-instructions/{version}/activate Sets your storefront’s active operating-instructions pointer to the given version. Every subsequent composition consumes this version. Activating is idempotent — activating the already-active version is a no-op that returns the same row. You can re-activate any historical version this way.

​
Request

curl -X POST \
  "https://api.interchange.io/api/v2/storefront/operating-instructions/3/activate" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

FieldTypeRequiredNotes
versionintegerYesPath param — per-storefront version number to activate. Monotone, starts at 1, never reused

​
Response

{
  "id": "43",
  "storefrontId": "1234",
  "version": 3,
  "content": "# Merchandising rules\n\nLead with premium CTV inventory. Never surface remnant display to direct-response buyers.",
  "notes": "tighten brand-safety rules",
  "isActive": true,
  "createdAt": "2026-06-01T14:30:00Z",
  "createdBy": "5567"
}
Returns the newly-active OperatingInstructionsResponse with isActive: true. The previously-active version flips to isActive: false.

​
Errors

  • 400 VALIDATION_ERROR — no version with that number exists for your storefront, or the version does not belong to 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