更新、停用或归档工具¶

接口用途¶

修改工具状态，例如 disabled 或 archived。

请求方式¶

PATCH

接口地址¶

https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/tools/<tool_id>

身份认证¶

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

路径参数¶

名称	说明
`tool_id`	工具标识。

查询参数¶

无。

请求体¶

部分更新。可用于设置 disabled / archived 等状态。DELETE /tools/<tool_id> 实测返回 405。

字段	类型	必填	说明
`name`	string	否	名称
`description`	string	否	描述
`status`	string	否	如 `disabled` / `archived` / `active`
`kind`	string	否	类型
`category`	string	否	分类
`tags`	array	否	标签
`source_ref`	object	否	来源
`input_schema`	object	否	输入 schema
`output_schema`	object	否	输出 schema
`metadata`	object	否	元数据

请求示例¶

curl -X PATCH 'https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/tools/<tool_id>' \
  -H 'X-API-Key: <WORKSPACE_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"status":"archived"}'

响应说明¶

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

返回更新后的工具：

字段	类型	说明
`id`	string	工具 ID
`workspace_id`	string	工作区 ID（系统工具可省略或为 system）
`name`	string	API 工具名
`description`	string	描述
`display_name`	string	显示名
`status`	string	状态，如 active / disabled / archived
`kind`	string	工具类型
`category`	string	分类
`tags`	array	标签
`source_ref`	object	`type` / `id` / `uri` / `version` / `config`
`input_schema`	object	输入 JSON Schema
`output_schema`	object	输出 JSON Schema
`side_effect_class`	string	副作用等级
`credential_ref`	string	凭据引用（勿展开明文）
`version`	integer	版本
`metadata`	object	扩展元数据
`created_at`	string	创建时间
`updated_at`	string	更新时间

使用限制¶

DELETE /tools/<tool_id> 实测返回 405；停用或归档使用本接口。