Delete a segment

curl --request DELETE \
  --url http://localhost:3000/projects/{projectId}/segments/{segmentId} \
  --header 'Authorization: Bearer <token>'

{}

Segments

Delete a segment

Performs a soft delete on a segment, marking it as deleted without permanently removing it from the database. This endpoint will fail with a 409 Conflict error if the segment is currently referenced by any active feature flag targeting rules, preventing accidental breakage of flag evaluation logic. Before deleting a segment, ensure no flags depend on it or update those flags to use alternative targeting rules. Soft-deleted segments can potentially be restored by administrators if needed for audit or recovery purposes.

DELETE

projects

{projectId}

segments

{segmentId}

Delete a segment

curl --request DELETE \
  --url http://localhost:3000/projects/{projectId}/segments/{segmentId} \
  --header 'Authorization: Bearer <token>'

{}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

projectId

string

required

segmentId

string

required

Response

Default Response

The response is of type object.

Update a segment Get segment usage

Overview

Evaluation

Authentication & Users

Organizations

Projects

Project Analytics

Flags

Flag Targeting Rules

Flag Variations

Flag Values

Rollouts

Segments

Environments

Attributes

API Keys

Webhooks

Billing

Plans

Audit Logs

Observability

Public

Delete a segment

Authorizations

Path Parameters

Response