擷取與刪除聊天、檔案及專案
透過 Compliance API 存取 claude.ai 組織的聊天內容、檔案附件及專案。
本頁的端點向合規審查人員公開 Claude Enterprise 的聊天內容、檔案上傳、專案及專案附件。它們支援「electronic discovery」（電子蒐證），即 eDiscovery 匯出、「data loss prevention」（資料外洩防護），即 DLP 強制執行，以及帳戶刪除回應。聊天、檔案及專案內容的保留期限取決於您組織的保留政策。當使用者在 claude.ai 中刪除聊天時，其訊息內容、附加檔案、工具產生的檔案及 artifacts 會一併刪除。Compliance API 仍會列出該聊天，其 deleted_at 會填入值且 name 為空，並回傳不含內容的訊息。已被硬刪除（透過 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。
本頁的端點有兩種分頁方式；完整參考請見分頁結果。每個章節都會註明適用哪一種方案。
擷取聊天與訊息
使用列出聊天逐頁瀏覽聊天中繼資料，然後使用取得聊天訊息擷取單一聊天的完整訊息內容。
聊天清單端點預設為全組織範圍：省略 user_ids[] 即可包含您上層組織下的每一個聊天。加上 order_by=updated_at 可依最後更新時間排序。此組合是匯出聊天並讓匯出保持最新的建議方式，因為單一分頁迴圈即可擷取每位使用者的新聊天、已修改的聊天，以及在 claude.ai 中刪除的聊天，而無需先列舉使用者。以下請求列出自指定日期以來更新過的聊天。
curl --fail-with-body -sS -G \
"https://api.anthropic.com/v1/compliance/apps/chats" \
--header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
--data-urlencode "order_by=updated_at" \
--data-urlencode "updated_at.gte=2025-06-01T00:00:00Z" \
--data-urlencode "limit=100"{
"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-5",
"organization_uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
"project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq",
"user": {
"id": "user_01XyDMpzjS89pFZXqSFUBDr6",
"email_address": "user@example.com"
}
}
],
"has_more": true,
"first_id": "eyJrIjogInVwZGF0ZWRfYXQiLCAidCI6ICIyMDI2LTA0LTEwVDA5OjEwOjExKzAwOjAwIiwgImlkIjogImFiY2RlZjAxLS4uLiJ9",
"last_id": "eyJrIjogInVwZGF0ZWRfYXQiLCAidCI6ICIyMDI2LTA0LTEwVDA5OjEwOjExKzAwOjAwIiwgImlkIjogImFiY2RlZjAxLS4uLiJ9"
}結果依 order_by 欄位遞增排序，最舊的在前，相同值時以 id 決定順序。分頁使用分頁結果中所述的標準 first_id/last_id/has_more 游標欄位。若要向前走向較新的聊天，請在下一個請求中將回應的 last_id 作為 after_id 傳回。
這種向前走訪也是您在多次執行之間讓匯出保持最新的方式：保存最後一頁的 last_id，並在下次執行時以它作為 after_id 繼續。由於清單依 updated_at 排序，在您儲存的游標之後發生變更的聊天會重新出現在游標前方，因此每次增量執行都會回傳全新的聊天，以及此後在 claude.ai 中被修改或刪除的較舊聊天。請以聊天 id 為鍵，以冪等方式處理結果，以應對這些重複出現的情況。回傳時 deleted_at 已填入值的聊天已無內容可擷取，因此請將其視為已刪除而非已更新。
這些全組織查詢有幾項限制。游標是不透明的且綁定於排序鍵，因此在某個 order_by 值下發出的 after_id 在另一個值下會被以 400 錯誤拒絕。時間篩選界限也必須與排序鍵相符：updated_at.* 界限搭配 order_by=updated_at，created_at.* 界限搭配預設的 order_by=created_at。不支援以 before_id 向後分頁，且 project_ids[] 篩選器不可用。完整篩選器參考請見列出聊天。
若要改為將清單範圍限定於特定使用者（例如，對指定保管人的法律保留），請傳入 1–10 個 user_ids[] 值。請從列出組織使用者取得這些 ID。依使用者篩選的查詢一律依 created_at 排序（傳入 order_by=updated_at 會回傳 400 錯誤），並同時支援 after_id 與 before_id。依 project_ids[] 篩選僅在此依使用者篩選的形式中可用。將 user_ids[] 與任何 updated_at.* 界限結合使用已被棄用，並將於 2026-09-22 之後以 400 錯誤拒絕；若要依更新時間讓保管人集合保持最新，請執行不含 user_ids[] 的全組織 order_by=updated_at 走訪，並從其結果中選出保管人的聊天，而將依使用者篩選的清單保留給依 created_at 排序的匯出。
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 "created_at.gte=2025-06-01T00:00:00Z" \
--data-urlencode "limit=100"清單回應僅包含聊天中繼資料。若要取得實際的聊天內容、附加檔案及內嵌 artifacts（Claude 在聊天中產生的結構化文件），請針對每個聊天 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"訊息端點會回傳聊天的中繼資料，以及依 created_at 排序的 chat_messages 陣列。省略 limit 時，完整訊息集會在單一回應中回傳；傳入 limit、after_id 或 before_id 可逐頁瀏覽非常長的聊天。此端點也接受 created_at.* 與 updated_at.* 範圍界限（gt、gte、lt、lte）以及 order 參數（asc 或 desc）。完整參數清單請見取得聊天訊息。對於使用者訊息，created_at 是訊息送出的時間；對於助理訊息，則是 Claude 完成產生該訊息的時間。每則訊息都包含其文字內容，以及（若存在）任何上傳的檔案（通常在使用者訊息上）、任何工具產生的檔案，以及助理產生或更新的任何 artifacts（通常在助理訊息上）：
{
"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-5",
"organization_uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
"project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq",
"user": {
"id": "user_01XyDMpzjS89pFZXqSFUBDr6",
"email_address": "user@example.com"
},
"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",
"size_bytes": 482133,
"md5": "56367e4d2705cc9c025ad07424e944f0",
"created_at": "2026-04-10T08:09:10Z"
}
]
},
{
"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",
"size_bytes": 2048,
"md5": "89968669461d95416549937168269d6b"
}
],
"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、圖片、試算表、文件及貼上的文字），以 claude.ai 儲存的形式呈現。generated_files 是助理在對話期間透過工具使用所建立的二進位檔案（例如 PDF、試算表或簡報）。artifacts 是助理在其回應中產生或更新的版本化文件（例如程式碼或 markdown）；一個 artifact 可在同一聊天的多個助理回合中被修訂，每次修訂都會以同一 artifact id 下的新 version_id 出現。將每個項目的 id（artifacts 則為 version_id）傳入擷取檔案與 artifacts 中對應的內容端點即可下載。
擷取檔案與 artifacts
檔案與 artifacts 是依 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_* ID | 單一 artifact 版本的文字 | 下載 artifact 內容 |
claude_artifact_version_* ID | 僅 artifact 版本的中繼資料 | 取得 artifact 中繼資料 |
claude_proj_doc_* ID | 專案文件的純文字內容 | 取得專案文件內容 |
claude_proj_doc_* ID | 僅專案文件的中繼資料 | 取得專案文件中繼資料 |
檔案內容端點會以分塊二進位回應的形式串流 claude.ai 為該檔案儲存的內容。該內容不一定與使用者上傳的檔案完全相同。圖片可能以處理過的副本而非上傳的位元組提供。某些附加至聊天的文件（例如 Word 檔案、PowerPoint 檔案及部分 PDF）是以 claude.ai 從中擷取的文字儲存。對於這些文件，端點會以原始檔名回傳擷取的文字，而原始文件無法透過 Compliance API 取得。size_bytes 與 md5 欄位描述的是儲存的內容而非上傳的檔案。檔名與 mime_type 仍可能標示上傳文件的格式。請從回傳的位元組判斷檔案格式，而非從其名稱或宣告的類型。
回應包含以下標頭：
Content-Disposition: attachment; filename*=utf-8''<percent-encoded filename>以 RFC 5987 擴充形式攜帶原始上傳檔名。擴充形式用於每個檔名，而不僅限於非 ASCII 檔名。Content-Type攜帶為儲存內容記錄的 MIME 類型，對於以擷取文字儲存的文件，仍可能標示原始文件格式。Content-MD5攜帶所提供位元組的 MD5 摘要，依 RFC 1864 規定以 base64 編碼。Transfer-Encoding: chunked一律設定。
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 中的檔名儲存回應，也就是使用者上傳的原始檔名。
artifact 內容端點會回傳單一 artifact 版本的文字主體。請傳入助理訊息 artifacts 陣列中某個項目的 version_id，而非 artifact 的穩定 id。artifact 的每個新版本都有自己的 version_id，Compliance API 會提供該版本的確切位元組。
擷取專案與附件
專案將相關聊天與自訂指示、知識庫內容及附加的檔案或文字文件組合在一起。Compliance API 公開專案中繼資料、專案詳細資訊，以及屬於某專案的附件清單。
專案結果依建立日期遞增排序。附件結果依 created_at 遞增排序，相同值時以 id 決定順序。專案清單與附件清單回應以不透明的 next_page 頁面權杖分頁，而非聊天與 Activity Feed 所使用的 first_id/last_id 游標。請在下一個請求中將該權杖作為 page 查詢參數傳回。
專案檔案與專案文件的差異
專案附件是兩種不同形態之一，由每個項目上的 type 鑑別器識別：
type 為 project_file 的項目是檔案上傳（PDF、圖片、試算表），其 ID 以 claude_file_ 開頭；請使用下載檔案內容下載。type 為 project_doc 的項目是純文字文件（一律為 text/plain），其 ID 以 claude_proj_doc_ 開頭，包括 Word 檔案等在加入專案時由 claude.ai 轉換為文字的文件；請使用取得專案文件內容擷取。
走訪附件清單的使用端必須依 type 分支，並為每個項目呼叫對應的內容端點。以下請求列出一頁附件；請將 next_page 作為 page 參數傳回以進行分頁，直到 has_more 為 false。
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"{
"data": [
{
"id": "claude_file_01UaT9wBcDfGhJkLmNpQrSv7",
"created_at": "2026-04-10T08:09:10Z",
"filename": "dashboard_mockup_v1.pdf",
"mime_type": "application/pdf",
"size_bytes": 482133,
"md5": "56367e4d2705cc9c025ad07424e944f0",
"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 公開聊天、檔案、專案文件及整個專案的硬刪除端點。硬刪除的聊天無法還原，且之後不再出現在清單回應中。
- 刪除聊天：同時移除聊天的訊息及附加至這些訊息的任何檔案。
- 刪除檔案：同時處理聊天檔案與專案檔案。
- 刪除專案文件：依 ID 移除單一專案文件。
- 刪除專案：請見刪除專案前先分離聊天。
這四個端點都需要 delete:compliance_user_data 範圍，該範圍在建立 Compliance Access Key 時與讀取範圍分開授予。
以下請求刪除一個聊天。相同模式適用於其他刪除端點；僅 URL 不同。
# 警告：此操作會永久刪除該聊天、其所有訊息，
# 以及任何附加的檔案。刪除會立即生效且無法復原。此操作
# 需要 `delete:compliance_user_data` 範圍，該範圍在建立 Compliance Access Key 時
# 與 `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"{
"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} 列出專案的聊天（project_ids[] 篩選器需要至少一個 user_ids[] 值；請透過列出組織使用者列舉 ID），以 DELETE /v1/compliance/apps/chats/{claude_chat_id} 逐一刪除（或從 claude.ai 將其移出專案），然後重試專案刪除。
後續步驟
每個聊天、檔案、專案及 artifact 端點的完整請求與回應結構描述。
列出您的使用者在 Claude 應用程式與代理程式（例如 Cowork 與 Claude Code）中執行的工作階段，並擷取其逐字稿。
列舉與本頁聊天及專案相關的人員與團隊。
Was this page helpful?