更新连接¶

接口用途¶

更新 MCP 连接，例如复用并升级已有连接鉴权（none → bearer_token）。

请求方式¶

PATCH

接口地址¶

https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/connections/<connection_id>

身份认证¶

使用工作区 API Key，在请求头中携带 X-API-Key: <WORKSPACE_API_KEY>，并设置 Content-Type: application/json。

路径参数¶

名称	说明
`connection_id`	连接标识。

查询参数¶

无。

请求体¶

部分更新。可用于复用并升级鉴权，例如 none → bearer_token。

字段	类型	必填	说明
`name`	string	否	名称
`endpoint_uri`	string	否	Endpoint
`auth_type`	string	否	鉴权类型
`credential`	object	否	新凭据（勿写入文档明文）
`credential_ref`	string	否	凭据引用
`status`	string	否	状态
`visibility`	string	否	可见性
`config`	object	否	配置
`description`	string	否	描述

请求示例¶

curl -X PATCH 'https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/connections/<connection_id>' \
  -H 'X-API-Key: <WORKSPACE_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"auth_type":"bearer_token","credential":{"bearer_token":"<MCP_TOKEN>"}}'

响应说明¶

除 A2A JSON-RPC 外，多数工作区接口成功响应形如 {"code":0,"data":...}；下列字段描述 data（或 HTTP 202 时的 data）。

返回更新后的连接：

字段	类型	说明
`id`	string	连接 ID
`workspace_id`	string	工作区 ID
`name`	string	连接名称
`description`	string	描述
`status`	string	状态
`kind`	string	连接类型（如 MCP）
`endpoint_uri`	string	远端 endpoint
`auth_type`	string	如 `none` / `bearer_token` / `api_key` / `basic`
`credential_ref`	string	凭据引用；文档中勿展开明文
`capabilities`	array	能力列表
`visibility`	string	可见性
`config`	object	连接配置
`version`	integer	版本
`created_at`	string	创建时间
`updated_at`	string	更新时间

使用限制¶

更新鉴权信息时使用占位符，不要写入真实 token。