---
title: "Remove items from list"
method: DELETE
path: "/v2/lists/{id}/items"
tags: ["Lists"]
---

# Remove items from list

`DELETE /v2/lists/{id}/items`

## Request

- Base URL: `https://api.village.ai`
- URL: `https://api.village.ai/v2/lists/{id}/items`
- Auth: HTTP bearer

Remove items from a list by their item IDs. Use this to clean up lists by removing people or companies you no longer want to track. Provide an array of item_ids (obtained from get_list). Returns the count of successfully removed items.

## Path parameters

- `id` string, required: List ID

## Request body

- RemoveItemsRequest: Request body for removing items from a list
  - `item_ids` string[], required: Array of item IDs to remove from the list

## Response `200`

Items removed successfully

- object
  - `data` RemoveItemsResponse, required: Response after removing items from a list
    - `removed` number, required: Number of items removed
  - `metadata` object, required
    - `request_id` string, required

## Other responses

- `400`: Bad request - invalid parameters
- `401`: Unauthorized - missing or invalid authentication
- `404`: List not found

---

[API](https://skmtc.dev/village/apis/village-v2-api.md) - [All operations](https://skmtc.dev/village/apis/village-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/village/apis/village-v2-api/revisions/aebe21a1a544?raw)