OpenMax
免费试用

Scopes

应用能申请的全部 scope。

应用能申请的 scope 共 88 个,下表按领域分组。名字格式是 领域:资源:动作。怎么申请、怎么算实际权限、敏感级别,见调用平台能力。

  • 用途:「调用接口」= 调 Apps API;「订阅事件」= 收事件推送;「仅应用」= 不对应任何接口,作用在换令牌上(例如 offline_access 让换令牌时多发 refresh token,见调用平台能力)。
  • 每个接口需要哪个 scope:下表「覆盖的接口」一列链到 Apps API 参考里要这个 scope 的接口;那边每个接口也写了它要的 scope。标题和说明取自平台的 scope 清单。

agents

Scope 标题和说明 用于 覆盖的接口
agents:activity:read 接收 Agent 执行过程事件 agent_activity 帧(仅会话人类成员) 订阅事件 —
agents:agent:read 查看 Agent Agent 资料、能力标签词表、平台 Agent 运行状态 / 域名 / 时区 / 模型目录、我在开通中的 Agent 调用接口 GET /api/v1/agent-profiles
GET /api/v1/me/provisioning-agents
GET /api/v1/platform-agents/domain-availability
GET /api/v1/platform-agents/domain-config
GET /api/v1/platform-agents/model-catalog
GET /api/v1/platform-agents/operational-states
GET /api/v1/platform-agents/timezones
GET /api/v1/platform-agents/{identity_id}/domain
GET /api/v1/vocabularies/capability-tags
agents:agent:write 修改 Agent 资料 设置能力标签 调用接口 PUT /api/v1/agents/{member_id}/avatar
PUT /api/v1/agents/{member_id}/capability-tags
agents:app_token:exchange 代 Agent 换应用令牌 仅应用:Agent 主人在应用里同意后,应用登记 / 撤销对该 Agent 的授权(POST / DELETE /api/v1/app-agent-grants);Agent 用自己的身份换取 15 分钟的应用访问令牌(POST /api/v1/app-agent-tokens,不签发 refresh token,权限不超过 Agent 自身角色) 调用接口 POST /api/v1/app-agent-grants
DELETE /api/v1/app-agent-grants/{grant_id}
agents:app_token:read 查看 Agent 应用授权 仅应用:查看本应用在本组织内对各 Agent 的授权状态(有效 / 已失效及原因,GET /api/v1/app-agent-grants) 调用接口 GET /api/v1/app-agent-grants
agents:channel:read 查看 IM 渠道 Agent 渠道列表与绑定状态 调用接口 GET /api/v1/agents/{agent_member_id}/channels
GET /api/v1/agents/{agent_member_id}/channels/{channel_type}/status
agents:channel:write 绑定 IM 渠道 扫码绑定、注册、连接 / 断开、更新渠道凭据、确认渠道连接 调用接口 POST /api/v1/agents/{agent_member_id}/channels/dingtalk/scan
POST /api/v1/agents/{agent_member_id}/channels/dingtalk/scan/poll
POST /api/v1/agents/{agent_member_id}/channels/feishu/scan
POST /api/v1/agents/{agent_member_id}/channels/feishu/scan/poll
POST /api/v1/agents/{agent_member_id}/channels/lark/scan
POST /api/v1/agents/{agent_member_id}/channels/lark/scan/poll
POST /api/v1/agents/{agent_member_id}/channels/wecom/scan
POST /api/v1/agents/{agent_member_id}/channels/wecom/scan/poll
POST /api/v1/agents/{agent_member_id}/channels/whatsapp_business/registration
POST /api/v1/agents/{agent_member_id}/channels/whatsapp_business/registration/code
POST /api/v1/agents/{agent_member_id}/channels/{channel_type}/bind
POST /api/v1/agents/{agent_member_id}/channels/{channel_type}/connect
PATCH /api/v1/agents/{agent_member_id}/channels/{channel_type}/credentials
POST /api/v1/agents/{agent_member_id}/channels/{channel_type}/disconnect
POST /api/v1/channel-connection-confirmations/{confirmation_id}/confirm
agents:collaboration:read 查看 Agent 协作会话 Agent 协作会话与消息 调用接口 GET /api/v1/agents/{agent_member_id}/collab-conversations
GET /api/v1/agents/{agent_member_id}/collab-conversations/{conversation_id}/messages
agents:collaboration:write 开关协作观察 打开 / 关闭协作会话观察 调用接口 DELETE /api/v1/agents/{agent_member_id}/collab-conversations/{conversation_id}/observation
POST /api/v1/agents/{agent_member_id}/collab-conversations/{conversation_id}/observation
agents:model:read 查看模型配置 Agent 模型配置 调用接口 GET /api/v1/agents/{member_id}/model-config
agents:model:write 修改模型配置 切换模型、模型可见性 调用接口 PATCH /api/v1/agents/{member_id}/model-config
PATCH /api/v1/agents/{member_id}/model-visibility
agents:policy:read 查看 Agent 策略 私聊 / 群策略与变更状态 调用接口 POST /api/v1/agents/batch-dm-eligibility
GET /api/v1/agents/{agent_member_id}/policy
GET /api/v1/agents/{agent_member_id}/policy-changes/{change_id}
agents:policy:write 修改 Agent 策略 私聊 / 群策略、群内模式与 allow-from 调用接口 PATCH /api/v1/agents/{agent_member_id}/policy
PUT /api/v1/conversations/{conversation_id}/agents/{agent_member_id}/allow-from
PUT /api/v1/conversations/{conversation_id}/agents/{agent_member_id}/mode
agents:runtime:control 控制 Agent 运行 重启 / 暂停 / 恢复 / 打断 调用接口 POST /api/v1/agents/{member_id}/runtime/interrupt
POST /api/v1/agents/{member_id}/runtime/pause
POST /api/v1/agents/{member_id}/runtime/restart
POST /api/v1/agents/{member_id}/runtime/resume
agents:runtime:read 查看运行指标 Agent 运行指标 调用接口 GET /api/v1/agents/{member_id}/runtime-metrics

apps

Scope 标题和说明 用于 覆盖的接口
apps:badge:write 在 Workspace 显示角标 仅应用:应用后端为本组织成员设置应用入口上的数字或小红点(只对该成员本人可见) 调用接口 PUT /api/v1/app-badges

automations

Scope 标题和说明 用于 覆盖的接口
automations:binding:read 查看自动化 事件绑定列表 / 详情 / 执行记录 / 运行记录、触发时间预览、授权提案预览与状态、Agent 可用性检查 调用接口 GET /api/v1/agents/{member_id}/automation-creation-eligibility
POST /api/v1/automation-authorizations/preview
GET /api/v1/automation-authorizations/proposals/{message_id}
GET /api/v1/event-bindings
POST /api/v1/event-bindings/preview
GET /api/v1/event-bindings/{event_binding_id}
GET /api/v1/event-bindings/{event_binding_id}/changes
GET /api/v1/event-bindings/{event_binding_id}/occurrences
GET /api/v1/event-bindings/{event_binding_id}/runs
automations:binding:write 管理自动化 创建 / 修改 / 删除 / 暂停 / 恢复 / 立即运行,发送授权确认、创建 / 更新交接 调用接口 POST /api/v1/automation-authorizations/proposals
POST /api/v1/automation-creation-handoffs
POST /api/v1/automation-update-handoffs
POST /api/v1/event-bindings
DELETE /api/v1/event-bindings/{event_binding_id}
PUT /api/v1/event-bindings/{event_binding_id}
POST /api/v1/event-bindings/{event_binding_id}/pause
POST /api/v1/event-bindings/{event_binding_id}/resume
POST /api/v1/event-bindings/{event_binding_id}/run
PATCH /api/v1/event-bindings/{event_binding_id}/title
automations:webhook:read 查看 Webhook Webhook 配置、投递记录 调用接口 GET /api/v1/webhooks/{event_binding_id}
GET /api/v1/webhooks/{event_binding_id}/deliveries
GET /api/v1/webhooks/{event_binding_id}/held-events
automations:webhook:write 管理 Webhook 创建 / 修改 / 重投 / 轮换 Webhook(创建与轮换返回 webhook_url 凭据) 调用接口 POST /api/v1/webhooks
PUT /api/v1/webhooks/{event_binding_id}
POST /api/v1/webhooks/{event_binding_id}/deliveries/{delivery_id}/retry
POST /api/v1/webhooks/{event_binding_id}/held-events/decision
POST /api/v1/webhooks/{event_binding_id}/rotate

billing

Scope 标题和说明 用于 覆盖的接口
billing:invoice:read 查看发票 发票申请、可开票订单、开票汇总、发票下载句柄 调用接口 GET /api/v1/billing/invoice-profile
GET /api/v1/billing/invoice/applications
GET /api/v1/billing/invoice/applications/{id}
GET /api/v1/billing/invoice/applications/{id}/artifact
GET /api/v1/billing/invoice/invoiceable-orders
GET /api/v1/billing/invoice/summary
billing:order:read 查看订单 订单列表 / 详情 / 结果 / 分期、续付句柄、账单 调用接口 GET /api/v1/billing/invoices
GET /api/v1/billing/orders
GET /api/v1/billing/orders/fate
GET /api/v1/billing/orders/{id}
GET /api/v1/billing/orders/{id}/checkout
GET /api/v1/billing/orders/{id}/installments
billing:payment_method:read 查看支付方式 已绑定支付方式(卡尾号等金融敏感信息) 调用接口 GET /api/v1/billing/payment-methods
billing:subscription:read 查看套餐 套餐状态、订阅意向、能力位、价目表、支付方式选项、Agent 计费概览 调用接口 GET /api/v1/billing/agent-overview
GET /api/v1/billing/capabilities
GET /api/v1/billing/catalog
GET /api/v1/billing/payment-options
GET /api/v1/billing/plan-state
GET /api/v1/billing/subscription/intent
billing:usage:read 查看用量与积分 用量汇总、积分流水 / 批次、Agent 额度、自动充值与余额提醒设置、附加项历史与欠费预览 调用接口 GET /api/v1/agents/{member_id}/storage
GET /api/v1/billing/addon-history
GET /api/v1/billing/addons/{id}/outstanding
GET /api/v1/billing/agent-credit-caps
GET /api/v1/billing/agents/{identity_id}/monthly-cap
GET /api/v1/billing/auto-topup-settings
GET /api/v1/billing/balance-alert-settings
GET /api/v1/billing/credit-grants
GET /api/v1/billing/credit-statement
GET /api/v1/billing/usage-summary
billing:usage_credential:read 查看用量 API 凭证 用量 API 凭证元数据(不含明文) 调用接口 GET /api/v1/billing/usage-credential

connections

Scope 标题和说明 用于 覆盖的接口
connections:action:execute 执行第三方 action 执行 action、代理调用第三方 API(泄露半径延伸到外部账号) 调用接口 POST /api/v1/connect/connections/{connection_id}/actions/execute
POST /api/v1/connect/connections/{connection_id}/proxy
connections:application:read 查看应用目录 应用列表 / 详情、action 定义、可用 action、toolkit、连接字段、OAuth 回调地址 调用接口 GET /api/v1/connect/applications
GET /api/v1/connect/applications/category-counts
POST /api/v1/connect/applications/query
GET /api/v1/connect/applications/{application_id}
GET /api/v1/connect/applications/{application_id}/action-defs
GET /api/v1/connect/applications/{application_id}/actions
GET /api/v1/connect/applications/{application_id}/actions/{action}
GET /api/v1/connect/applications/{application_id}/actions:search
GET /api/v1/connect/applications/{application_id}/toolkits
GET /api/v1/connect/applications/{application_slug}/connect-fields
GET /api/v1/connect/oauth-callback-url
connections:application:write 管理自定义应用 创建 / 修改 / 删除自定义应用与 action 定义 调用接口 POST /api/v1/connect/applications
DELETE /api/v1/connect/applications/{application_id}
PATCH /api/v1/connect/applications/{application_id}
POST /api/v1/connect/applications/{application_id}/action-defs
DELETE /api/v1/connect/applications/{application_id}/action-defs/{action_id}
PATCH /api/v1/connect/applications/{application_id}/action-defs/{action_id}
connections:connection:read 查看连接 连接列表 / 详情、连接的 action、连接授权给哪些 Agent、会话启用的连接器 调用接口 GET /api/v1/connect/agents/me/connections
POST /api/v1/connect/agents/usable-connections/query
GET /api/v1/connect/agents/{agent_member_id}/connections
GET /api/v1/connect/connections
GET /api/v1/connect/connections/{connection_id}
GET /api/v1/connect/connections/{connection_id}/actions
GET /api/v1/connect/connections/{connection_id}/agents
GET /api/v1/connect/connections:with-agents
POST /api/v1/connect/shopify-app/installs/resolve
GET /api/v1/conversations/{conversation_id}/connectors
connections:connection:write 管理连接 新建 OAuth / API Key 连接、修改、断开、重新授权、会话连接器开关 调用接口 POST /api/v1/connect/connections
POST /api/v1/connect/connections/api-key
PATCH /api/v1/connect/connections/{connection_id}
POST /api/v1/connect/connections/{connection_id}/disconnect
POST /api/v1/connect/connections/{connection_id}/reauth
POST /api/v1/connect/connections/{connection_id}/reauth/complete
POST /api/v1/connect/shopify-app/installs/claim
PATCH /api/v1/conversations/{conversation_id}/connectors/{connector_id}
connections:grant:write 授权连接给 Agent 把连接授权给 Agent / 撤销授权 调用接口 POST /api/v1/connect/connections/{connection_id}/agents
POST /api/v1/connect/connections/{connection_id}/agents/batch
DELETE /api/v1/connect/connections/{connection_id}/agents/{agent_member_id}

kb

Scope 标题和说明 用于 覆盖的接口
kb:artifact:read 解析产物链接 POST /api/v1/artifacts/resolve 调用接口 POST /api/v1/artifacts/resolve
kb:file:read 读取文件与目录树 目录树、节点、面包屑、下载、预览、批量下载 调用接口 GET /api/v1/kbs/{kb_id}/tree
POST /api/v1/kbs/{kb_id}/tree/files/batch-download
GET /api/v1/kbs/{kb_id}/tree/nodes/{node_id}
GET /api/v1/kbs/{kb_id}/tree/nodes/{node_id}/breadcrumb
GET /api/v1/kbs/{kb_id}/tree/nodes/{node_id}/children
GET /api/v1/kbs/{kb_id}/tree/nodes/{node_id}/download
GET /api/v1/kbs/{kb_id}/tree/nodes/{node_id}/preview
GET /api/v1/kbs/{kb_id}/tree/roots
kb:file:write 上传与整理文件 上传文件、新建文件 / 文件夹节点、移动、重命名 调用接口 POST /api/v1/kbs/{kb_id}/tree/files
POST /api/v1/kbs/{kb_id}/tree/folders
POST /api/v1/kbs/{kb_id}/tree/nodes/{node_id}/move
PATCH /api/v1/kbs/{kb_id}/tree/nodes/{node_id}/rename
POST /api/v1/uploads/finalize
POST /api/v1/uploads/prepare
kb:page:delete 永久删除页面 / 节点 永久删除页面、删除目录树节点 调用接口 DELETE /api/v1/kbs/{kb_id}/tree/nodes/{node_id}
DELETE /api/v1/pages/{page_id}
kb:page:read 读取页面 页面列表 / 回收站 / 元数据 / 正文 / 引用 / 版本 / 差异、页面搜索 调用接口 GET /api/v1/pages
GET /api/v1/pages/trashed
GET /api/v1/pages/{page_id}
GET /api/v1/pages/{page_id}/content
GET /api/v1/pages/{page_id}/references
GET /api/v1/pages/{page_id}/revisions
GET /api/v1/pages/{page_id}/revisions/diff
GET /api/v1/pages/{page_id}/revisions/{revision_id}
GET /api/v1/search/pages
kb:page:write 编辑页面 新建页面、改元数据 / 正文、冻结、移入 / 移出回收站、恢复版本 调用接口 POST /api/v1/kbs/{kb_id}/pages
PATCH /api/v1/pages/{page_id}
PUT /api/v1/pages/{page_id}/content
POST /api/v1/pages/{page_id}/freeze
POST /api/v1/pages/{page_id}/restore
POST /api/v1/pages/{page_id}/revisions/{revision_id}/restore
POST /api/v1/pages/{page_id}/trash
kb:space:delete 删除知识库 永久删除知识库 调用接口 DELETE /api/v1/kbs/{kb_id}
kb:space:read 查看知识库 知识库列表 / 详情 调用接口 GET /api/v1/agents/{agent_member_id}/knowledge-bases
GET /api/v1/kbs
GET /api/v1/kbs/{kb_id}
kb:space:write 管理知识库 创建 / 初始化 / 修改 / 归档 / 取消归档知识库 调用接口 POST /api/v1/kbs
POST /api/v1/kbs/init
PATCH /api/v1/kbs/{kb_id}
POST /api/v1/kbs/{kb_id}/archive
POST /api/v1/kbs/{kb_id}/unarchive

messages

Scope 标题和说明 用于 覆盖的接口
messages:card:interact 操作消息卡片 以本人身份点击卡片按钮 / 选项 / 表单(可能触发审批、自动化确认) 调用接口 POST /api/v1/messages/{message_id}/card-actions/{action_id}/interactions
POST /api/v1/messages/{message_id}/card-choices/interactions
POST /api/v1/messages/{message_id}/card-interactions
messages:conversation.member:read 查看会话成员 会话成员列表 调用接口 GET /api/v1/conversations/{conversation_id}/members
messages:conversation.member:write 管理会话成员 拉人 / 踢人(含批量) 调用接口 POST /api/v1/conversations/{conversation_id}/members
DELETE /api/v1/conversations/{conversation_id}/members/{member_id}
POST /api/v1/conversations/{conversation_id}/members:batch-add
POST /api/v1/conversations/{conversation_id}/members:batch-remove
messages:conversation.preference:write 设置个人会话偏好 免打扰、置顶、标记完成 / 未完成(只影响本人) 调用接口 POST /api/v1/conversations/{conversation_id}/done
POST /api/v1/conversations/{conversation_id}/mute
POST /api/v1/conversations/{conversation_id}/pin
POST /api/v1/conversations/{conversation_id}/undone
POST /api/v1/conversations/{conversation_id}/unmute
POST /api/v1/conversations/{conversation_id}/unpin
messages:conversation:create 创建会话 发起私聊、创建群聊 调用接口 POST /api/v1/conversations/dm
POST /api/v1/conversations/dm/subconversations
POST /api/v1/conversations/groups
POST /api/v1/conversations/{conversation_id}/subconversations
messages:conversation:read 查看会话 会话列表 / 详情 调用接口 GET /api/v1/conversations
GET /api/v1/conversations/{conversation_id}
GET /api/v1/conversations/{conversation_id}/subconversations
messages:conversation:write 管理群会话 修改群资料、解散 / 归档群、退出群 调用接口 DELETE /api/v1/conversations/{conversation_id}
PATCH /api/v1/conversations/{conversation_id}
POST /api/v1/conversations/{conversation_id}/archive
POST /api/v1/conversations/{conversation_id}/leave
PATCH /api/v1/subconversations/{subconversation_id}
POST /api/v1/subconversations/{subconversation_id}/archive
messages:message:read 读取消息 消息列表 / 详情 / 批量获取 / 会话内搜索 / 变更流 / 编辑历史 / 卡片交互记录 调用接口 GET /api/v1/conversations/{conversation_id}/changes
GET /api/v1/conversations/{conversation_id}/messages
POST /api/v1/conversations/{conversation_id}/messages/batch-get
POST /api/v1/conversations/{conversation_id}/messages/search
GET /api/v1/conversations/{conversation_id}/messages/{message_id}
GET /api/v1/conversations/{conversation_id}/resources
GET /api/v1/messages/{message_id}/card-interactions
GET /api/v1/messages/{message_id}/edits
messages:message:send 以本人身份发消息 发送消息、发起交互请求、会话附件上传 调用接口 POST /api/v1/conversations/uploads/finalize
POST /api/v1/conversations/{conversation_id}/interaction-requests
POST /api/v1/conversations/{conversation_id}/messages
POST /api/v1/conversations/{conversation_id}/uploads/prepare
messages:message:write 编辑 / 撤回本人消息 编辑、撤回自己发出的消息 调用接口 DELETE /api/v1/messages/{message_id}
PUT /api/v1/messages/{message_id}
messages:reaction:write 表情回应 添加 / 移除表情回应 调用接口 POST /api/v1/messages/{message_id}/reactions
DELETE /api/v1/messages/{message_id}/reactions/{reaction_code}
messages:read_state:read 查看已读与未读 已读游标、未读数、未读 @、增量同步状态 调用接口 GET /api/v1/conversations/{conversation_id}/read-cursors
GET /api/v1/conversations/{conversation_id}/unread
GET /api/v1/conversations/{conversation_id}/unread-mentions
GET /api/v1/sync/status
messages:read_state:write 标记已读 标记会话已读、@ 已读、同步确认 调用接口 POST /api/v1/conversations/{conversation_id}/mention-read
POST /api/v1/conversations/{conversation_id}/mention-read-all
POST /api/v1/conversations/{conversation_id}/read
POST /api/v1/sync/ack
messages:realtime:connect 建立实时连接 用短期令牌或应用用户令牌换取实时连接 ticket(POST /auth/ws-ticket);ticket 带上令牌的 scope 与到期时间,实时服务按 scope 过滤推送内容,令牌到期、Key 撤销或应用停用 / 卸载时断开连接 调用接口 POST /auth/ws-ticket
messages:sync:read 增量同步收件箱 拉取会话增量(POST /api/v1/sync) 调用接口 POST /api/v1/sync
messages:typing:read 接收输入状态事件 typing 帧 订阅事件 —

org

Scope 标题和说明 用于 覆盖的接口
offline_access 离线访问(续期) 仅应用:换 token 时同时签发 refresh token(30 天,每次刷新轮换),用户不在场时应用也能续期 仅应用 —
org:analytics:read 查看组织统计 管理员概览统计 调用接口 GET /api/v1/analytics/overview
org:invitation:accept 接受邀请 接受发给我的邀请(含邀请链接 token),加入新组织,与网页行为一致 调用接口 POST /api/v1/invitations/{invitation_id}/accept
POST /api/v1/me/invitations/{invitation_id}/accept
org:invitation:read 查看邀请 组织邀请列表、发给我的邀请 调用接口 GET /api/v1/invitations
GET /api/v1/me/invitations
org:invitation:write 管理邀请 发出邀请、撤销邀请(可邀请的角色与网页一致) 调用接口 POST /api/v1/invitations
DELETE /api/v1/invitations/{invitation_id}
org:me.email:read 在登录令牌中提供本人邮箱 仅应用:决定换 token 时 user.email 与 id_token 的 email 是否携带当前成员的登录邮箱;只作用于这两处,不限制 GET /api/v1/me(由 org:me:read 授予,按网页口径返回登录邮箱) 仅应用 —
org:me:read 查看本人基础信息 GET /api/v1/me(返回内容与网页一致,含登录邮箱 email、未经验证的联系邮箱与主手机号 phone_cc / phone_number)、本人星标列表(GET /api/v1/stars) 调用接口 GET /api/v1/me
GET /api/v1/stars
org:me:write 修改本人资料 修改本人头像、语言、联系邮箱 / 手机、成员显示名,加星标 / 取消星标(PUT / DELETE /api/v1/stars/{object_type}/{object_id}) 调用接口 POST /api/v1/avatars/uploads/finalize
POST /api/v1/avatars/uploads/prepare
PATCH /api/v1/me
PATCH /api/v1/me/display-name
DELETE /api/v1/stars/{object_type}/{object_id}
PUT /api/v1/stars/{object_type}/{object_id}
org:member:read 查看成员 成员列表 / 详情(含邮箱,与网页一致)、批量解析显示名、成员名下 Agent 调用接口 GET /api/v1/members
POST /api/v1/members/batch-display-info
GET /api/v1/members/{member_id}
GET /api/v1/members/{member_id}/owned-agents
org:member:write 管理成员 修改成员资料 / 状态 / 角色、移除成员(与网页一致,handler 内仍要求 owner/admin) 调用接口 POST /api/v1/members/batch-remove
DELETE /api/v1/members/{member_id}
PATCH /api/v1/members/{member_id}
org:observation:read 查看成员观察关系 我观察的成员、某成员的观察者 调用接口 GET /api/v1/me/observed-members
GET /api/v1/members/{member_id}/observers
org:organization:read 查看组织信息 组织资料、我所在的组织列表、删除前预检(只读) 调用接口 GET /api/v1/organizations
GET /api/v1/organizations/{org_id}
GET /api/v1/organizations/{org_id}/deletion-precheck
GET /api/v1/organizations/{org_id}/storage-quota
org:organization:write 修改组织资料 修改组织名称、头像等资料(handler 内仍要求 owner/admin) 调用接口 PATCH /api/v1/organizations/{org_id}
org:presence:read 接收在线状态事件 成员 / Agent 在线状态变更(presence 帧) 订阅事件 —
org:role:read 查看角色 可用角色列表 调用接口 GET /api/v1/roles

work

Scope 标题和说明 用于 覆盖的接口
work:approval:decide 审批决定 对审批请求作出通过 / 拒绝决定——人工闸门 调用接口 POST /api/v1/approvals/{approval_id}/decide
work:approval:read 查看审批 读取审批列表与详情 调用接口 GET /api/v1/approvals
GET /api/v1/approvals/{approval_id}
work:approval:write 编辑审批 创建 / 修改 / 推进审批 调用接口 POST /api/v1/approvals
POST /api/v1/approvals/{approval_id}/cancel
POST /api/v1/approvals/{approval_id}/expire
POST /api/v1/approvals/{approval_id}/revoke
work:attempt:read 查看Attempt 读取Attempt列表与详情 调用接口 GET /api/v1/attempts/{attempt_id}
GET /api/v1/tasks/{task_id}/attempts
work:attempt:write 编辑Attempt 创建 / 修改 / 推进Attempt 调用接口 POST /api/v1/attempts/{attempt_id}/transition
POST /api/v1/tasks/{task_id}/attempts
work:blueprint:read 查看Blueprint(执行计划) 读取Blueprint(执行计划)列表与详情 调用接口 GET /api/v1/blueprints/{blueprint_id}
GET /api/v1/issues/{issue_id}/blueprints
work:blueprint:write 编辑Blueprint(执行计划) 创建 / 修改 / 推进Blueprint(执行计划) 调用接口 PUT /api/v1/blueprints/{blueprint_id}/steps
POST /api/v1/blueprints/{blueprint_id}/submit-for-approval
POST /api/v1/issues/{issue_id}/blueprints
work:comment:read 查看评论 Issue / Task 的评论列表与单条评论 调用接口 接口暂未公开
work:comment:write 发表评论 在 Issue / Task 下追加评论(作者为本人) 调用接口 接口暂未公开
work:issue:accept 验收 Issue 接受计划(accept-plan)、验收交付(accept-delivered)——人工闸门 调用接口 POST /api/v1/issues/{issue_id}/accept-delivered
POST /api/v1/issues/{issue_id}/accept-plan
work:issue:read 查看Issue 读取Issue列表与详情 调用接口 GET /api/v1/conversations/{conversation_id}/work-links
GET /api/v1/issues
GET /api/v1/issues/{issue_id}
GET /api/v1/projects/{project_id}/issues
work:issue:write 编辑Issue 创建 / 修改 / 推进Issue 调用接口 PATCH /api/v1/issues/{issue_id}
POST /api/v1/issues/{issue_id}/activate
POST /api/v1/issues/{issue_id}/deliver
POST /api/v1/issues/{issue_id}/move
POST /api/v1/issues/{issue_id}/reassign-owner
POST /api/v1/issues/{issue_id}/resume
POST /api/v1/issues/{issue_id}/revisions
POST /api/v1/issues/{issue_id}/submit-plan
POST /api/v1/issues/{issue_id}/terminate
POST /api/v1/projects/{project_id}/issues
work:project:read 查看项目 读取项目列表与详情 调用接口 GET /api/v1/me/private-workspace
GET /api/v1/projects
GET /api/v1/projects/{project_id}
GET /api/v1/projects/{project_id}/members
GET /api/v1/work-references
work:project:write 编辑项目 创建 / 修改 / 推进项目 调用接口 POST /api/v1/me/private-workspace
POST /api/v1/projects
PATCH /api/v1/projects/{project_id}
POST /api/v1/projects/{project_id}/archive
POST /api/v1/projects/{project_id}/members
DELETE /api/v1/projects/{project_id}/members/{member_id}
POST /api/v1/projects/{project_id}/restore
POST /api/v1/projects/{project_id}/star
POST /api/v1/projects/{project_id}/unstar
work:task:read 查看Task 读取Task列表与详情 调用接口 GET /api/v1/issues/{issue_id}/tasks
GET /api/v1/tasks
GET /api/v1/tasks/{task_id}
work:task:write 编辑Task 创建 / 修改 / 推进Task 调用接口 POST /api/v1/projects/{project_id}/issues/{issue_id}/tasks
POST /api/v1/tasks/{task_id}/claim
POST /api/v1/tasks/{task_id}/reassign
POST /api/v1/tasks/{task_id}/start
POST /api/v1/tasks/{task_id}/transition