> ## 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.

# Activate version

> Set your storefront's active operating-instructions version

`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, including for a legacy active version whose runtime copy is already sanitized. An inactive legacy version with a non-empty `ownershipIssues` list must be cleaned up into a new version instead of reactivated.

## Request

```bash theme={null}
curl -X POST \
  "https://api.interchange.io/api/v2/storefront/operating-instructions/3/activate" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"
```

## Parameters

| Field     | Type    | Required | Notes                                                                                       |
| --------- | ------- | -------- | ------------------------------------------------------------------------------------------- |
| `version` | integer | Yes      | Path param — per-storefront version number to activate. Monotone, starts at 1, never reused |

## Response

```json theme={null}
{
  "id": "43",
  "storefrontId": "1234",
  "version": 3,
  "content": "# Merchandising rules\n\nLead with premium CTV inventory. Never surface remnant display to direct-response buyers.",
  "notes": "clarify product packaging",
  "isActive": true,
  "createdAt": "2026-06-01T14:30:00Z",
  "createdBy": "5567",
  "ownershipIssues": []
}
```

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.

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

## Related

<CardGroup cols={2}>
  <Card title="Create version" href="/v2/storefront/operating-instructions/tasks/create-version" icon="plus">
    Author the version before activating it
  </Card>

  <Card title="Get active version" href="/v2/storefront/operating-instructions/tasks/get-active" icon="circle-check">
    Confirm what is in force now
  </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>