---
title: "Delete points by id"
method: DELETE
path: "/collections/{collectionId}/points"
tags: ["Point"]
---

# Delete points by id

`DELETE /collections/{collectionId}/points`

Bulk delete points based on id. This endpoint does not check if the points exist. If you attempt to delete a point that does not exist, it will be ignored and included in the failedPoints list.

## Request body

- DeletePointsRequest
  - `ids` string[], required

## Response `200`

Deleted points

- DeletePointsResponse
  - `message` string — A message indicating the result of the operation
  - `failedPoints` object[] — A list of points that failed to insert. Each point has an id and an error message. For example, if the error is "not found", the point does not exist in the collection.
    - `id` string, uuid
    - `error` string

## Changes

- **2024-03-05** (v2) `dd1cf2f988c1` — 1 breaking
  - the `ids` request property's minItems was increased to `1`

[Change history](https://skmtc.dev/semafind/apis/semadb-api/changes/collections/:collectionId/points/delete.md)

---

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