---
title: "Delete segment"
method: DELETE
path: "/segments/{segmentID}"
tags: ["Segments"]
---

# Delete segment

`DELETE /segments/{segmentID}`

Permanently deletes a segment by its unique identifier.
The segment must not be in a building state to be deleted.
If the segment is currently being built, a `409 Conflict` error is returned.

**Scopes:**
`segments.write`

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

## Path parameters

- `segmentID` string, required

## Headers

- `Omnisend-Version` string, required

## Response `204`

No Content

## Other responses

- `400` — Request contains invalid or missing fields
- `401` — Authentication is missing or invalid
- `403` — Insufficient permissions for this operation
- `409` — Segment is currently being built and cannot be deleted
- `410` — API version has been retired
- `429` — Rate limit exceeded
- `500` — Unexpected error occurred

---

[API](https://skmtc.dev/omnisend/apis/events-api.md) · [All operations](https://skmtc.dev/omnisend/apis/events-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/omnisend/events-api/revisions/50214fbc283f/schema)