---
title: "Remove Subscribers from List"
method: POST
path: "/v1/subscriber_list/{list_id}/subscriber/remove/"
---

# Remove Subscribers from List

`POST /v1/subscriber_list/{list_id}/subscriber/remove/`

API to remove users from a list by passing their distinct_ids.

## Path parameters

- `list_id` string, required

## Request body

- object
  - `distinct_ids` string[] — Array of subscriber_ids, uniquely identifying the subscribers to be removed from the list.

## Response `201`

201

- object
  - `success` boolean, required — Indicates whether the operation was successful.
  - `affected_count` integer, required — Number of subscribers affected by the operation.

## Other responses

- `404` — 404

## Changes

- **2026-08-20** `9a5a2cd152ae` — 1 breaking
  - added the pattern `^[a-z0-9_-]+$` to the `path` request parameter `list_id`

[Change history](https://skmtc.dev/suprsend/apis/suprsend-api/changes/v1/subscriber_list/:list_id/subscriber/remove/post.md)

---

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