---
title: "Create Change Request for Rule-based Segment"
method: POST
path: "/internal/api/v2/changeRequests/ws/{workspace-id}/environments/{environment-id}"
tags: ["Rule-based Segments"]
---

# Create Change Request for Rule-based Segment

`POST /internal/api/v2/changeRequests/ws/{workspace-id}/environments/{environment-id}`

## Request

- Base URL: `https://api.split.io`
- URL: `https://api.split.io/internal/api/v2/changeRequests/ws/{workspace-id}/environments/{environment-id}`
- Auth: HTTP bearer

## Path parameters

- `workspace-id` string, required
- `environment-id` string, required

## Request body

- ChangeRequest
  - `ruleBasedSegment` RuleBasedSegmentDefinition, required
    - `title` string
    - `comment` string
    - `rules` object[]
      - `condition` object
        - `combiner` string
        - `matchers` object[]
    - `excludedKeys` string[]
    - `excludedSegments` object[]
      - `name` string
      - `type` string
  - `operationType` string, required
  - `title` string, required
  - `comment` string
  - `approvers` string[]

## Response `200`

Change Request created successfully

- ChangeRequest
  - `ruleBasedSegment` RuleBasedSegmentDefinition, required
    - `title` string
    - `comment` string
    - `rules` object[]
      - `condition` object
        - `combiner` string
        - `matchers` object[]
    - `excludedKeys` string[]
    - `excludedSegments` object[]
      - `name` string
      - `type` string
  - `operationType` string, required
  - `title` string, required
  - `comment` string
  - `approvers` string[]

## Other responses

- `400`: Invalid request format or data
- `401`: Unauthorized
- `500`: Internal server error

---

[API](https://skmtc.dev/split/apis/rule-based-segments.md) - [All operations](https://skmtc.dev/split/apis/rule-based-segments/llms.txt) - [OpenAPI document](https://skmtc.dev/split/apis/rule-based-segments/revisions/1c663896e763?raw)