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

# Delete segment

`DELETE /segments/{segment_id}/`

## Request

- Base URL: `https://api.hive.co/v2`
- URL: `https://api.hive.co/v2/segments/{segment_id}/`
- Auth: HTTP bearer

Delete an existing segment. Only segments the brand is allowed to delete can be removed.

## Path parameters

- `segment_id` string, required

## Headers

- `X-Partner-Id` string, required

## Response `204`

Segment deleted.

- object

## Other responses

- `404`: Segment not found.
- `422`: The segment cannot be deleted.

---

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