---
title: "Changes to Create experiment"
method: POST
path: "/application/{applicationId}/v2/experiments"
---

# Changes to Create experiment

`POST /application/{applicationId}/v2/experiments`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 21 revisions.

- **2026-10-13** `efdc00220d24`: 1 warning, 1 info
- **2026-10-09** `c00591dedd1f`: 2 info
- **2026-10-03** `e6cbc297dcb1`: 2 info
- **2026-09-26** `8541dcfed596`: 29 breaking, 2 warning, 24 info
- **2026-09-25** `6038ecabdc8b`: 2 info
- **2026-09-17** `f8001574e73e`: 1 info
- **2026-09-09** `0c183b82f696`: 1 warning

## Changes

- **2026-10-13** `efdc00220d24`: 1 warning, 1 info
  - added the new `pending` enum value to the `state` response property for the response status `201`
  - added the required property `cohorts` to the response with the `201` status
- **2026-10-09** `c00591dedd1f`: 2 info
  - added the new optional request property `exclusive`
  - added the required property `exclusive` to the response with the `201` status
- **2026-10-03** `e6cbc297dcb1`: 2 info
  - added the new optional request property `rollout`
  - added the required property `rollout` to the response with the `201` status
- **2026-09-26** `8541dcfed596`: 29 breaking, 2 warning, 24 info
  - added the new required request property `targeting/root`
  - added the new required request property `targeting/version`
  - added `subschema #1` to the `groups/items/changeset/operations/items/baseValue` request property `allOf` list
  - added `subschema #1` to the `groups/items/changeset/operations/items/value` request property `allOf` list
  - removed `subschema #1, subschema #2` from the `description` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `endsAt` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `groups/items/iconName` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `startsAt` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `targeting` request property `anyOf` list
  - the `groups/items/iconName` request property's minLength was increased from `0` to `1`
  - added the pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$` to the request property `endsAt`
  - added the pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$` to the request property `startsAt`
  - the `description` request property type changed from no type to `string, null`
  - the `endsAt` request property type changed from no type to `string, null`, and format from no format to `date-time`
  - the `groups/items/iconName` request property type changed from no type to `string, null`
  - the `startsAt` request property type changed from no type to `string, null`, and format from no format to `date-time`
  - the `targeting` request property type changed from no type to `object, null`
  - the response property `description` became nullable for the status `201`
  - the response property `endsAt` became nullable for the status `201`
  - the response property `groups/items/iconName` became nullable for the status `201`
  - the response property `targeting` became nullable for the status `201`
  - the response property `terminatedAt` became nullable for the status `201`
  - the response property `terminatedBy` became nullable for the status `201`
  - the `description` response's property type changed from no type to `string, null` for status `201`
  - the `endsAt` response's property type changed from no type to `string, null`, and format from no format to `date-time` for status `201`
  - the `groups/items/iconName` response's property type changed from no type to `string, null` for status `201`
  - the `targeting` response's property type changed from no type to `object, null` for status `201`
  - the `terminatedAt` response's property type changed from no type to `string, null`, and format from no format to `date-time` for status `201`
  - the `terminatedBy` response's property type changed from no type to `string, null`, and format from no format to `uuid` for status `201`
  - the `description` request property's maxLength was set to `10000`
  - the `groups/items/iconName` request property's maxLength was set to `255`
  - api operation id `createExperiment` was added
  - the endpoint scheme security `cookieAuth` was removed from the API
  - the request property `description` became nullable
  - the request property `endsAt` became nullable
  - the request property `groups/items/iconName` became nullable
  - the request property `startsAt` became nullable
  - the request property `targeting` became nullable
  - the `baseConfigurationId` request property's exclusiveMinimum was decreased from `true` to `0.00`
  - added `subschema #1` to the `groups/items/changeset/operations/items/baseValue` response property `allOf` list for the response status `201`
  - …15 more
- **2026-09-25** `6038ecabdc8b`: 2 info
  - the endpoint scheme security `cookieAuth` was added to the API
  - the endpoint scheme security `personalAccessTokenAuth` was added to the API
- **2026-09-17** `f8001574e73e`: 1 info
  - the `groups/items/weight` request property's max was increased from `9999.00` to `10000.00`
- **2026-09-09** `0c183b82f696`: 1 warning
  - removed the request property `access`

---

[Operation](https://skmtc.dev/gamebeast/apis/gamebeast-api/docs/application/:applicationId/v2/experiments/post.md) - [API](https://skmtc.dev/gamebeast/apis/gamebeast-api.md) - [Page](https://skmtc.dev/gamebeast/apis/gamebeast-api/changes/application/:applicationId/v2/experiments/post)