• メッセージ
  • マネージドエージェント
  • 管理
Search...
⌘K
組織
Admin APIワークスペース
認証
概要Workload Identity FederationWIFリファレンス
モニタリング
Usage and Cost APIRate Limits APIClaude Code Analytics API
データとコンプライアンス
データレジデンシーAPIとデータ保持
Compliance API
概要アクセスの取得アクティビティフィードチャット、ファイル、プロジェクト組織、ユーザー、ロール、グループ統合の設計エラーFAQ
Log in
チャット、ファイル、プロジェクト
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...

Solutions

  • AI agents
  • Code modernization
  • Coding
  • Customer support
  • Education
  • Financial services
  • Government
  • Life sciences

Partners

  • Amazon Bedrock
  • Google Cloud's Vertex AI

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Company

  • Anthropic
  • Careers
  • Economic Futures
  • Research
  • News
  • Responsible Scaling Policy
  • Security and compliance
  • Transparency

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Help and security

  • Availability
  • Status
  • Support
  • Discord

Terms and policies

  • Privacy policy
  • Responsible disclosure policy
  • Terms of service: Commercial
  • Terms of service: Consumer
  • Usage policy
管理/Compliance API

チャット、ファイル、プロジェクトの取得と削除

Compliance APIを通じて、claude.ai組織のチャットコンテンツ、添付ファイル、プロジェクトにアクセスします。

このページのエンドポイントは、Claude Enterpriseプランの組織のみが利用できるclaude.aiコンテンツを取得および削除します。Compliance APIはリクエストに応じて有効化されます。Compliance APIへのアクセスを取得するを参照してください。

必要なスコープ: Compliance Access Keyのread:compliance_user_data。削除エンドポイントにはdelete:compliance_user_dataも必要です。

前提条件: チャットを一覧表示するには、組織ユーザーの一覧表示から取得した少なくとも1つのユーザーIDが必要です。このページの他のエンドポイントはリソースIDを直接受け取ります。

このページのエンドポイントは、claude.aiのチャットコンテンツ、ファイルアップロード、プロジェクト、およびプロジェクト添付ファイルをコンプライアンスレビュー担当者に公開します。これらは「eDiscovery」(電子情報開示)エクスポート、「data loss prevention」(データ損失防止)、すなわちDLPの実施、およびアカウント削除への対応をサポートします。コンテンツは、組織の保持ポリシーで許可されている期間保持されます。ユーザーがclaude.aiでソフト削除したチャットは、deleted_atが設定された状態でCompliance APIを通じて引き続き表示されます。ハード削除されたチャット(Compliance API自体を通じて、または組織の保持期間が経過した後)は取得できません。

両方のスコープは、claude.aiで作成されたCompliance Access Key(sk-ant-api01-...)にのみ付与されます。プロビジョニング方法についてはCompliance APIへのアクセスを取得するを参照してください。read:compliance_user_dataスコープは取得をカバーし、delete:compliance_user_dataは削除エンドポイントにのみ必要です。チャット、ファイル、プロジェクト、および添付ファイルのエンドポイントは、Admin APIキー(sk-ant-admin01-...)では利用できません。Admin APIキーで認証された呼び出しは403 Forbiddenを返します。

このページのエンドポイントは2つの方法でページネーションを行います。完全なリファレンスについては結果のページネーションを参照してください。各セクションで、どの方式が適用されるかを記載しています。

チャットとメッセージの取得

チャットの一覧表示を使用してチャットメタデータをページングし、次にチャットメッセージの取得を使用して1つのチャットの完全なメッセージコンテンツを取得します。

チャット一覧エンドポイントには少なくとも1つのuser_ids[]値が必要です(1回のリクエストで最大10個まで受け付けます)。そのため、まず組織ユーザーの一覧表示でユーザーIDを列挙し、次に各ユーザーまたはユーザーのバッチごとにチャットを一覧表示します。次のリクエストは、指定された日付以降に特定のユーザーが所有するチャットを一覧表示します。

cURL
curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/apps/chats" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --data-urlencode "user_ids[]=user_01XyDMpzjS89pFZXqSFUBDr6" \
  --data-urlencode "organization_ids[]=91012d09-e48b-438e-a489-1bebfd8fa6f9" \
  --data-urlencode "created_at.gte=2025-06-01T00:00:00Z" \
  --data-urlencode "limit=100"
Response
{
  "data": [
    {
      "id": "claude_chat_01H5CWunD7RpVJ5bHa8RCkja",
      "name": "Product Requirements Discussion",
      "created_at": "2026-04-10T08:09:10Z",
      "updated_at": "2026-04-10T09:10:11Z",
      "deleted_at": null,
      "href": "https://claude.ai/chat/abcdef01-2345-6789-abcd-ef0123456789",
      "model": "claude-opus-4-8",
      "organization_uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
      "project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq",
      "user": {
        "id": "user_01XyDMpzjS89pFZXqSFUBDr6",
        "email_address": "[email protected]"
      }
    }
  ],
  "has_more": true,
  "first_id": "claude_chat_01H5CWunD7RpVJ5bHa8RCkja",
  "last_id": "claude_chat_01H5CWunD7RpVJ5bHa8RCkja"
}

チャットの一覧表示はメタデータのみを返します。完全なフィルターリストについてはチャットの一覧表示を参照してください。必須のuser_ids[]に加えて、updated_at.*の範囲指定は、前回のエクスポート以降に変更されたチャットの増分レビューに役立ちます。

チャット結果はcreated_atの昇順(古い順)でソートされ、同値の場合はidで順序が決まります。ページネーションは結果のページネーションと同じfirst_id/last_id/has_moreカーソルフィールドを使用します。last_idをafter_idとして渡すと新しいチャットに向かって前進し、first_idをbefore_idとして渡すと古いチャットに向かって後退します。

実際のチャットコンテンツ、添付ファイル、およびインラインの「artifacts」(アーティファクト、Claudeがチャット内で生成する構造化ドキュメント)を取得するには、各チャットIDに対してメッセージエンドポイントを続けて呼び出します。

cURL
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"

メッセージエンドポイントは、チャットのメタデータとcreated_atでソートされたchat_messages配列を返します。limitを省略すると、完全なメッセージセットが1つのレスポンスで返されます。非常に長いチャットをページングするには、limit、after_id、またはbefore_idを渡します。このエンドポイントは、created_at.*およびupdated_at.*の範囲指定(gt、gte、lt、lte)とorderパラメータ(ascまたはdesc)も受け付けます。完全なパラメータリストについてはチャットメッセージの取得を参照してください。ユーザーメッセージの場合、created_atはメッセージが送信された時刻です。アシスタントメッセージの場合、Claudeがメッセージの生成を完了した時刻です。各メッセージにはテキストコンテンツが含まれ、存在する場合は、アップロードされたファイル(通常はユーザーメッセージに)、ツールで生成されたファイル、およびアシスタントが生成または更新したアーティファクト(通常はアシスタントメッセージに)が含まれます。

Response
{
  "id": "claude_chat_01H5CWunD7RpVJ5bHa8RCkja",
  "name": "Product Requirements Discussion",
  "created_at": "2026-04-10T08:09:10Z",
  "updated_at": "2026-04-10T09:10:11Z",
  "deleted_at": null,
  "href": "https://claude.ai/chat/abcdef01-2345-6789-abcd-ef0123456789",
  "model": "claude-opus-4-8",
  "organization_uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
  "project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq",
  "user": {
    "id": "user_01XyDMpzjS89pFZXqSFUBDr6",
    "email_address": "[email protected]"
  },
  "chat_messages": [
    {
      "id": "claude_chat_msg_01VnBPkLmtj7YdW5QrXKEA8c",
      "role": "user",
      "created_at": "2026-04-10T08:09:10Z",
      "content": [
        {
          "type": "text",
          "text": "Can you help me draft requirements for our new dashboard feature?"
        }
      ],
      "files": [
        {
          "id": "claude_file_01UaT9wBcDfGhJkLmNpQrSv7",
          "filename": "dashboard_mockup_v1.pdf",
          "mime_type": "application/pdf"
        }
      ]
    },
    {
      "id": "claude_chat_msg_01M8tFcHwbQ2kY6NpEjRZv4D",
      "role": "assistant",
      "created_at": "2026-04-10T08:09:11Z",
      "content": [
        {
          "type": "text",
          "text": "I'd be happy to help you draft requirements for your dashboard feature..."
        }
      ],
      "generated_files": [
        {
          "id": "claude_gen_file_01TbR8wAcCeFhJkLnPqStUvX",
          "filename": "requirements_summary.csv",
          "mime_type": "text/csv"
        }
      ],
      "artifacts": [
        {
          "id": "claude_artifact_01HqRsTuVwXyZa2BcDeFgH4J",
          "version_id": "claude_artifact_version_01KmNpQrSt3UvWxYz5AbCdEfG",
          "title": "Dashboard Requirements Draft",
          "artifact_type": "text/markdown"
        }
      ]
    }
  ],
  "has_more": false,
  "first_id": "eyJtc2dfdXVpZCI6ICIwZjcwYjA2Ni0uLi4ifQ==",
  "last_id": "eyJtc2dfdXVpZCI6ICJhNGUwYjE3Mi0uLi4ifQ=="
}

files、generated_files、およびartifactsは、特定のメッセージでそれぞれnullになる場合があります。filesは、ユーザーがメッセージに添付したバイナリアップロード(PDF、画像、スプレッドシート)です。generated_filesは、アシスタントがツール使用を通じて会話中に作成したバイナリファイル(PDF、スプレッドシート、スライドデッキなど)です。artifactsは、アシスタントがレスポンスで生成または更新したバージョン管理されたドキュメント(コードやマークダウンなど)です。アーティファクトは同じチャット内の複数のアシスタントターンにわたって改訂される場合があり、各改訂は同じアーティファクトidの下に新しいversion_idとして表示されます。各エントリのid(アーティファクトの場合はversion_id)をファイルとアーティファクトの取得の対応するコンテンツエンドポイントに渡してダウンロードします。

ファイルとアーティファクトの取得

ファイルとアーティファクトはIDでダウンロードされ、独立して一覧表示されることはありません。IDは、チャットとメッセージの取得のチャットメッセージエンドポイント(各メッセージのfiles、generated_files、およびartifacts配列)から、またはプロジェクトレベルのアップロードの場合はプロジェクト添付ファイルエンドポイントから取得されます。

IDタイプと必要なデータに一致するエンドポイントを選択してください。同じファイルコンテンツエンドポイントが、チャットファイルとプロジェクトファイルの両方に対応します。

持っているもの必要なもの使用するエンドポイント
claude_file_* IDファイルのバイナリコンテンツファイルコンテンツのダウンロード
claude_file_* IDファイルのメタデータのみファイルメタデータの取得
claude_gen_file_* IDツール生成ファイルのバイナリコンテンツClaude生成ファイルのダウンロード
claude_gen_file_* IDツール生成ファイルのメタデータのみ生成ファイルメタデータの取得
claude_artifact_version_* ID1つのアーティファクトバージョンのテキストアーティファクトコンテンツのダウンロード
claude_artifact_version_* IDアーティファクトバージョンのメタデータのみアーティファクトメタデータの取得
claude_proj_doc_* IDプロジェクトドキュメントのプレーンテキストコンテンツプロジェクトドキュメントコンテンツの取得
claude_proj_doc_* IDプロジェクトドキュメントのメタデータのみプロジェクトドキュメントメタデータの取得

ファイルコンテンツエンドポイントは、元のアップロードを次のヘッダー付きのチャンク化されたバイナリレスポンスとしてストリーミングします。

  • Content-Disposition: attachment; filename*=utf-8''<percent-encoded filename>は、元のアップロードファイル名をRFC 5987拡張形式で伝えます。拡張形式は、非ASCIIのファイル名だけでなく、すべてのファイル名に使用されます。
  • Content-TypeはアップロードのMIMEタイプを伝えます。
  • Content-MD5は、RFC 1864で指定されているとおり、ファイルのMD5ダイジェストをbase64エンコードして伝えます。
  • Transfer-Encoding: chunkedは常に設定されます。
cURL
file_id="claude_file_01UaT9wBcDfGhJkLmNpQrSv7"

curl --fail-with-body -sS -OJ \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  "https://api.anthropic.com/v1/compliance/apps/chats/files/$file_id/content"

-OJフラグは、curlにContent-Dispositionのファイル名(ユーザーがアップロードした元のファイル名)でレスポンスを保存するよう指示します。

アーティファクトコンテンツエンドポイントは、1つのアーティファクトバージョンのテキスト本文を返します。アーティファクトの固定idではなく、アシスタントメッセージのartifacts配列のエントリの1つからversion_idを渡します。アーティファクトの各新バージョンには独自のversion_idがあり、Compliance APIはそのバージョンの正確なバイトを提供します。

プロジェクトと添付ファイルの取得

プロジェクトは、関連するチャットをカスタム指示、ナレッジベースコンテンツ、および添付ファイルやテキストドキュメントとともにまとめます。Compliance APIは、プロジェクトメタデータ、プロジェクト詳細、およびプロジェクトに属する添付ファイルのリストを公開します。

  • プロジェクトの一覧表示
  • プロジェクト詳細の取得
  • プロジェクト添付ファイルの一覧表示
  • プロジェクトドキュメントコンテンツの取得

プロジェクト結果は作成日の昇順でソートされます。添付ファイル結果はcreated_atの昇順でソートされ、同値の場合はidで順序が決まります。プロジェクト一覧と添付ファイル一覧のレスポンスは、チャットやActivity Feedで使用されるfirst_id/last_idカーソルではなく、不透明なnext_pageページトークンでページネーションします。次のリクエストでpageクエリパラメータとしてトークンを渡します。

プロジェクトファイルとプロジェクトドキュメントの違い

プロジェクト添付ファイルは、各エントリのtype識別子によって識別される2つの異なる形式のいずれかです。

typeがproject_fileのエントリは、IDがclaude_file_で始まるバイナリアップロード(PDF、画像、スプレッドシート)です。ファイルコンテンツのダウンロードでダウンロードします。typeがproject_docのエントリは、IDがclaude_proj_doc_で始まるプレーンテキストドキュメント(常にtext/plain)です。プロジェクトドキュメントコンテンツの取得で取得します。

添付ファイルリストを走査するコンシューマーは、typeで分岐し、各エントリに対応するコンテンツエンドポイントを呼び出す必要があります。次のリクエストは添付ファイルの1ページを一覧表示します。has_moreがfalseになるまで、next_pageをpageパラメータとして渡してページネーションします。

cURL
project_id="claude_proj_01KGp4eZNug9ri4kE35RSppq"

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/apps/projects/$project_id/attachments" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"
Response
{
  "data": [
    {
      "id": "claude_file_01UaT9wBcDfGhJkLmNpQrSv7",
      "created_at": "2026-04-10T08:09:10Z",
      "filename": "dashboard_mockup_v1.pdf",
      "mime_type": "application/pdf",
      "type": "project_file"
    },
    {
      "id": "claude_proj_doc_01YnT8sBcWvUtXzQpMkRfDgH",
      "created_at": "2026-04-10T08:09:11Z",
      "filename": "requirements.md",
      "mime_type": "text/plain",
      "type": "project_doc"
    }
  ],
  "has_more": false,
  "next_page": null
}

コンテンツの削除

成功したすべての削除は永続的かつ即時です。復元期間はありません。

Compliance APIは、チャット、ファイル、プロジェクトドキュメント、およびプロジェクト全体のハード削除エンドポイントを公開します。ハード削除されたチャットは復元できず、その後一覧レスポンスに表示されなくなります(一方、claude.aiからソフト削除されたチャットはdeleted_atが設定された状態で引き続き表示されます)。

  • チャットの削除:チャットのメッセージと、それらのメッセージに添付されたファイルも削除します。
  • ファイルの削除:チャットファイルとプロジェクトファイルの両方を処理します。
  • プロジェクトドキュメントの削除:IDで単一のプロジェクトドキュメントを削除します。
  • プロジェクトの削除:プロジェクトを削除する前にチャットを切り離すを参照してください。

4つのエンドポイントすべてにdelete:compliance_user_dataスコープが必要です。このスコープは、Compliance Access Keyの作成時に読み取りスコープとは別に付与されます。

次のリクエストは1つのチャットを削除します。他の削除エンドポイントにも同じパターンが適用され、URLのみが変わります。

cURL
# 警告:この操作はチャット、そのすべてのメッセージ、および添付ファイルを永久に削除します。
# 削除は即座に実行され、元に戻すことはできません。
# この操作には `delete:compliance_user_data` スコープが必要です。このスコープは、
# コンプライアンスアクセスキーの作成時に `read: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"
Response
{
  "id": "claude_chat_01H5CWunD7RpVJ5bHa8RCkja",
  "type": "claude_chat_deleted"
}

成功した各削除は、idとtype識別子を含む小さな確認エンベロープを返します。チャットエンドポイントはclaude_chat_deletedを返します。削除が確認されたものとして扱う前にtypeフィールドを確認してください。他のエンドポイントが返す正確なtype値については、各削除エンドポイントのAPIリファレンスページのレスポンススキーマを参照してください。

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

チャットが添付されたままの状態では、プロジェクトを削除できません。APIは次のボディとともに409を返します。

{
  "error": {
    "type": "conflict_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."
  }
}

解決するには、GET /v1/compliance/apps/chats?user_ids[]={user_id}&project_ids[]={project_id}でプロジェクトのチャットを一覧表示し(チャット一覧エンドポイントには少なくとも1つのuser_ids[]値が必要です。組織ユーザーの一覧表示でIDを列挙してください)、DELETE /v1/compliance/apps/chats/{claude_chat_id}で各チャットを削除し(またはclaude.aiからプロジェクト外に移動し)、その後プロジェクトの削除を再試行します。

次のステップ

APIリファレンス

すべてのチャット、ファイル、プロジェクト、アーティファクトエンドポイントの完全なリクエストおよびレスポンススキーマ。

組織、ユーザー、ロール、グループの一覧表示

このページのチャットとプロジェクトに関連付けられた人とチームを列挙します。

Was this page helpful?

  • チャットとメッセージの取得
  • ファイルとアーティファクトの取得
  • プロジェクトと添付ファイルの取得
  • プロジェクトファイルとプロジェクトドキュメントの違い
  • コンテンツの削除
  • プロジェクトを削除する前にチャットを切り離す
  • 次のステップ