本页面上的端点用于检索和删除 claude.ai 内容,仅适用于 Claude Enterprise 组织,这些组织可以自助访问 Compliance API。请参阅设置 Compliance API。
所需范围: Compliance Access Key 上的 read:compliance_user_data。删除端点还需要 delete:compliance_user_data。
前提条件: 在组织范围内列出聊天无需任何前提条件。要将聊天列表筛选到特定用户,您需要从列出组织用户获取用户 ID。本页面上的其他端点直接接受资源 ID。
本页面上的端点向合规审查人员公开 claude.ai 聊天内容、文件上传、项目和项目附件。它们支持 eDiscovery(电子取证)导出、数据丢失防护(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 可以在同一聊天的多个助手回合中被修订,每次修订都会在同一 artifact id 下显示为一个新的 version_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?