---
title: "Delete every trusted reference face"
method: DELETE
path: "/v1/face-assets"
tags: ["Face assets"]
---

# Delete every trusted reference face

`DELETE /v1/face-assets`

## Request

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

Clear the organization's whole trusted-face library, at the provider and here. Removes every reference image and video the organization has registered, including any the individual-delete endpoints cannot see. Irreversible: the faces have to be registered again (by referencing them in a new task). Reference media already used by finished tasks are unaffected.

## Response `200`

Outcome of clearing an organization's trusted-face library.

- WipedFaceLibrary: Outcome of clearing an organization's trusted-face library.
  - `object` 'face_library', required
  - `group_id` string, nullable, required: The provider-side group that held the organization's faces, if one existed.
  - `group_deleted` boolean, required: False when the group was already gone at the provider.
  - `rows_deleted` integer, required: Face records removed from our database.

## 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)