---
title: "POST /api/v1/environments/{environment_api_key}/create-change-request/"
method: POST
path: "/api/v1/environments/{environment_api_key}/create-change-request/"
tags: ["mcp"]
---

# POST /api/v1/environments/{environment_api_key}/create-change-request/

`POST /api/v1/environments/{environment_api_key}/create-change-request/`

Creates a new change request for feature flag modifications in an environment.

## Path parameters

- `environment_api_key` string, required

## Request body

- ChangeRequestCreate — Adds nested create feature
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `title` string, required
  - `description` string, nullable
  - `feature_states` CreateChangeRequestFeatureState[], required
    - `id` integer
    - `feature` integer, required
    - `feature_segment` integer, nullable
    - `enabled` boolean
    - `feature_state_value` FeatureStateValue
      - `type` union
        - 'int' | 'unicode' | 'bool' — * `int` - Integer * `unicode` - String * `bool` - Boolean
        - ''
        - unknown
      - `string_value` string, nullable
      - `integer_value` integer, nullable
      - `boolean_value` boolean, nullable
    - `multivariate_feature_state_values` MultivariateFeatureStateValue[]
      - `id` integer
      - `multivariate_feature_option` integer, required
      - `percentage_allocation` number, double, required
    - `live_from` string, date-time, nullable
  - `deleted_at` string, date-time, nullable
  - `environment` integer, nullable
  - `committed_at` string, date-time, nullable
  - `approvals` ChangeRequestApproval[]
    - `id` integer
    - `user` integer, required
    - `approved_at` string, date-time, nullable
  - `user` integer, nullable
  - `committed_by` integer, nullable
  - `group_assignments` ChangeRequestGroupAssignment[]
    - `group` integer, required
  - `environment_feature_versions` string[]
  - `change_sets` VersionChangeSet[], nullable
    - `id` integer
    - `feature` integer, required
    - `live_from` string, date-time, nullable
    - `feature_states_to_update` unknown[], required — List of feature states to update as part of this change.
      - unknown
    - `feature_states_to_create` unknown[], required — List of feature states to create as part of this change.
      - unknown
    - `segment_ids_to_delete_overrides` integer[], required — List of segment IDs for which the overrides should be deleted as part of this change.
  - `ignore_conflicts` boolean

## Response `201`

- ChangeRequestCreate — Adds nested create feature
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `title` string, required
  - `description` string, nullable
  - `feature_states` CreateChangeRequestFeatureState[], required
    - `id` integer
    - `feature` integer, required
    - `feature_segment` integer, nullable
    - `enabled` boolean
    - `feature_state_value` FeatureStateValue
      - `type` union
        - 'int' | 'unicode' | 'bool' — * `int` - Integer * `unicode` - String * `bool` - Boolean
        - ''
        - unknown
      - `string_value` string, nullable
      - `integer_value` integer, nullable
      - `boolean_value` boolean, nullable
    - `multivariate_feature_state_values` MultivariateFeatureStateValue[]
      - `id` integer
      - `multivariate_feature_option` integer, required
      - `percentage_allocation` number, double, required
    - `live_from` string, date-time, nullable
  - `deleted_at` string, date-time, nullable
  - `environment` integer, nullable
  - `committed_at` string, date-time, nullable
  - `approvals` ChangeRequestApproval[]
    - `id` integer
    - `user` integer, required
    - `approved_at` string, date-time, nullable
  - `user` integer, nullable
  - `committed_by` integer, nullable
  - `group_assignments` ChangeRequestGroupAssignment[]
    - `group` integer, required
  - `environment_feature_versions` string[]
  - `change_sets` VersionChangeSet[], nullable
    - `id` integer
    - `feature` integer, required
    - `live_from` string, date-time, nullable
    - `feature_states_to_update` unknown[], required — List of feature states to update as part of this change.
      - unknown
    - `feature_states_to_create` unknown[], required — List of feature states to create as part of this change.
      - unknown
    - `segment_ids_to_delete_overrides` integer[], required — List of segment IDs for which the overrides should be deleted as part of this change.
  - `ignore_conflicts` boolean

## Other responses

- `400`

---

[API](https://skmtc.dev/flagsmith/apis/flagsmith-api.md) · [All operations](https://skmtc.dev/flagsmith/apis/flagsmith-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/flagsmith/flagsmith-api/revisions/5a8154d05269/schema)