English ← MyDocs

Chats

列出聊天记录

get /v1/compliance/apps/chats

列出聊天元数据，支持过滤功能以便进行针对性的合规审查。结果按 created_at 时间顺序（升序）排列，相同时间按 id 排序。

查询参数

  • user_ids: array of string

    按特定用户创建的聊天进行过滤。必填；每次请求传入 1-10 个用户 ID。可通过 GET /v1/compliance/organizations/{org_uuid}/users 枚举 ID。

  • after_id: optional string

    分页游标，用于获取下一页结果（向时间更早的方向翻页）。要翻页时，请传入最近一次响应中的 last_id 值。客户端应将此值视为不透明字符串，不要尝试解析或解释其内容，因为格式可能会在不另行通知的情况下更改。

  • before_id: optional string

    分页游标，用于获取上一页结果（向时间更晚的方向翻页）。要翻页时，请传入最近一次响应中的 first_id 值。客户端应将此值视为不透明字符串，不要尝试解析或解释其内容，因为格式可能会在不另行通知的情况下更改。

  • created_at: optional object { gt, gte, lt, lte }

    • gt: optional string

      过滤在此时间之后创建的聊天（RFC 3339 格式）

    • gte: optional string

      过滤在此时间或之后创建的聊天（RFC 3339 格式）

    • lt: optional string

      过滤在此时间之前创建的聊天（RFC 3339 格式）

    • lte: optional string

      过滤在此时间或之前创建的聊天（RFC 3339 格式）

  • limit: optional number

    最大结果数（默认：100，最大：1000）

  • organization_ids: optional array of string

    按组织 ID 过滤（接受 org_... 或组织 UUID）。可通过 GET /v1/compliance/organizations 枚举 ID。

  • project_ids: optional array of string

    按项目 ID 过滤（接受 claude_proj_...）。可通过 GET /v1/compliance/apps/projects 枚举 ID。

  • updated_at: optional object { gt, gte, lt, lte }

    • gt: optional string

      过滤在此时间之后更新的聊天（RFC 3339 格式）

    • gte: optional string

      过滤在此时间或之后更新的聊天（RFC 3339 格式）

    • lt: optional string

      过滤在此时间之前更新的聊天（RFC 3339 格式）

    • lte: optional string

      过滤在此时间或之前更新的聊天（RFC 3339 格式）

请求头参数

  • "x-api-key": optional string

返回值

  • data: array of object { id, created_at, deleted_at, 8 more }

    按 created_at 时间顺序排列的聊天元数据列表，相同时间按 id 排序

    • id: string

      聊天 ID

    • created_at: string

      创建时间戳

    • deleted_at: string

      如果已删除，则为删除时间戳

    • href: string

      在 claude.ai 中查看此聊天的 URL

    • model: string

      此聊天选择的模型（例如 'claude-opus-4-7'）。对于从未记录过模型的旧版聊天，可能为 null。

    • name: string

      聊天名称/标题

    • organization_id: string

      此聊天所属的组织 ID

    • organization_uuid: string

      此聊天所属的组织 UUID

    • project_id: string

      此聊天所属的项目 ID

    • updated_at: string

      最后更新时间戳

    • user: object { id, email_address }

      聊天创建者的用户信息

      • id: string

        用户标识符

      • email_address: string

        用户的电子邮件地址

  • first_id: string

    当前结果集中的第一个聊天 ID。要获取上一页，请在下一次请求中将其用作 before_id

  • has_more: boolean

    当前结果集之外是否还有更多记录

  • last_id: string

    当前结果集中的最后一个聊天 ID。要获取下一页，请在下一次请求中将其用作 after_id

示例

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

响应

{
  "data": [
    {
      "id": "claude_chat_abc123",
      "name": "Product Requirements Discussion",
      "created_at": "2025-06-07T08:09:10Z",
      "updated_at": "2025-06-07T09:10:11Z",
      "organization_id": "org_abc123",
      "organization_uuid": "abcdef0123-4567-89ab-cdef-0123456789ab",
      "project_id": "claude_proj_xyz789",
      "model": "claude-opus-4-7",
      "user": {
        "id": "user_xyz456",
        "email_address": "user@example.com"
      },
      "href": "https://claude.ai/chat/abcdef01-2345-6789-abcd-ef0123456789"
    }
  ],
  "has_more": false,
  "first_id": "claude_chat_abc123",
  "last_id": "claude_chat_abc123"
}

删除聊天

delete /v1/compliance/apps/chats/{claude_chat_id}

永久删除聊天及其所有关联消息和文件。此操作为破坏性操作，无法撤销。

路径参数

  • claude_chat_id: string

    聊天 ID（带标签的 ID，例如 claude_chat_abc123）

请求头参数

  • "x-api-key": optional string

返回值

  • id: string

    已删除的 Claude 聊天的 ID

  • type: optional "claude_chat_deleted"

    确认删除的常量字符串

    • "claude_chat_deleted"

示例

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

响应

{
  "id": "claude_chat_abc123",
  "type": "claude_chat_deleted"
}

领域类型

Chat List Response

  • ChatListResponse object { id, created_at, deleted_at, 8 more }

    用于列出聊天的聊天元数据（不含消息）。

    • id: string

      聊天 ID

    • created_at: string

      创建时间戳

    • deleted_at: string

      如果已删除，则为删除时间戳

    • href: string

      在 claude.ai 中查看此聊天的 URL

    • model: string

      此聊天选择的模型（例如 'claude-opus-4-7'）。对于从未记录过模型的旧版聊天，可能为 null。

    • name: string

      聊天名称/标题

    • organization_id: string

      此聊天所属的组织 ID

    • organization_uuid: string

      此聊天所属的组织 UUID

    • project_id: string

      此聊天所属的项目 ID

    • updated_at: string

      最后更新时间戳

    • user: object { id, email_address }

      聊天创建者的用户信息

      • id: string

        用户标识符

      • email_address: string

        用户的电子邮件地址

Chat Delete Response

  • ChatDeleteResponse object { id, type }

    删除 Claude 聊天的响应。

    • id: string

      已删除的 Claude 聊天的 ID

    • type: optional "claude_chat_deleted"

      确认删除的常量字符串

      • "claude_chat_deleted"