Update segment

Updates an existing segment by ID.
The segment must not be in a building state to be updated.
If the segment is currently being built, a 409 Conflict error is returned.

Scopes:
segments.write

Rate Limiting:
This endpoint is rate limited to 15 requests per minute.

The request body structure (name and conditionGroups) is identical to Create segment.
See the Create segment endpoint for detailed examples of condition groups, filters, and advanced segmentation patterns.

Path Params
string
required

Segment ID

Body Params

Segment update request

Request body for updating an existing segment.

conditionGroups
array of objects
required

Condition groups defining the segment rules

conditionGroups*
string
required
length ≤ 256

Name of the segment

Headers
string
required
Defaults to 2026-03-15

API version that specifies the response format and behaviour (e.g., 2026-preview)

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json