---
title: "Set Global Feature Default"
method: PATCH
path: "/api/v1/internal/feature-flags/{key}/default"
tags: ["internal", "feature-flags"]
---

# Set Global Feature Default

`PATCH /api/v1/internal/feature-flags/{key}/default`

Set the platform-wide default for one feature. Internal admin only.

Returns the refreshed flag list so the client reflects the new default
without a second round-trip.

## Path parameters

- `key` string, required

## Request body

- SetGlobalFlagDefaultRequest — Request to set the platform-wide default for one feature toggle.
  - `enabled` boolean, required

## Response `200`

Successful Response

- GlobalFeatureFlagsResponse — Every registered feature toggle with its global default + override count.
  - `flags` GlobalFeatureFlagItem[], required
    - `key` string, required
    - `label` string, required
    - `description` string, required
    - `global_default` boolean, required
    - `override_count` integer, required

## Other responses

- `422` — Validation Error

---

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