Segments
Delete segment
Remove a segment definition.
DELETE /app/segments/{segmentId}
Deletes the segment definition. Does not delete tags or registry assignments. Requires the Segments plan feature and admin role.
Path parameters
| Parameter | Type | Description |
|---|---|---|
segmentId | uuid | Segment to delete |
Request
See API Basics for required headers.
Sample request
curl -X DELETE https://api.statusdashboard.com/app/segments/8f3c2e1a-4b5d-6e7f-8a9b-0c1d2e3f4a5b \
-H "Authorization: Bearer bcf847abf5c6:def456"Sample response
Status: 204 No Content
No response body.
Error responses
| Status | When |
|---|---|
403 | Not admin or feature not enabled. |
404 | Segment not found. |