---
title: "Toggle feature preview"
method: POST
path: "/v2/feature-previews/{slug}/toggle"
tags: ["FeaturePreviews"]
---

# Toggle feature preview

`POST /v2/feature-previews/{slug}/toggle`

Toggles a single feature preview on/off for the current user and
 returns its new state.

## Path parameters

- `slug` string, required

## Request body

- ToggleFeaturePreviewRequest
  - `enabled` boolean — Desired enabled state.

## Response `200`

OK

- ToggleFeaturePreviewResponse
  - `preview` FeaturePreview
    - `slug` string — Stable identifier of the feature (e.g. "sidebar_v2").
    - `name` string — Human-readable name shown in the list.
    - `summary` string — Short one-line summary.
    - `description_markdown` string — Markdown body describing the feature.
    - `requires_refresh` boolean — Whether the page must be reloaded for the change to take effect.
    - `order` integer — Display order in the list.
    - `enabled` boolean — Whether the current user has this feature enabled.

---

[API](https://skmtc.net/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.net/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/orq-ai/orq-ai-api/versions/41c02aedc7c0/schema)