> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Удаление биометрического шаблона: API > Didit: DELETE /v3/biometric-templates/{template_uuid}/ удаляет сохранённый биометрический шаблон лица из сопоставления и хранилища. Идемпотентно. Очищает один шаблон: он удаляется из всех видов сопоставления, а сохранённый шаблон стирается. Очистка необратима и фиксируется в журнале аудита с указанием субъекта, выполнившего операцию. ```bash theme={null} curl -X DELETE https://verification.didit.me/v3/biometric-templates/9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b/ \ -H "x-api-key: YOUR_API_KEY" ``` ```json theme={null} { "uuid": "9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b", "outcome": "purged" } ``` | `outcome` | Значение | | - | - | | `purged` | Шаблон очищен этим вызовом. | | `already_purged` | Шаблон уже был очищен. Повторная очистка безопасна. | ## Семантика повторных попыток Didit сначала удаляет сохранённый шаблон и только потом помечает шаблон как очищенный. Если хранилище биометрических данных недоступно, вызов возвращает `503`, шаблон переходит в `status: purge_failed` и уже исключён из сопоставления. Повторите тот же вызов, чтобы завершить очистку. ## Ошибки | Статус | Когда | Тело | | - | - | - | | `403` | Токен пользователя консоли или API-ключ не имеет доступа | `{"detail": "You do not have permission to perform this action."}` | | `404` | Неизвестный шаблон или шаблон другого приложения | `{"detail": "Biometric template not found."}` | | `503` | Хранилище биометрических данных было недоступно. Шаблон находится в состоянии `purge_failed` и исключён из сопоставления; повторите вызов. | `{"detail": "The biometric-template operation could not finish because an external store is unavailable. The operation is retryable."}` | ## Другие точки очистки Шаблоны также очищаются при удалении пользователя-владельца через [Пакетное удаление пользователей](https://docs.didit.me/ru/management-api/users/delete.md), при удалении любой сессии этого пользователя с `deletion_instruction: "privacy_erasure"`, а также автоматически по достижении `expires_at`. См. [Точки очистки](https://docs.didit.me/ru/management-api/biometric-templates/overview.md#точки-удаления). ## OpenAPI ````yaml ru/openapi-25.json DELETE /v3/biometric-templates/{template_uuid}/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: >- API верификации личности. Аутентификация выполняется с помощью заголовка x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/biometric-templates/{template_uuid}/: delete: tags: - Biometric Templates summary: Удалить сохранённый биометрический шаблон description: >- Приложение, давшее согласие на участие, сохраняет один отдельно управляемый биометрический шаблон лица без изображений, привязанный к Пользователю, при удалении сессии (см. `DELETE /v3/session/{sessionId}/delete/`). Шаблоны представляют собой биометрические данные с ограниченным сроком `expires_at`; они никогда не содержат изображений, данных сессии или полей идентификации и очищаются при удалении Пользователя, удалении данных в целях конфиденциальности, истечении срока действия или явной очистке. Эти endpoint принимают только API-ключи приложений (`x-api-key`); токены пользователей Business Console отклоняются с кодом `403`. Очищает один шаблон: он исключается из всех видов сопоставления, а сохранённый шаблон удаляется. Действие необратимо и фиксируется в журнале аудита с указанием совершившего его субъекта. **Семантика повторных попыток:** Didit сначала удаляет сохранённый шаблон и только затем помечает его как очищенный. Если биометрическое хранилище недоступно, вызов возвращает `503`, шаблон переходит в `status: purge_failed` и уже исключён из сопоставления; повторите тот же вызов для завершения. Повторная очистка уже очищенного шаблона возвращает `already_purged`. Шаблоны также очищаются с помощью `POST /v3/users/delete/` для соответствующего Пользователя, при любом удалении сессий этого Пользователя с `deletion_instruction: privacy_erasure`, а также автоматически при наступлении `expires_at`. operationId: purge_biometric_template parameters: - in: path name: template_uuid required: true description: >- Идентификатор шаблона, возвращаемый в `biometric_template_uuid` endpoint'ами удаления сессии, `biometric_template_id` при совпадении в Поиске по лицу или endpoint'ом списка. schema: type: string format: uuid example: 9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b responses: '200': description: Результат удаления. content: application/json: schema: type: object properties: uuid: type: string format: uuid outcome: type: string enum: - purged - already_purged examples: Purged: value: uuid: 9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b outcome: purged Already purged: value: uuid: 9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b outcome: already_purged '403': description: >- Токен пользователя Console, либо данный API-ключ не разрешён. Эти endpoint принимают только API-ключи приложений. content: application/json: examples: Forbidden: value: detail: You do not have permission to perform this action. '404': description: >- Неизвестный шаблон, шаблон другого приложения или (при `GET`) удалённый шаблон. content: application/json: examples: Not found: value: detail: Biometric template not found. '503': description: >- Хранилище биометрии было недоступно при сохранении или удалении биометрического шаблона. Ничего не удалено; повторите тот же запрос. Повторные попытки идемпотентны и сходятся к одному шаблону. content: application/json: schema: type: object properties: detail: type: string examples: Retryable: value: detail: >- The biometric-template operation could not finish because an external store is unavailable. The operation is retryable. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X DELETE https://verification.didit.me/v3/biometric-templates/9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b/ \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.biometric_templates.delete( "9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b", ) print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.biometricTemplates.delete("9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b"); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.BiometricTemplates.Delete(ctx, \"9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b\")\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.biometricTemplates().delete("9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b"); System.out.println(result); - lang: php label: PHP source: >- biometricTemplates->delete('9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b'); print_r($result->toArray()); - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.biometric_templates.delete("9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b") puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.BiometricTemplates.DeleteAsync("9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b"); Console.WriteLine(JsonSerializer.Serialize(result)); components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.