Files

获取文件元数据

get /v1/compliance/apps/chats/files/{claude_file_id}

获取聊天消息中引用的文件的元数据，但不下载文件内容。使用同级 /content 端点下载文件字节。

路径参数

claude_file_id: string

文件 ID（带标签的 ID，例如 claude_file_abc123）

请求头参数

"x-api-key": optional string

返回值

id: string

文件 ID
created_at: string

文件创建时间戳
filename: string

文件的显示名称（如已设置）
md5: string

文件首选可下载变体的小写十六进制 MD5，上传时记录。如果没有可用的存储哈希值，则为 null。同级 /content 端点还会设置一个 Content-MD5 请求头（按 RFC 1864 进行 base64 编码），基于实际提供的字节计算；当两者不一致时，以请求头为准。
message_ids: array of string

此文件附加到的聊天消息 ID。一个文件可以被多条消息引用。
mime_type: string

文件首选可下载变体的 MIME 类型（例如 'application/pdf'）。对于没有可下载内容的文件（例如代码解释器输出），可能为 null。
size_bytes: number

文件首选可下载变体的字节大小（如已知）

示例

curl https://api.anthropic.com/v1/compliance/apps/chats/files/$CLAUDE_FILE_ID \
    -H "Authorization: Bearer $ANTHROPIC_COMPLIANCE_API_KEY"

响应

{
  "id": "claude_file_xyz789",
  "filename": "quarterly_report.pdf",
  "mime_type": "application/pdf",
  "size_bytes": 1048576,
  "md5": "5d41402abc4b2a76b9719d911017c592",
  "created_at": "2024-01-15T10:30:00Z",
  "message_ids": [
    "claude_chat_msg_abc123"
  ]
}

删除文件

delete /v1/compliance/apps/chats/files/{claude_file_id}

永久删除特定文件。此操作为破坏性操作，无法撤销。

路径参数

claude_file_id: string

文件 ID（带标签的 ID，例如 claude_file_abc123）

请求头参数

"x-api-key": optional string

返回值

id: string

已删除文件的 ID
type: optional "claude_file_deleted"

确认删除的常量字符串
- "claude_file_deleted"

示例

curl https://api.anthropic.com/v1/compliance/apps/chats/files/$CLAUDE_FILE_ID \
    -X DELETE \
    -H "Authorization: Bearer $ANTHROPIC_COMPLIANCE_API_KEY"

响应

{
  "id": "claude_file_xyz789",
  "type": "claude_file_deleted"
}

下载文件内容

get /v1/compliance/apps/chats/files/{claude_file_id}/content

下载聊天消息中引用的文件的二进制内容。

路径参数

claude_file_id: string

文件 ID（带标签的 ID，例如 claude_file_abc123）

请求头参数

"x-api-key": optional string

示例

curl https://api.anthropic.com/v1/compliance/apps/chats/files/$CLAUDE_FILE_ID/content \
    -H "Authorization: Bearer $ANTHROPIC_COMPLIANCE_API_KEY"

领域类型

File Retrieve Response

FileRetrieveResponse object { id, created_at, filename, 4 more }

GET /v1/compliance/apps/chats/files/{claude_file_id} 的文件元数据。

仅返回元数据。使用同级 /content 端点下载文件字节。
- id: string
  
  文件 ID
- created_at: string
  
  文件创建时间戳
- filename: string
  
  文件的显示名称（如已设置）
- md5: string
  
  文件首选可下载变体的小写十六进制 MD5，上传时记录。如果没有可用的存储哈希值，则为 null。同级 /content 端点还会设置一个 Content-MD5 请求头（按 RFC 1864 进行 base64 编码），基于实际提供的字节计算；当两者不一致时，以请求头为准。
- message_ids: array of string
  
  此文件附加到的聊天消息 ID。一个文件可以被多条消息引用。
- mime_type: string
  
  文件首选可下载变体的 MIME 类型（例如 'application/pdf'）。对于没有可下载内容的文件（例如代码解释器输出），可能为 null。
- size_bytes: number
  
  文件首选可下载变体的字节大小（如已知）

File Delete Response

FileDeleteResponse object { id, type }

删除合规文件的响应。
- id: string
  
  已删除文件的 ID
- type: optional "claude_file_deleted"
  
  确认删除的常量字符串
  - "claude_file_deleted"