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

# Delete a segment

`DELETE /v1/segments/{id}`

## Request

- Base URL: `https://api.mentio.dev`
- URL: `https://api.mentio.dev/v1/segments/{id}`
- Auth: HTTP bearer

Nobody in it is affected. Pass the `groupId` the segment was saved in.

## Path parameters

- `id` string, required: Segment id (seg_...).

## Query parameters

- `groupId` string: Scope to one keyword group (grp_...): only people who mentioned that group's keywords, with that group's own tags, notes, mute, merges, activities and segments. Omit for the whole workspace.

## Response `204`

Deleted

## Other responses

- `401`: Missing or invalid API key
- `404`: No such segment in this scope, or no such group

---

[API](https://skmtc.dev/mentio/apis/mentio-api.md) · [All operations](https://skmtc.dev/mentio/apis/mentio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mentio/apis/mentio-api/revisions/b16a21d0ed02?raw)