--- title: "Changes to Create a flag" method: PUT path: "/v1/projects/{projectIdOrName}/feature-flags/flags" --- # Changes to Create a flag `PUT /v1/projects/{projectIdOrName}/feature-flags/flags` > Every recorded change to this operation, newest first. ## Timeline Changed in 11 of 137 revisions. - **2026-10-15** `8939e3983223`: 1 info - **2026-09-30** `099fbe1f521c`: 4 info - **2026-09-15** `bc022fa59ffb`: 4 info - **2026-08-22** `3157f7f3ef33`: 2 breaking - **2026-08-20** `b4b4b597ab64`: 2 info - **2026-08-19** `6b6e0450635c`: 1 warning - **2026-08-18** `4a14567fe836`: 6 breaking, 16 warning, 7 info - **2026-07-27** `2b8120c6d584`: 1 info - **2026-07-26** `01c71864fa50`: 1 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 `201` status - **2026-09-30** `099fbe1f521c`: 4 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 `environments/additionalProperties/fallthrough/oneOf[subschema #3]/finalPromille` to the response with the `201` status - added the optional property `environments/additionalProperties/rules/items/outcome/oneOf[subschema #3]/finalPromille` to the response with the `201` status - **2026-09-15** `bc022fa59ffb`: 4 info - added the optional property `variants/items/description` to the response with the `201` status - added the optional property `variants/items/label` to the response with the `201` status - added the required property `variants/items/id` to the response with the `201` status - added the required property `variants/items/value` to the response with the `201` status - **2026-08-22** `3157f7f3ef33`: 2 breaking - added `subschema #4` to the `environments/additionalProperties/fallthrough` response property `oneOf` list for the response status `201` - added `subschema #4` to the `environments/additionalProperties/rules/items/outcome` response property `oneOf` list for the response status `201` - **2026-08-20** `b4b4b597ab64`: 2 info - removed `subschema #4` from the `environments/additionalProperties/fallthrough` response property `oneOf` list for the response status `201` - removed `subschema #4` from the `environments/additionalProperties/rules/items/outcome` response property `oneOf` list for the response status `201` - **2026-08-19** `6b6e0450635c`: 1 warning - removed the optional property `experiment` from the response with the `201` status - **2026-08-18** `4a14567fe836`: 6 breaking, 16 warning, 7 info - the response property `experiment` became nullable for the status `201` - added `subschema #4` to the `environments/additionalProperties/fallthrough` response property `oneOf` list for the response status `201` - added `subschema #4` to the `environments/additionalProperties/rules/items/outcome` response property `oneOf` list for the response status `201` - removed the required property `experiment/allocationUnit` from the response with the `201` status - removed the required property `experiment/primaryMetrics` from the response with the `201` status - removed the required property `experiment/status` from the response with the `201` status - removed the optional property `experiment/allocationPercent` from the response with the `201` status - removed the optional property `experiment/controlVariantId` from the response with the `201` status - removed the optional property `experiment/decision` from the response with the `201` status - removed the optional property `experiment/decisionReason` from the response with the `201` status - removed the optional property `experiment/device` from the response with the `201` status - removed the optional property `experiment/duration` from the response with the `201` status - removed the optional property `experiment/durationUnit` from the response with the `201` status - removed the optional property `experiment/endedAt` from the response with the `201` status - removed the optional property `experiment/guardrailMetrics` from the response with the `201` status - removed the optional property `experiment/hypothesis` from the response with the `201` status - removed the optional property `experiment/layer` from the response with the `201` status - removed the optional property `experiment/name` from the response with the `201` status - removed the optional property `experiment/numVariants` from the response with the `201` status - removed the optional property `experiment/startedAt` from the response with the `201` status - removed the optional property `experiment/stickyRequirement` from the response with the `201` status - removed the optional property `experiment/surfaceArea` from the response with the `201` status - added the optional property `experiment/rampId` to the response with the `201` status - added the optional property `experiment/rampPercentage` to the response with the `201` status - the response property `experiment/id` became required for the status `201` - added the required property `experiment/base` to the response with the `201` status - added the required property `experiment/defaultVariantId` to the response with the `201` status - added the required property `experiment/exposureLogging` to the response with the `201` status - added the required property `experiment/weights` to the response with the `201` status - **2026-07-27** `2b8120c6d584`: 1 info - removed the non-success response with the status `412` - **2026-07-26** `01c71864fa50`: 1 info - added the optional property `updatedBy` to the response with the `201` 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/put.md) - [API](https://skmtc.dev/vercel/apis/api.md) - [Page](https://skmtc.dev/vercel/apis/api/changes/v1/projects/:projectIdOrName/feature-flags/flags/put)