---
title: "Delete leads in bulk"
method: DELETE
path: "/api/projects/{id}/leads"
tags: ["Leads"]
---

# Delete leads in bulk

`DELETE /api/projects/{id}/leads`

## Request

- Base URL: `https://dosai.pro`
- URL: `https://dosai.pro/api/projects/{id}/leads`
- Auth: HTTP bearer

## Request body

- object
  - `ids` string[], required

## Response `200`

Deleted. `deleted` is how many rows actually went, which can be lower than the ids sent if some were already gone.

- object
  - `success` boolean, required
  - `deleted` integer

## Other responses

- `400`: Validation failed.
- `401`: Missing, invalid, expired or revoked key.
- `403`: Not allowed. Distinguish by `code`: `INSUFFICIENT_SCOPE` (read-only key attempted a mutation), `API_KEY_PROJECT_SCOPE` (project-scoped key reached outside its project), `FORBIDDEN` (the user's role on this project is too low), `ACCOUNT_BANNED`.
- `404`: No such resource, or it belongs to another account.
- `429`: Too many requests. 120/min per key overall, plus a stricter per-endpoint budget. Retry after the number of seconds in Retry-After.

---

[API](https://skmtc.dev/dosai/apis/dos-ai-public-api.md) · [All operations](https://skmtc.dev/dosai/apis/dos-ai-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dosai/apis/dos-ai-public-api/revisions/38ce5f4e8f50?raw)