更新连接器接口

修改连接器的展示名称、说明、图标、客户端范围、状态或市场分类。当前请求模型不接受服务 URL、启动命令或认证凭据；资源和市场条目分别使用对应的预期修订号。

所需权限

PATCH /api/openapi/v1/connectors/{resourceId}

认证与请求头

使用应用 API Key 调用。当前接口校验上方独立 Scope；读取、管理与执行权限互不包含。

请求参数

请求示例

将 <BASE_URL> 替换为企业部署的千问办公 API 服务地址，并填写实际参数。示例中的占位值不能直接用于请求。

curl --request PATCH --url '<BASE_URL>/api/openapi/v1/connectors/<resourceId>' --header 'Authorization: Bearer <API_KEY>' --header 'Content-Type: application/json' --data '{  "category_id": "<string>",  "clear_category": false,  "clients": ["<string>"  ],  "description": "<string>",  "description_cn": "<string>",  "display_name": "<string>",  "display_name_cn": "<string>",  "expected_market_item_revision": 0,  "expected_revision": 0,  "icon_upload_id": "<string>",  "icon_url": "<string>",  "status": "<string>"}'

响应

200 请求成功，返回当前或更新后的数据。

{
  "api_key": {
    "header_name": "<string>",
    "value_prefix": "<string>"
  },
  "auth_type": "<string>",
  "clients": [
    "<string>"
  ],
  "command": "<string>",
  "created_at": "2026-08-27T10:00:00Z",
  "description": "<string>",
  "description_cn": "<string>",
  "display_name": "<string>",
  "display_name_cn": "<string>",
  "icon_url": "<string>",
  "id": "<string>",
  "oauth_client_registration": "<string>",
  "oauth_scopes": "<string>",
  "origin": "<string>",
  "revision": 0,
  "server_key": "<string>",
  "source_type": "official",
  "status": "<string>",
  "transport": "<string>",
  "updated_at": "2026-08-27T10:00:00Z",
  "url": "<string>",
  "version": "<string>"
}

default 请求失败，返回错误码和错误详情。

{
  "code": "<string>",
  "detail": "<string>",
  "details": {
    "field": "<string>",
    "reason": "<string>",
    "suggestion": "<string>"
  },
  "error": "<string>"
}