---
title: "Bulk Delete Entities"
method: POST
path: "/api/v1/entities/bulk-delete"
tags: ["entities"]
---

# Bulk Delete Entities

`POST /api/v1/entities/bulk-delete`

## Request

- Base URL: `https://api.gnosari.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gnosari.com/api/v1/entities/bulk-delete`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-AUTH-TOKEN`

Bulk permanently delete multiple entities.

Account-scoped (mirrors bulk-status): alien/missing ids are silently
skipped, ``deleted`` counts only rows actually removed, never 404.

## Request body

- ExtractedEntityBulkDelete: Schema for bulk permanent deletes. Mirrors ``ExtractedEntityBulkStatusUpdate`` (min_length=1 → empty list is a 422 at the API layer). No status field: the operation is a hard delete.
  - `entity_ids` integer[], required: List of entity IDs to delete

## Response `200`

Successful Response

- BulkDeleteResponse
  - `deleted` integer, required

## Other responses

- `422`: Validation Error

---

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