---
title: "Remove people from a manual segment"
method: POST
path: "/api/v1/segments/{segment_id}/remove_customers"
tags: ["Track Segments"]
---

# Remove people from a manual segment

`POST /api/v1/segments/{segment_id}/remove_customers`

You can remove users from a manual segment by ID. You are limited to 1000 customer IDs per request.

This endpoint requires people to have `id` attributes. If your workspace does not use `id` as an identifier, or you have not assigned people `id` values, you cannot remove people from manual segments using the API. Our user interface does not have this limitation. You can remove people from manual segments through the UI as a part of an automation workflow.

**NOTE**: You cannot remove people from data-driven segments using the API. See [our documentation on segments](/journeys/segmentation/segments) for more information about segments.

## Request body

- object — The IDs of people you want to remove from the segment.
  - `ids` string[], required — The customer IDs you want to remove from the segment.

## Response `200`

A successful request returns an empty object response.

## Other responses

- `400` — Invalid or malformed request.
- `401` — Unauthorized request. Make sure that you provided the right credentials.

---

[API](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference.md) · [All operations](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/customer/customer-io-journeys-api-reference/revisions/4b391af7cb06/schema)