更新连接¶

更新智能体连接的元数据、端点或凭据配置。

PATCH https://moi.matrixorigin.cn/newmoi/workspaces/{workspace_id}/connections/{connection_id}

调用前准备¶

准备具有目标工作区访问权限的个人访问令牌和目标工作区 ID。

请求体¶

请求示例

curl -X PATCH "https://moi.matrixorigin.cn/newmoi/workspaces/$WORKSPACE_ID/connections/$CONNECTION_ID" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "新的 MCP 服务"
  }'

参数说明

字段	类型	必填	说明
`name`	string	否	连接名称。
`description`	string	否	连接说明。
`status`	string	否	连接状态。
`kind`	string	否	连接类型。
`endpoint_uri`	string	否	连接服务地址。
`auth_type`	string	否	认证类型。
`credential_ref`	string	否	已保存凭据的引用。
`capabilities`	string（字符串数组）	否	连接能力列表。
`owner_user_id`	string	否	连接所有者用户 ID。
`visibility`	string	否	可见范围。
`config`	object	否	连接配置。
`labels`	object	否	标签。
`annotations`	object	否	注释。
`metadata`	object	否	扩展元数据。
`credential`	object	否	凭据，可包含 bearer_token、api_key、basic_username、basic_password 或 custom_headers。

成功响应¶

成功时返回 200 和更新后的连接。

响应示例

{"code":0,"data":{"id":"connection_01","name":"新的 MCP 服务"}}

字段说明

基础信息

字段	类型	说明
`data.id`	string	连接 ID。

错误响应¶

响应示例

{"code":5,"message":"connection not found"}

字段说明

通用字段

字段	类型	说明
`code`	integer	错误代码。
`message`	string	面向调用者的错误信息。

最后更新于 2026 年 9 月 1 日