> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Create version

> Author a new operating-instructions version for your storefront

`POST /api/v2/storefront/operating-instructions`

Authors a new operating-instructions version. The version number is computed atomically as the current maximum plus one for your storefront. This does **not** auto-activate — the new version sits in history until you [activate](/v2/storefront/operating-instructions/tasks/activate-version) it. Versions are immutable; to change the rules, create another version.

## Request

```bash theme={null}
curl -X POST https://api.interchange.io/api/v2/storefront/operating-instructions \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "# Merchandising rules\n\nLead with premium CTV inventory. Package run-of-network display as a single value option. Explain why each selected product fits the brief.",
    "notes": "clarify product packaging"
  }'
```

## Parameters

| Field     | Type   | Required | Notes                                                                                                                                                                                                                                                                                                         |
| --------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `content` | string | Yes      | Markdown product-packaging, naming, selection, and explanation rules, 1–50000 chars. Actual prices/floors/currencies belong in Selling Terms; brand/operator discounts in Buyer Discounts and Buyer Instructions; markets in Business Profile; advertiser/category/creative eligibility in Acceptance Policy. |
| `notes`   | string | No       | Operator note describing why this version was created. Not surfaced to buyers; visible in version history. Max 2000 chars                                                                                                                                                                                     |

## Response

```json theme={null}
{
  "id": "43",
  "storefrontId": "1234",
  "version": 3,
  "content": "# Merchandising rules\n\nLead with premium CTV inventory. Package run-of-network display as a single value option. Explain why each selected product fits the brief.",
  "notes": "clarify product packaging",
  "isActive": false,
  "createdAt": "2026-06-01T14:30:00Z",
  "createdBy": "5567",
  "ownershipIssues": []
}
```

Returns `201` with the new version. `version` is assigned by the platform — never supplied by the caller. `isActive` is `false` until you activate it. `createdBy` is the authoring operator's user id, or `null` when authored by a service token.

## Errors

* `400 VALIDATION_ERROR` — missing/oversized `content`, or the rules duplicate pricing, discount, market, or acceptance-policy facts owned by another surface.

See [Errors](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="Activate version" href="/v2/storefront/operating-instructions/tasks/activate-version" icon="toggle-on">
    Make this version the active one
  </Card>

  <Card title="List versions" href="/v2/storefront/operating-instructions/tasks/list-versions" icon="list">
    See all versions, newest first
  </Card>

  <Card title="Operating instructions tasks" href="/v2/storefront/operating-instructions/tasks" icon="list-check">
    All operating-instructions operations
  </Card>

  <Card title="Operating instructions overview" href="/v2/storefront/operating-instructions/overview" icon="scroll">
    Concepts and versioning model
  </Card>
</CardGroup>