---
title: "Remove IDs from Segment"
method: DELETE
path: "/console/v1/segments/{id}/id_list"
tags: ["Segments"]
---

# Remove IDs from Segment

`DELETE /console/v1/segments/{id}/id_list`

This endpoint is rate limited to 900 requests /15m or 12 requests /10s.

## Path parameters

- `id` string, required

## Request body

- SegmentIDListContractDto
  - `ids` string[], required

## Response `200`

Segment ids deleted successfully.

- object
  - `message` string

## Other responses

- `400` — Segment must be of type 'id_list' to be modified on this endpoint
- `401` — This endpoint only accepts an active CONSOLE key, but an invalid key was sent. Key: console-xxxXXXxxxXXXxxx
- `404` — Segment not found.
- `409` — Another update is already in progress for this ID list

---

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