本頁面的端點會擷取和刪除 claude.ai 內容,僅適用於 Claude Enterprise 組織,這些組織可自助存取 Compliance API。請參閱設定 Compliance API。
必要範圍: Compliance Access Key 上的 read:compliance_user_data。刪除端點還需要 delete:compliance_user_data。
先決條件: 列出整個組織的聊天時無需任何先決條件。若要將聊天清單篩選至特定使用者,您需要從列出組織使用者取得使用者 ID。本頁面的其他端點直接接受資源 ID。
本頁面的端點向合規審查人員公開 claude.ai 聊天內容、檔案上傳、專案和專案附件。它們支援 eDiscovery(電子蒐證)匯出、「data loss prevention」(資料外洩防護),即 DLP 的執行,以及帳戶刪除回應。內容會依照您組織的保留政策允許的期間保留。使用者在 claude.ai 中軟刪除的聊天仍可透過 Compliance API 查看,且 deleted_at 會有值;已被硬刪除的聊天(透過 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 以依最後更新時間排序。這種組合是匯出聊天並保持匯出為最新狀態的建議方式,因為一個分頁迴圈就能取得每位使用者的新聊天和已修改的聊天,而無需先列舉使用者。以下請求列出自指定日期以來更新的聊天。
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": "[email protected]"
}
}
],
"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 排序,在您儲存的游標之後發生變更的聊天會重新出現在游標之前,因此每次增量執行都會回傳全新的聊天以及之後被修改過的較舊聊天。請以聊天 id 為鍵,以冪等方式處理結果,以處理這些重新出現的情況。
這些整個組織範圍的查詢有一些限制。游標是不透明的且綁定於排序鍵,因此在某個 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[] 篩選僅在此使用者篩選形式中可用。
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": "[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 是助理在其回應中產生或更新的版本化文件(例如程式碼或 markdown);一個 artifact 可以在同一個聊天的多個助理回合中被修訂,每次修訂都會以新的 version_id 出現在同一個 artifact id 之下。將每個項目的 id(artifacts 則為 version_id)傳入擷取檔案和 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 | 僅專案文件的中繼資料 | 取得專案文件中繼資料 |
檔案內容端點會以分塊二進位回應串流原始上傳檔案,並帶有以下標頭:
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_ 開頭;使用取得專案文件內容擷取它們。
走訪附件清單的消費端必須依 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",
"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 會有值)。
這四個端點都需要 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 將其移出專案),然後重試專案刪除。
Was this page helpful?