---
title: "Update Segment"
method: PUT
path: "/v1/segment/{SegmentId}"
---

# Update Segment

`PUT /v1/segment/{SegmentId}`

## Request

- Base URL: `https://api.kevel.co`
- URL: `https://api.kevel.co/v1/segment/{SegmentId}`
- Auth: API key in header `X-Adzerk-ApiKey`

## Request body

- object
  - `Name` string: The human-friendly name of the segment. Max length is 200 characters.
  - `Source` string: Where the segment came from. Max length is 100 characters.
  - `Reach` object: The estimated reach of the segment for all time and the last 4 weeks.
    - `all_time` integer
    - `28d` integer
  - `Description` string: An extended human-friendly description of the segment. Max length is 500 characters.
  - `Category` string: The category a segment belongs to. Max length is 100 characters.

## Response `200`

200

- object
  - `Id` integer
  - `Source` string
  - `Name` string
  - `Reach` object
    - `all_time` integer
    - `28d` integer
  - `Description` string
  - `Category` string
  - `IsDeleted` boolean

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/kevel/apis/management-api-2.md) - [All operations](https://skmtc.dev/kevel/apis/management-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/kevel/apis/management-api-2/revisions/fe6c8716ca08?raw)
