Skip to main content
GET /api/v2/storefront/operating-instructions Returns all operating-instructions versions for your storefront, newest first. The active version (if any) is flagged with isActive: true on its row. Use this to render version history or find the number to re-activate.

​
Request

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

​
Parameters

This endpoint takes no parameters.

​
Response

[
  {
    "id": "43",
    "storefrontId": "1234",
    "version": 3,
    "content": "# Merchandising rules\n\nLead with premium CTV. Never surface remnant display to holding-company buyers.",
    "notes": "tighten brand-safety rules",
    "isActive": true,
    "createdAt": "2026-06-01T14:30:00Z",
    "createdBy": "5567"
  },
  {
    "id": "31",
    "storefrontId": "1234",
    "version": 2,
    "content": "# Merchandising rules\n\nLead with premium CTV.",
    "notes": null,
    "isActive": false,
    "createdAt": "2026-05-12T09:05:00Z",
    "createdBy": "5567"
  }
]
Returns an array of OperatingInstructionsResponse objects, newest version first. At most one item has isActive: true; when no version has been activated yet, every row reports isActive: false.

​
Errors

  • 400 VALIDATION_ERROR — malformed request.
See Errors for the full error contract.

Operating instructions tasks

All operating-instructions operations

Get active version

Just the version in force now

Create version

Author a new version

Operating instructions overview

Concepts and versioning model