メインコンテンツへスキップ
DELETE
curl
テンプレートを1件パージします。テンプレートはあらゆる種類の照合から除外され、保存されているテンプレートは削除されます。パージは元に戻せず、実行したプリンシパルとともに監査証跡に記録されます。

再試行のセマンティクス

Diditは、保存されているテンプレートを先に削除し、その後でのみテンプレートをパージ済みとしてマークします。生体認証ストアが利用できない場合、呼び出しは503を返し、テンプレートはstatus: purge_failedに移行します。この時点でテンプレートはすでに照合から除外されています。パージを完了するには、同じ呼び出しを繰り返してください。

エラー

その他のパージ契機

テンプレートは、Batch Delete Usersでテンプレートを所有するUserを削除したとき、そのUserのいずれかのセッションをdeletion_instruction: "privacy_erasure"で削除したとき、およびexpires_atになると自動的にパージされます。詳しくはパージ契機を参照してください。

承認

x-api-key
string
header
必須

お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権(なし、読み取り、書き込み)、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください: https://docs.didit.me/console/api-keys

パスパラメータ

template_uuid
string<uuid>
必須

テンプレートID。セッション削除エンドポイントが返すbiometric_template_uuid、顔検索の一致結果のbiometric_template_id、または一覧エンドポイントで返される値です。

例:

"9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b"

レスポンス

完全削除の結果。

uuid
string<uuid>
outcome
enum<string>
利用可能なオプション:
purged,
already_purged
最終更新日 2026年11月1日