--- title: "Changes to Update a flag" method: PATCH path: "/v1/projects/{projectIdOrName}/feature-flags/flags/{flagIdOrSlug}" --- # Changes to Update a flag `PATCH /v1/projects/{projectIdOrName}/feature-flags/flags/{flagIdOrSlug}` > Every recorded change to this operation, newest first. ## Timeline Changed in 12 of 137 revisions. - **2026-10-15** `8939e3983223`: 1 info - **2026-10-08** `f5c63f03ee0c`: 1 breaking, 20 info - **2026-09-30** `099fbe1f521c`: 6 info - **2026-09-15** `bc022fa59ffb`: 8 info - **2026-08-22** `3157f7f3ef33`: 4 breaking - **2026-08-20** `b4b4b597ab64`: 4 info - **2026-08-19** `6b6e0450635c`: 2 warning - **2026-08-18** `4a14567fe836`: 12 breaking, 32 warning, 14 info - **2026-07-27** `2b8120c6d584`: 1 info - **2026-07-26** `01c71864fa50`: 2 info - **2026-07-21** `2ae10ee9d21c`: 1 info - **2026-06-11** `14b4658f819e`: 1 info ## Changes - **2026-10-15** `8939e3983223`: 1 info - added the optional property `seenInProduction` to the response with the `200` status - **2026-10-08** `f5c63f03ee0c`: 1 breaking, 20 info - the response's body type changed from no type to `object` for status `200` - removed `#/components/schemas/Flag, subschema #1` from the response body `oneOf` list for the response status `200` - added the optional property `description` to the response with the `200` status - added the optional property `maintainerIds` to the response with the `200` status - added the optional property `permanent` to the response with the `200` status - added the optional property `tags` to the response with the `200` status - added the optional property `updatedBy` to the response with the `200` status - added the required property `createdAt` to the response with the `200` status - added the required property `createdBy` to the response with the `200` status - added the required property `environments` to the response with the `200` status - added the required property `id` to the response with the `200` status - added the required property `kind` to the response with the `200` status - added the required property `ownerId` to the response with the `200` status - added the required property `projectId` to the response with the `200` status - added the required property `revision` to the response with the `200` status - added the required property `seed` to the response with the `200` status - added the required property `slug` to the response with the `200` status - added the required property `state` to the response with the `200` status - added the required property `typeName` to the response with the `200` status - added the required property `updatedAt` to the response with the `200` status - added the required property `variants` to the response with the `200` status - **2026-09-30** `099fbe1f521c`: 6 info - added the new optional request property `environments/additionalProperties/fallthrough/anyOf[subschema #3]/finalPromille` - added the new optional request property `environments/additionalProperties/rules/items/outcome/anyOf[subschema #3]/finalPromille` - added the optional property `oneOf[#/components/schemas/Flag]/environments/additionalProperties/fallthrough/oneOf[subschema #3]/finalPromille` to the response with the `200` status - added the optional property `oneOf[#/components/schemas/Flag]/environments/additionalProperties/rules/items/outcome/oneOf[subschema #3]/finalPromille` to the response with the `200` status - added the optional property `oneOf[subschema #1]/environments/additionalProperties/fallthrough/oneOf[subschema #3]/finalPromille` to the response with the `200` status - added the optional property `oneOf[subschema #1]/environments/additionalProperties/rules/items/outcome/oneOf[subschema #3]/finalPromille` to the response with the `200` status - **2026-09-15** `bc022fa59ffb`: 8 info - added the optional property `oneOf[#/components/schemas/Flag]/variants/items/description` to the response with the `200` status - added the optional property `oneOf[#/components/schemas/Flag]/variants/items/label` to the response with the `200` status - added the optional property `oneOf[subschema #1]/variants/items/description` to the response with the `200` status - added the optional property `oneOf[subschema #1]/variants/items/label` to the response with the `200` status - added the required property `oneOf[#/components/schemas/Flag]/variants/items/id` to the response with the `200` status - added the required property `oneOf[#/components/schemas/Flag]/variants/items/value` to the response with the `200` status - added the required property `oneOf[subschema #1]/variants/items/id` to the response with the `200` status - added the required property `oneOf[subschema #1]/variants/items/value` to the response with the `200` status - **2026-08-22** `3157f7f3ef33`: 4 breaking - added `subschema #4` to the `oneOf[#/components/schemas/Flag]/environments/additionalProperties/fallthrough` response property `oneOf` list for the response status `200` - added `subschema #4` to the `oneOf[#/components/schemas/Flag]/environments/additionalProperties/rules/items/outcome` response property `oneOf` list for the response status `200` - added `subschema #4` to the `oneOf[subschema #1]/environments/additionalProperties/fallthrough` response property `oneOf` list for the response status `200` - added `subschema #4` to the `oneOf[subschema #1]/environments/additionalProperties/rules/items/outcome` response property `oneOf` list for the response status `200` - **2026-08-20** `b4b4b597ab64`: 4 info - removed `subschema #4` from the `oneOf[#/components/schemas/Flag]/environments/additionalProperties/fallthrough` response property `oneOf` list for the response status `200` - removed `subschema #4` from the `oneOf[#/components/schemas/Flag]/environments/additionalProperties/rules/items/outcome` response property `oneOf` list for the response status `200` - removed `subschema #4` from the `oneOf[subschema #1]/environments/additionalProperties/fallthrough` response property `oneOf` list for the response status `200` - removed `subschema #4` from the `oneOf[subschema #1]/environments/additionalProperties/rules/items/outcome` response property `oneOf` list for the response status `200` - **2026-08-19** `6b6e0450635c`: 2 warning - removed the optional property `oneOf[#/components/schemas/Flag]/experiment` from the response with the `200` status - removed the optional property `oneOf[subschema #1]/experiment` from the response with the `200` status - **2026-08-18** `4a14567fe836`: 12 breaking, 32 warning, 14 info - the response property `oneOf[#/components/schemas/Flag]/experiment` became nullable for the status `200` - the response property `oneOf[subschema #1]/experiment` became nullable for the status `200` - added `subschema #4` to the `oneOf[#/components/schemas/Flag]/environments/additionalProperties/fallthrough` response property `oneOf` list for the response status `200` - added `subschema #4` to the `oneOf[#/components/schemas/Flag]/environments/additionalProperties/rules/items/outcome` response property `oneOf` list for the response status `200` - added `subschema #4` to the `oneOf[subschema #1]/environments/additionalProperties/fallthrough` response property `oneOf` list for the response status `200` - added `subschema #4` to the `oneOf[subschema #1]/environments/additionalProperties/rules/items/outcome` response property `oneOf` list for the response status `200` - removed the required property `oneOf[#/components/schemas/Flag]/experiment/allocationUnit` from the response with the `200` status - removed the required property `oneOf[#/components/schemas/Flag]/experiment/primaryMetrics` from the response with the `200` status - removed the required property `oneOf[#/components/schemas/Flag]/experiment/status` from the response with the `200` status - removed the required property `oneOf[subschema #1]/experiment/allocationUnit` from the response with the `200` status - removed the required property `oneOf[subschema #1]/experiment/primaryMetrics` from the response with the `200` status - removed the required property `oneOf[subschema #1]/experiment/status` from the response with the `200` status - removed the optional property `oneOf[#/components/schemas/Flag]/experiment/allocationPercent` from the response with the `200` status - removed the optional property `oneOf[#/components/schemas/Flag]/experiment/controlVariantId` from the response with the `200` status - removed the optional property `oneOf[#/components/schemas/Flag]/experiment/decision` from the response with the `200` status - removed the optional property `oneOf[#/components/schemas/Flag]/experiment/decisionReason` from the response with the `200` status - removed the optional property `oneOf[#/components/schemas/Flag]/experiment/device` from the response with the `200` status - removed the optional property `oneOf[#/components/schemas/Flag]/experiment/duration` from the response with the `200` status - removed the optional property `oneOf[#/components/schemas/Flag]/experiment/durationUnit` from the response with the `200` status - removed the optional property `oneOf[#/components/schemas/Flag]/experiment/endedAt` from the response with the `200` status - removed the optional property `oneOf[#/components/schemas/Flag]/experiment/guardrailMetrics` from the response with the `200` status - removed the optional property `oneOf[#/components/schemas/Flag]/experiment/hypothesis` from the response with the `200` status - removed the optional property `oneOf[#/components/schemas/Flag]/experiment/layer` from the response with the `200` status - removed the optional property `oneOf[#/components/schemas/Flag]/experiment/name` from the response with the `200` status - removed the optional property `oneOf[#/components/schemas/Flag]/experiment/numVariants` from the response with the `200` status - removed the optional property `oneOf[#/components/schemas/Flag]/experiment/startedAt` from the response with the `200` status - removed the optional property `oneOf[#/components/schemas/Flag]/experiment/stickyRequirement` from the response with the `200` status - removed the optional property `oneOf[#/components/schemas/Flag]/experiment/surfaceArea` from the response with the `200` status - removed the optional property `oneOf[subschema #1]/experiment/allocationPercent` from the response with the `200` status - removed the optional property `oneOf[subschema #1]/experiment/controlVariantId` from the response with the `200` status - removed the optional property `oneOf[subschema #1]/experiment/decision` from the response with the `200` status - removed the optional property `oneOf[subschema #1]/experiment/decisionReason` from the response with the `200` status - removed the optional property `oneOf[subschema #1]/experiment/device` from the response with the `200` status - removed the optional property `oneOf[subschema #1]/experiment/duration` from the response with the `200` status - removed the optional property `oneOf[subschema #1]/experiment/durationUnit` from the response with the `200` status - removed the optional property `oneOf[subschema #1]/experiment/endedAt` from the response with the `200` status - removed the optional property `oneOf[subschema #1]/experiment/guardrailMetrics` from the response with the `200` status - removed the optional property `oneOf[subschema #1]/experiment/hypothesis` from the response with the `200` status - removed the optional property `oneOf[subschema #1]/experiment/layer` from the response with the `200` status - removed the optional property `oneOf[subschema #1]/experiment/name` from the response with the `200` status - …18 more - **2026-07-27** `2b8120c6d584`: 1 info - removed the non-success response with the status `412` - **2026-07-26** `01c71864fa50`: 2 info - added the optional property `oneOf[#/components/schemas/Flag]/updatedBy` to the response with the `200` status - added the optional property `oneOf[subschema #1]/updatedBy` to the response with the `200` status - **2026-07-21** `2ae10ee9d21c`: 1 info - added the non-success response with the status `410` - **2026-06-11** `14b4658f819e`: 1 info - endpoint added --- [Operation](https://skmtc.dev/vercel/apis/api/docs/v1/projects/:projectIdOrName/feature-flags/flags/:flagIdOrSlug/patch.md) - [API](https://skmtc.dev/vercel/apis/api.md) - [Page](https://skmtc.dev/vercel/apis/api/changes/v1/projects/:projectIdOrName/feature-flags/flags/:flagIdOrSlug/patch)