对象
Error
标准错误响应。detail 是字符串、带 code 的对象（例如 choose_org、org_suspended、邀请相关代码）或校验错误列表（422）。error 是结构化描述：错误码目录中的代码、英文消息、结构化详细信息和请求 ID。
字段
错误消息、带代码的对象或校验错误列表。
errorErrorInfo
使用方
- GET
/v1/health获取服务状态和版本 - GET
/v1/users列出组织的用户 - POST
/v1/users创建用户 - PATCH
/v1/users/{user_id}更新用户 - GET
/v1/api-keys列出组织的 API 密钥 - POST
/v1/api-keys创建 API 密钥 - DELETE
/v1/api-keys/{key_id}撤销 API 密钥 - PATCH
/v1/api-keys/{key_id}更新 API 密钥 - POST
/v1/api-keys/{key_id}/roll重新生成 API 密钥 - POST
/v1/api-keys/{key_id}/revoke-previous撤销 API 密钥的旧值 - GET
/v1/audit列出审计日志条目 - GET
/v1/audit/actions列出审计日志中的操作及其数量 - GET
/v1/audit/export.csv将审计日志导出为 CSV - GET
/v1/org获取组织信息 - GET
/v1/categories列出文档分类 - POST
/v1/categories创建分类 - DELETE
/v1/categories/{key}删除自定义分类 - PATCH
/v1/categories/{key}更新分类 - GET
/v1/collections列出用户可访问的合集 - POST
/v1/collections创建合集 - DELETE
/v1/collections/{name}删除合集 - PATCH
/v1/collections/{name}更新合集 - POST
/v1/collections/{name}/reindex重新索引合集 - GET
/v1/collections/{name}/stats获取合集概览：统计、分类、最近的卡片、权限 - GET
/v1/cards列出卡片 - POST
/v1/cards将文件上传为卡片 - GET
/v1/jobs列出索引作业 - GET
/v1/jobs/summary获取队列摘要 - GET
/v1/jobs/stream以流的形式获取作业变更（SSE） - GET
/v1/jobs/{job_id}获取作业 - DELETE
/v1/jobs/{job_id}取消排队中的作业 - GET
/v1/cards/count统计卡片数量 - GET
/v1/cards/export.xlsx将卡片列表导出为 XLSX - POST
/v1/cards/bulk对卡片执行批量操作 - GET
/v1/cards/{card_id}获取卡片及其版本、评论、表格和事件 - DELETE
/v1/cards/{card_id}删除卡片 - PATCH
/v1/cards/{card_id}更新卡片 - GET
/v1/cards-by-external-id/{external_id}按外部 ID 获取卡片 - PUT
/v1/cards-by-external-id/{external_id}按外部 ID 创建或替换卡片 - GET
/v1/cards/{card_id}/content按章节获取卡片正文 - PUT
/v1/cards/{card_id}/content替换卡片内容 - GET
/v1/cards/{card_id}/tables/{table_id}/rows列出事实表的行 - GET
/v1/cards/{card_id}/versions/{a}/diff/{b}比较卡片的两个版本 - GET
/v1/cards/{card_id}/usage列出回答中使用了该卡片的问题 - POST
/v1/cards/{card_id}/usage记录卡片使用事件 - POST
/v1/cards/{card_id}/reindex重新索引卡片 - DELETE
/v1/cards/{card_id}/comments/{comment_id}删除评论 - GET
/v1/cards/{card_id}/file下载卡片的原始文件 - GET
/v1/cards/{card_id}/export将卡片导出为文档 - POST
/v1/cards/{card_id}/verify确认卡片内容是最新的 - POST
/v1/cards/{card_id}/comments添加评论 - GET
/v1/conversations列出对话 - GET
/v1/conversations/{conv_id}获取对话及其轮次 - POST
/v1/search在合集中搜索 - POST
/v1/ask获取助手的回答（非流式） - POST
/v1/chat以流式返回助手的回答（SSE） - POST
/v1/questions/{question_id}/feedback为回答评分 - GET
/v1/questions/export.csv将问题日志导出为 CSV - GET
/v1/questions/{question_id}获取已保存的问题及其回答 - GET
/v1/questions/{question_id}/followups获取后续问题建议 - GET
/v1/questions列出问题日志 - GET
/v1/questions/{question_id}/export将回答导出为文档 - GET
/v1/questions/{question_id}/datasets/{dataset_id}/export导出回答中的数据集 - GET
/v1/questions/{question_id}/answer-tables/{index}/export导出回答正文中的表格 - POST
/v1/questions/{question_id}/refresh刷新回答中的数据集（实时回答） - POST
/v1/questions/{question_id}/save-card将回答保存为卡片 - POST
/v1/cards/text创建文本卡片（Markdown） - GET
/v1/files列出导出文件 - GET
/v1/files/authors列出文件作者（用于管理员筛选） - GET
/v1/files/{file_id}获取文件详情 - DELETE
/v1/files/{file_id}删除文件 - GET
/v1/files/{file_id}/download下载文件 - GET
/v1/files/{file_id}/preview预览文件 - POST
/v1/files/{file_id}/extend延长文件的保留期限 - POST
/v1/files/{file_id}/regenerate根据保存的参数重新生成文件 - GET
/v1/tasks列出用户或团队的任务 - POST
/v1/sources创建数据源 - GET
/v1/sources/{source_id}获取数据源 - DELETE
/v1/sources/{source_id}删除数据源 - PATCH
/v1/sources/{source_id}更新数据源 - PATCH
/v1/sources/{source_id}/settings更新数据源设置 - GET
/v1/cards/{card_id}/similar列出相似卡片 - GET
/v1/insights/gaps列出知识缺口（未得到回答的问题的分组） - GET
/v1/permissions列出权限注册表 - POST
/v1/uploads开始分段上传 - GET
/v1/uploads/{upload_id}获取上传 - DELETE
/v1/uploads/{upload_id}取消上传 - PUT
/v1/uploads/{upload_id}/parts/{n}发送上传分段 - POST
/v1/uploads/{upload_id}/complete完成上传 - GET
/v1/me获取 API 调用方 - GET
/v1/me/permissions获取当前用户在组织上的权限 - GET
/v1/roles列出角色（内置和自定义） - POST
/v1/roles创建自定义角色 - DELETE
/v1/roles/{role_id}删除自定义角色 - PATCH
/v1/roles/{role_id}更新自定义角色 - GET
/v1/groups列出组织的用户组 - POST
/v1/groups创建用户组 - GET
/v1/groups/{group_id}获取用户组及其成员 - DELETE
/v1/groups/{group_id}删除用户组 - PATCH
/v1/groups/{group_id}重命名用户组 - PUT
/v1/groups/{group_id}/members/{user_id}向用户组添加成员 - DELETE
/v1/groups/{group_id}/members/{user_id}从用户组移除成员 - GET
/v1/org/permissions获取组织上的权限（谁是管理员） - PUT
/v1/org/permissions授予组织上的角色 - DELETE
/v1/org/permissions撤销组织上的角色 - GET
/v1/collections/{name}/permissions获取合集上的权限（直接授予和继承） - PUT
/v1/collections/{name}/permissions授予合集上的角色 - DELETE
/v1/collections/{name}/permissions撤销合集上的角色 - GET
/v1/cards/{card_id}/permissions获取卡片上的权限（直接授予和继承） - PUT
/v1/cards/{card_id}/permissions授予卡片上的角色 - DELETE
/v1/cards/{card_id}/permissions撤销卡片上的角色 - GET
/v1/sources/{source_id}/permissions获取数据源上的权限（直接授予和继承） - PUT
/v1/sources/{source_id}/permissions授予数据源上的角色 - DELETE
/v1/sources/{source_id}/permissions撤销数据源上的角色 - POST
/v1/users/{user_id}/offboard为用户办理离职交接 - GET
/v1/collections/{name}/folders获取合集的文件夹树 - POST
/v1/collections/{name}/folders创建文件夹 - GET
/v1/folders获取所有合集的文件夹树 - GET
/v1/folders/{folder_id}获取文件夹 - DELETE
/v1/folders/{folder_id}删除文件夹并上移其内容 - PATCH
/v1/folders/{folder_id}重命名、移动文件夹或调整其顺序 - GET
/v1/folders/{folder_id}/cards列出文件夹中的卡片 - GET
/v1/folders/{folder_id}/permissions获取文件夹上的权限（直接授予和继承） - PUT
/v1/folders/{folder_id}/permissions授予文件夹上的角色 - DELETE
/v1/folders/{folder_id}/permissions撤销文件夹上的角色 - GET
/v1/catalog/services列出目录中的服务 - GET
/v1/catalog/services/{service_id}获取目录中的服务 - GET
/v1/catalog/services/{service_id}/icon获取服务的图标 - GET
/v1/catalog/categories列出目录分类 - GET
/v1/catalog/spend-taxonomy获取收支分类体系 - POST
/v1/catalog/resolve将名称与目录中的服务匹配 - GET
/v1/drafts列出草稿 - POST
/v1/drafts创建草稿 - GET
/v1/drafts/{draft_id}获取草稿 - PATCH
/v1/drafts/{draft_id}更新草稿 - POST
/v1/drafts/{draft_id}/request-publish申请发布 - POST
/v1/drafts/{draft_id}/approve批准发布 - GET
/v1/tags列出组织的卡片标签 - POST
/v1/cards/archive上传文档压缩包 - GET
/v1/archives/{job_id}获取压缩包解压作业 - GET
/v1/cards/{card_id}/verification获取卡片的核实信息 - POST
/v1/cards/{card_id}/verification/verify核实卡片 - POST
/v1/cards/{card_id}/verification/unverify撤销可信状态或提醒核实人 - PUT
/v1/cards/{card_id}/verification/verifiers设置卡片的核实人 - PUT
/v1/cards/{card_id}/verification/interval更改核实类型和截止日期 - GET
/v1/verification/queue获取核实队列 - GET
/v1/collections/{name}/trust获取合集的可信度评分（Trust Score） - GET
/v1/org/trust获取组织的可信度评分（Trust Score） - GET
/v1/announcements列出公告 - POST
/v1/announcements发送必读公告 - GET
/v1/announcements/{announcement_id}获取公告 - GET
/v1/announcements/{announcement_id}/stats获取公告报告 - POST
/v1/announcements/{announcement_id}/remind提醒尚未阅读的人 - GET
/v1/cards/{card_id}/threads列出卡片的评论串 - POST
/v1/cards/{card_id}/threads添加评论或在评论串中回复 - DELETE
/v1/cards/{card_id}/threads/{comment_id}删除评论及其回复 - PATCH
/v1/cards/{card_id}/threads/{comment_id}编辑正文、将评论串标记为已解决或重新打开 - GET
/v1/openapi-public.json获取公开的 OpenAPI 规范 - GET
/v1/webhooks列出组织的 Webhook - POST
/v1/webhooks创建 Webhook - GET
/v1/webhooks/catalog列出事件类型 - GET
/v1/webhooks/{webhook_id}获取 Webhook - DELETE
/v1/webhooks/{webhook_id}删除 Webhook - PATCH
/v1/webhooks/{webhook_id}更新 Webhook - POST
/v1/webhooks/{webhook_id}/test发送测试事件 - POST
/v1/webhooks/{webhook_id}/rotate-secret轮换签名密钥 - POST
/v1/webhooks/{webhook_id}/revoke-previous-secret撤销旧的签名密钥 - POST
/v1/webhooks/{webhook_id}/resume恢复 Webhook - POST
/v1/webhooks/{webhook_id}/redeliver重新投递某个时间段的投递 - GET
/v1/webhooks/{webhook_id}/attempts列出投递尝试 - GET
/v1/webhooks/{webhook_id}/deliveries列出 Webhook 的投递 - GET
/v1/webhooks/{webhook_id}/deliveries/{delivery_id}获取投递及其正文和尝试 - POST
/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/redeliver重新投递事件 - GET
/v1/webhook-events列出事件 - GET
/v1/webhook-events/{event_id}获取事件 - GET
/v1/api-usage获取 API 用量 - GET
/v1/api-logs列出 API 请求 - GET
/v1/api-logs/{request_id}获取 API 请求 - GET
/v1/apps列出 OAuth 应用 - POST
/v1/apps创建 OAuth 应用 - GET
/v1/apps/{app_id}获取 OAuth 应用 - DELETE
/v1/apps/{app_id}删除 OAuth 应用 - PATCH
/v1/apps/{app_id}更新 OAuth 应用 - POST
/v1/apps/{app_id}/rotate-secret轮换客户端密钥 - GET
/v1/app-authorizations列出应用授权 - DELETE
/v1/app-authorizations/{authorization_id}撤销员工授权 - GET
/v1/analytics/health获取知识健康度仪表板 - GET
/v1/analytics/usage获取使用情况仪表板 - GET
/v1/analytics/contribution获取贡献仪表板 - GET
/v1/analytics/cards/{card_id}获取卡片指标 - GET
/v1/audit/verify验证组织审计日志的完整性 - POST
/v1/users/import从 CSV 导入用户 - GET
/v1/quality/gaps/followups列出正在处理的知识缺口 - POST
/v1/quality/gaps/followups着手处理知识缺口 - PATCH
/v1/quality/gaps/followups/{followup_id}更新正在处理的知识缺口 - GET
/v1/access-requests列出自己的或收到的访问申请 - GET
/v1/access-requests/{request_id}为审批人获取访问申请 - POST
/v1/access-requests/{request_id}/grant按申请授予访问权限 - POST
/v1/access-requests/{request_id}/deny拒绝访问 - POST
/v1/finance/report获取财务汇总报告 - POST
/v1/finance/report/export导出财务汇总报告 - POST
/v1/finance/invoices列出发票 - POST
/v1/finance/invoices/export导出发票列表 - POST
/v1/finance/payments列出付款 - POST
/v1/finance/payments/export导出付款列表 - GET
/v1/sources/{source_id}/push-keys列出自定义数据源的 API 密钥 - POST
/v1/sources/{source_id}/push-keys为自定义数据源创建 API 密钥 - DELETE
/v1/sources/{source_id}/push-keys/{key_id}撤销自定义数据源的 API 密钥 - GET
/v1/sources/{source_id}/push-syncs列出自定义数据源的同步 - GET
/v1/push/sources/{source_id}检查密钥并获取自定义数据源的状态 - POST
/v1/push/sources/{source_id}/syncs打开同步 - GET
/v1/push/sources/{source_id}/syncs/{sync_number}获取同步 - GET
/v1/push/sources/{source_id}/syncs/{sync_number}/documents列出同步中各文档的结果 - POST
/v1/push/sources/{source_id}/syncs/{sync_number}/close关闭同步 - POST
/v1/push/sources/{source_id}/syncs/{sync_number}/touch确认文档而不重新发送 - POST
/v1/push/sources/{source_id}/documents发送文档（创建或替换） - POST
/v1/push/sources/{source_id}/documents/batch批量发送文档 - GET
/v1/push/sources/{source_id}/documents/{external_id}获取文档的结果 - DELETE
/v1/push/sources/{source_id}/documents/{external_id}删除文档