Compliance APIでチャットを削除する手順 — ファイル・プロジェクトも対象

Compliance APIでできるチャット・ファイル・プロジェクト操作

Compliance APIは、Claude Enterprise組織のclaude.aiチャット・添付ファイル・アーティファクト・プロジェクトを、コンプライアンス担当者向けに読み取り・削除できるエンドポイント群を提供します。eDiscovery(電子証拠開示)のエクスポート、DLP(データ損失防止)の実施、アカウント削除要求への対応が主な用途です。このページのエンドポイントが扱うのはclaude.aiのチャット・ファイル・プロジェクトだけです。CoworkやClaude Codeのセッションのトランスクリプトは別エンドポイント(後述のセッション記事)が担当します。

必要なキーはclaude.aiで作成したCompliance Access Key(sk-ant-api01-...)で、読み取りにはread:compliance_user_dataスコープ、削除にはさらにdelete:compliance_user_dataスコープが要ります。Claude Console側のAdmin API key(sk-ant-admin01-...)ではこのページのエンドポイントを一切呼べず、403 Forbiddenが返ります。Admin API keyが持つスコープはread:compliance_activitiesだけで、read:compliance_user_dataは付与できません。キーの作り方はCompliance APIのセットアップとアクセスキー作成を先に済ませてください。

チャット・ファイル・プロジェクトのコンテンツは、組織の保持ポリシーが許す期間だけ保存されます。「削除」には2種類あり、Compliance APIから見える状態がまったく違います。

この違いは、削除の取りこぼし検知や後始末のスクリプトを組むときに効いてきます。

チャットとメッセージを取得する

チャット一覧はList chats、1件のチャット本文はGet chat messagesで取得します。

一覧エンドポイントは既定で組織全体を対象にします。user_ids[]を付けなければ、親組織配下の全チャットが対象です。order_by=updated_atを付けると更新順にソートされ、ユーザーを列挙せずに新規・更新・削除済みのチャットをまとめて拾えるため、継続的なエクスポートに向いています。

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/apps/chats" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --data-urlencode "order_by=updated_at" \
  --data-urlencode "updated_at.gte=2025-06-01T00:00:00Z" \
  --data-urlencode "limit=100"

結果はorder_byの値で昇順(古い順)に並び、first_id/last_id/has_moreのカーソルでページ送りします。前回実行時のlast_idをafter_idとして渡せば、次回以降も新規チャットと更新・削除されたチャットの両方を拾えます。IDをキーに冪等に処理し、deleted_atが入っているチャットは「削除済み」として扱ってください。

特定ユーザーに絞る場合はuser_ids[]を1〜10件渡します。ユーザーIDはList organization usersで取得します。ユーザー絞り込みのクエリは常にcreated_at順になり(order_by=updated_atを渡すと400エラー)、before_idも使えます。project_ids[]での絞り込みもこの形式でしか使えません。user_ids[]とupdated_at.*の併用は2026年9月22日より後は400エラーで拒否されます。更新順で対象ユーザーを追い続けたい場合は、組織全体のクエリを実行してから対象ユーザーの分だけ抽出する形に切り替える必要があります。

チャット本文・添付ファイル・アーティファクトは、チャットIDごとにメッセージエンドポイントで取得します。

chat_id="claude_chat_01H5CWunD7RpVJ5bHa8RCkja"
 
curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/apps/chats/$chat_id/messages" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --header "anthropic-version: 2023-06-01"

各メッセージには本文に加えて、ユーザーが添付したfiles、アシスタントがツールで生成したgenerated_files、アシスタントが作成・更新したartifacts(コードやMarkdownのバージョン管理された文書)が入ります。limitを省略すると全メッセージが1回で返り、長いチャットではlimit・after_id・before_idでページ送りします。

ファイルとアーティファクトの中身を取得する

ファイル・生成ファイル・アーティファクトはIDだけで個別にダウンロードします。IDの種類ごとに叩くエンドポイントが変わります。

file_id="claude_file_01UaT9wBcDfGhJkLmNpQrSv7"
 
curl --fail-with-body -sS \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --output "dashboard_mockup_v1.pdf" \
  "https://api.anthropic.com/v1/compliance/apps/chats/files/$file_id/content"

curlの-JはContent-Dispositionのfilename*形式を読まないため、--outputで保存名を自分で指定します。名前はメッセージのfilenameフィールドかfilename*から取ります。アップロード者が付けた名前なので信用せず、ベース名だけを使い、-や.で始まる名前は拒否してください。返ってくる内容は、必ずしもアップロードされたバイト列そのものではありません。画像は加工済みコピーとして配信されることがあり、Wordファイル・PowerPointファイル・一部のPDFはclaude.aiが抽出したテキストとして保存されているため、抽出後のテキストが元のファイル名のまま返ります。ファイル形式は名前や宣言されたMIMEタイプではなく、返ってきたバイト列そのものから判定してください。

アーティファクトのダウンロードには、安定したidではなくversion_idを渡します。アシスタントが同じアーティファクトを会話中に何度も改訂すると、改訂のたびに新しいversion_idが発行され、Compliance APIはその版の内容をそのまま返します。

プロジェクトと添付を取得する

プロジェクトは、カスタム指示・ナレッジベース・添付ファイルをまとめる単位です。List projectsとList project attachmentsで一覧を取得します。プロジェクト一覧・添付一覧はfirst_id/last_id方式ではなく、レスポンスのnext_pageトークンをpageクエリに渡してページ送りする点がチャット一覧と異なります。

プロジェクトの添付はtypeが2種類あり、扱いが分かれます。

• project_file: PDFや画像などのファイルアップロード。IDはclaude_file_始まりで、ファイルの取得と同じエンドポイントを使う
• project_doc: 常にtext/plainのプレーンテキスト文書。IDはclaude_proj_doc_始まりで、Wordファイルなどプロジェクト追加時にテキスト変換された文書も含む

一覧を歩くコンシューマーは、このtypeで分岐して対応するエンドポイントを呼び分ける必要があります。

コンテンツを削除する

削除エンドポイントは4種類あります。

• Delete chat: チャットとそのメッセージ、添付ファイルもまとめて削除
• Delete file: チャットファイル・プロジェクトファイルの両方に使える
• Delete project document: プロジェクトドキュメントを1件削除
• Delete project: チャットが1件でも紐づいたプロジェクトは削除できない(後述)

4つすべてがdelete:compliance_user_dataスコープを必要とし、このスコープは読み取り用のread:compliance_user_dataとは別にキー作成時に選ぶ必要があります。

# 警告: このコマンドはチャットとそのメッセージ・添付ファイルを完全に削除します。
# 削除は即座かつ取り消し不可能です。delete:compliance_user_data スコープが必要です。
# 実行前に明示的な権限があることを確認してください。
 
chat_id="claude_chat_01H5CWunD7RpVJ5bHa8RCkja"
 
curl --fail-with-body -sS -X DELETE \
  "https://api.anthropic.com/v1/compliance/apps/chats/$chat_id" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --header "anthropic-version: 2023-06-01"

成功時はidとtypeを含む小さな確認レスポンスが返ります。チャット削除ならtypeがclaude_chat_deletedです。他の削除エンドポイントもそれぞれ固有のtype値を返すため、削除が確定したかどうかはこのtypeフィールドで判定します。

削除が失敗したとき・すでに消えていたとき

削除の呼び出しで返りうる代表的な応答を、本文メッセージ込みでまとめます。判定にはHTTPステータスとerror.typeを主に使います。404だけはerror.typeが同じなので、本文がNot foundのみか、リソース名を含むかで見分けます。

最後の行は紛らわしい点です。メッセージがNot foundだけの404は、リソースが無いのではなく認証が通っていない合図で、パスが存在しない場合も同じ本文が返ります。

ユーザーがclaude.aiで消したチャットは404になりません。読み取りは通り、deleted_atが入って本文が空の状態で返ります。ファイルを巻き込んで消えた場合の確認先は、Activity Feedのclaude_chat_deletedです。チャットと一緒に消えたファイルにはclaude_file_deletedが記録されないため、ファイルの活動記録だけを探すと見落とします。

Compliance APIへのリクエストは、親組織あたり毎分600回に制限されます。削除をループで回す後始末スクリプトでは、429が返ったら間隔を空けて再試行する作りにします。

プロジェクト削除前にチャットを切り離す

チャットが1件でも紐づいたプロジェクトは削除できず、409 Conflictが返ります。error.typeは400と同じinvalid_request_errorなので、競合の判別にはステータスコードを使います。

{
  "error": {
    "type": "invalid_request_error",
    "message": "The \"claude_proj_01KGp4eZNug9ri4kE35RSppq\" project cannot be deleted as it has chats attached to it. Delete or detach all chats, and try deleting the project again."
  }
}

まとめ

Compliance APIのチャット・ファイル・プロジェクトエンドポイントは、Compliance Access Keyのread:compliance_user_dataで読み取り、delete:compliance_user_dataで削除します。一覧はorder_by=updated_atの組織全体クエリが継続的なエクスポートの基本形で、本文・ファイル・アーティファクトはIDごとに別エンドポイントで取り出します。削除はすべて即座かつ不可逆なので、実行前の対象確認とスコープを分けたキー運用が欠かせません。

キーのスコープ設計はCompliance APIのセットアップとアクセスキー作成、CoworkやClaude Codeのセッショントランスクリプトの取得はCompliance APIでローカル/リモートのセッション文字起こしを取得するにまとめています。組織全体のデータをまとめて落としたい場合は、Primary Owner向けのClaude組織データエクスポートの手順も選択肢になります。