---
title: "Remove users from segment"
method: POST
path: "/segments/{segment_id}/users/remove/"
tags: ["segments"]
---

# Remove users from segment

`POST /segments/{segment_id}/users/remove/`

## Request

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

Only static segments can be modified through the API.

## Path parameters

- `segment_id` string, required

## Headers

- `X-Partner-Id` string, required

## Request body

- SegmentContactListRequest
  - `users` SegmentContactRequest[], required
    - `email` string, email, nullable
    - `phone` string, nullable

## Response `202`

Received and queued for background processing. Not yet applied.

- SegmentsUsersRemoveCreateResponse202: Empty response body

## Other responses

- `404`: Segment not found.
- `422`: Validation failed. For a batch write this is all-or-nothing. Field errors are keyed by resource name, then item index, then field path, query-parameter errors are keyed by parameter name, service-level rejections use a flat `errors` list.

---

[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)