# Delete segment

Remove a segment definition.

Source: https://statusdashboard.com/docs/api/subscriptions/segments/delete

`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](/docs/api) for required headers.

***

## Sample request
```bash
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.                |