---
title: "Changes to List flag versions"
method: GET
path: "/v1/projects/{projectIdOrName}/feature-flags/flags/{flagIdOrSlug}/versions"
---

# Changes to List flag versions

`GET /v1/projects/{projectIdOrName}/feature-flags/flags/{flagIdOrSlug}/versions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 137 revisions.

- **2026-09-30** `099fbe1f521c`: 2 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-21** `2ae10ee9d21c`: 1 info
- **2026-06-11** `14b4658f819e`: 1 info

## Changes

- **2026-09-30** `099fbe1f521c`: 2 info
  - added the optional property `versions/items/data/environments/additionalProperties/fallthrough/oneOf[subschema #3]/finalPromille` to the response with the `200` status
  - added the optional property `versions/items/data/environments/additionalProperties/rules/items/outcome/oneOf[subschema #3]/finalPromille` to the response with the `200` status
- **2026-09-15** `bc022fa59ffb`: 4 info
  - added the optional property `versions/items/data/variants/items/description` to the response with the `200` status
  - added the optional property `versions/items/data/variants/items/label` to the response with the `200` status
  - added the required property `versions/items/data/variants/items/id` to the response with the `200` status
  - added the required property `versions/items/data/variants/items/value` to the response with the `200` status
- **2026-08-22** `3157f7f3ef33`: 2 breaking
  - added `subschema #4` to the `versions/items/data/environments/additionalProperties/fallthrough` response property `oneOf` list for the response status `200`
  - added `subschema #4` to the `versions/items/data/environments/additionalProperties/rules/items/outcome` response property `oneOf` list for the response status `200`
- **2026-08-20** `b4b4b597ab64`: 2 info
  - removed `subschema #4` from the `versions/items/data/environments/additionalProperties/fallthrough` response property `oneOf` list for the response status `200`
  - removed `subschema #4` from the `versions/items/data/environments/additionalProperties/rules/items/outcome` response property `oneOf` list for the response status `200`
- **2026-08-19** `6b6e0450635c`: 1 warning
  - removed the optional property `versions/items/data/experiment` from the response with the `200` status
- **2026-08-18** `4a14567fe836`: 6 breaking, 16 warning, 7 info
  - the response property `versions/items/data/experiment` became nullable for the status `200`
  - added `subschema #4` to the `versions/items/data/environments/additionalProperties/fallthrough` response property `oneOf` list for the response status `200`
  - added `subschema #4` to the `versions/items/data/environments/additionalProperties/rules/items/outcome` response property `oneOf` list for the response status `200`
  - removed the required property `versions/items/data/experiment/allocationUnit` from the response with the `200` status
  - removed the required property `versions/items/data/experiment/primaryMetrics` from the response with the `200` status
  - removed the required property `versions/items/data/experiment/status` from the response with the `200` status
  - removed the optional property `versions/items/data/experiment/allocationPercent` from the response with the `200` status
  - removed the optional property `versions/items/data/experiment/controlVariantId` from the response with the `200` status
  - removed the optional property `versions/items/data/experiment/decision` from the response with the `200` status
  - removed the optional property `versions/items/data/experiment/decisionReason` from the response with the `200` status
  - removed the optional property `versions/items/data/experiment/device` from the response with the `200` status
  - removed the optional property `versions/items/data/experiment/duration` from the response with the `200` status
  - removed the optional property `versions/items/data/experiment/durationUnit` from the response with the `200` status
  - removed the optional property `versions/items/data/experiment/endedAt` from the response with the `200` status
  - removed the optional property `versions/items/data/experiment/guardrailMetrics` from the response with the `200` status
  - removed the optional property `versions/items/data/experiment/hypothesis` from the response with the `200` status
  - removed the optional property `versions/items/data/experiment/layer` from the response with the `200` status
  - removed the optional property `versions/items/data/experiment/name` from the response with the `200` status
  - removed the optional property `versions/items/data/experiment/numVariants` from the response with the `200` status
  - removed the optional property `versions/items/data/experiment/startedAt` from the response with the `200` status
  - removed the optional property `versions/items/data/experiment/stickyRequirement` from the response with the `200` status
  - removed the optional property `versions/items/data/experiment/surfaceArea` from the response with the `200` status
  - added the optional property `versions/items/data/experiment/rampId` to the response with the `200` status
  - added the optional property `versions/items/data/experiment/rampPercentage` to the response with the `200` status
  - the response property `versions/items/data/experiment/id` became required for the status `200`
  - added the required property `versions/items/data/experiment/base` to the response with the `200` status
  - added the required property `versions/items/data/experiment/defaultVariantId` to the response with the `200` status
  - added the required property `versions/items/data/experiment/exposureLogging` to the response with the `200` status
  - added the required property `versions/items/data/experiment/weights` 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/versions/get.md) - [API](https://skmtc.dev/vercel/apis/api.md) - [Page](https://skmtc.dev/vercel/apis/api/changes/v1/projects/:projectIdOrName/feature-flags/flags/:flagIdOrSlug/versions/get)