---
title: "Remove contacts from a list"
method: DELETE
path: "/business/lists/{listId}/members"
tags: ["Lists"]
---

# Remove contacts from a list

`DELETE /business/lists/{listId}/members`

## Request

- Base URL: `https://api.tryfuse.ai/api/v1`
- URL: `https://api.tryfuse.ai/api/v1/business/lists/{listId}/members`
- Auth: HTTP basic

Removes contacts from the list by id. The contacts themselves stay in the workspace and in every other list. Idempotent (ids not in the list are ignored) and the response reports only how many ids were submitted, not how many memberships were removed. Up to 5,000 ids per call.

Errors:
- `404` `LIST_NOT_FOUND` — No list with that id is visible to the token owner.
- `422` `VALIDATION_FAILED` — contactIds missing, empty, over 5000 entries, or containing a non-24-hex id.
- `429` `RATE_LIMITED` — The lists rate bucket is exhausted.

Requires one of the following token scopes: lists.

## Path parameters

- `listId` string, required: 24-character hex id of the list (from GET /business/lists).

## Request body

- object
  - `contactIds` string[], required: Contact ids (24-character hex, 1-5000 per call) to add to or remove from the list; ids already in the list are ignored on add.

## Response `200`

Success

- object
  - `submittedCount` integer, required

## Other responses

- `400`: Error
- `401`: Error
- `402`: Error
- `403`: Error
- `404`: Error
- `409`: Error
- `422`: Error
- `429`: Error
- `500`: Error

---

[API](https://skmtc.dev/fuseai/apis/fuse-business-api.md) · [All operations](https://skmtc.dev/fuseai/apis/fuse-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fuseai/apis/fuse-business-api/revisions/50d95e0536f4?raw)