---
title: "Update a feature control status"
method: PUT
path: "/api/feature-control/status"
---

# Update a feature control status

`PUT /api/feature-control/status`

Updates the current status of a feature control for the current environment.

## Headers

- `x-cdp-request-id` string

## Request body

- PutFeatureControlStatusRequest
  - `name` string, required
  - `status` 'active' | 'withdrawn' | 'expired' | 'removed', required
  - `user` string, required
  - `note` string, required

## Response `202`

Accepted - Feature control status updated.

## Other responses

- `400` — Bad Request - Validation error (e.g., status not valid).
- `401` — Unauthorized.
- `404` — Not Found - Feature control does not exist.

## Changes

- **2026-08-19** `85983688c7e3` — 1 info
  - added the new `removed` enum value to the request property `status`
- **2026-08-13** `bc5f19084b41` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/defra/apis/grants-config-broker-api-2/changes/api/feature-control/status/put.md)

---

[API](https://skmtc.dev/defra/apis/grants-config-broker-api-2.md) · [All operations](https://skmtc.dev/defra/apis/grants-config-broker-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/defra/grants-config-broker-api-2/revisions/85983688c7e3/schema)