---
title: "Update Feature Toggle"
method: PATCH
path: "/api/v1/internal/workspaces/{workspace_id}/feature-toggles"
tags: ["internal", "workspaces"]
---

# Update Feature Toggle

`PATCH /api/v1/internal/workspaces/{workspace_id}/feature-toggles`

Set one per-workspace override. Admin-only, audit-logged.
An unregistered key is rejected with 422.

## Path parameters

- `workspace_id` string, uuid, required

## Request body

- FeatureToggleUpdateRequest — Request to flip a single feature toggle for a workspace.
  - `key` string, required
  - `enabled` boolean, required

## Response `200`

Successful Response

- FeatureTogglesResponse — All governable feature toggles for a workspace (registry + overrides).
  - `toggles` FeatureToggleItem[], required
    - `key` string, required
    - `label` string, required
    - `description` string, required
    - `enabled` boolean, required
    - `is_override` boolean, required
    - `global_default` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/maia-analytics/apis/maia-api.md) · [All operations](https://skmtc.dev/maia-analytics/apis/maia-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/maia-analytics/maia-api/revisions/0c94a4b5a00e/schema)