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

# Delete a segment

`DELETE /segments/{id}`

## Path parameters

- `id` string, required

## Response `200`

The deleted `Segment` object

- Segment
  - `id` string, required — The ID of the segment
  - `name` string, required — The name of the segment
  - `filter` string, nullable, required — The filter for this segment
  - `description` string, nullable, required — A Markdown description of the filter
  - `metadata` object — Metadata attached to this segment
  - `static_customers` string[] — The customers that are always included in this segment

---

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