---
title: "Delete many trusted reference faces"
method: POST
path: "/v1/face-assets/bulk-delete"
tags: ["Face assets"]
---

# Delete many trusted reference faces

`POST /v1/face-assets/bulk-delete`

## Request

- Base URL: `https://api.hotapi.ai`
- URL: `https://api.hotapi.ai/v1/face-assets/bulk-delete`
- Auth: HTTP bearer

Delete up to 500 trusted reference faces in one call, to free quota slots without one round-trip per face. Ids that do not belong to the caller's organization are ignored. Each face is removed from the provider first, and its record follows only on a confirmed removal, so `failed` lists exactly the faces that are still in the library and can be retried.

## Request body

- object
  - `ids` string[], required: Face ids to delete. Ids outside the caller's organization are ignored.

## Response `200`

Outcome of deleting trusted reference faces.

- DeletedFaceAssets: Outcome of deleting trusted reference faces.
  - `deleted` string[], required: Face ids that were removed.
  - `deleted_count` integer, required
  - `failed` object[], required: Faces that are still in the library: the provider delete failed, so the record was kept and the call can be retried.
    - `id` string, required
    - `error` string, required: Why the provider-side delete did not happen.

## Other responses

- `400`: Standard error envelope returned by every error response (OpenAI-style).
- `401`: Standard error envelope returned by every error response (OpenAI-style).
- `404`: Standard error envelope returned by every error response (OpenAI-style).
- `429`: Standard error envelope returned by every error response (OpenAI-style).

---

[API](https://skmtc.dev/hotapi/apis/hotapi-gateway.md) · [All operations](https://skmtc.dev/hotapi/apis/hotapi-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/hotapi/apis/hotapi-gateway/revisions/9b6578b0c389?raw)