跳转到主要内容
POST
更新技能

限制说明

使用说明

  • 需要技能的编辑权限:账户级技能(team_id = 0)仅账户所有者和管理员可编辑;团队技能仅该团队成员可编辑(所有者和管理员没有豁免)。否则返回 AccessDenied。
  • 只能修改 description、description_en 和 team_id;技能正文需上传新的压缩包修改。
  • description 仅在非空时修改,因此无法清空。description_en 只要传入就会修改;传空字符串即清空。
  • 移到团队(team_id > 0)要求调用者属于目标团队;移到账户级(team_id = 0)要求账户所有者或管理员。从市场安装的技能只能移到账户级。目标作用域内名称冲突时返回 InvalidParameter。
  • 每次调用都会记录到账户审计日志。

授权

app_key
string
query
必填

在 Flashduty 控制台 我的 → APP Key 中创建的 APP Key。可通过 query 参数 app_key 或请求头 Fd-App-Key 传入。实际可访问范围是该 APP Key 的权限范围与创建者当前角色权限的交集,请妥善保管。

请求体

application/json

可编辑的技能元数据。

skill_id
string
必填

目标技能 ID,取自 POST /safari/skill/list 返回的列表。

description
string

新的描述,不能包含 < 或 >。传入空字符串不会清空当前值 —— 该字段无法用于清空描述。

Maximum string length: 1024
description_en
string | null

新的英文描述,不能包含 < 或 >。省略表示不变;传入空字符串可显式清空。

Maximum string length: 1024
team_id
integer<int64> | null

重新分配团队范围:0 表示账户级;>0 表示团队。省略则不变。

响应

成功

所有 Flashduty 公开 API 共用的标准响应结构。成功时 data 为接口专属载荷且不含 error;失败时 error 存在而 data 缺失。request_id 始终存在,并会同步写入 Flashcat-Request-Id 响应头。

request_id
string
必填

本次请求的唯一 ID,与 Flashcat-Request-Id 响应头一致。反馈问题时请携带该 ID。

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

error
object

响应结构中的错误 payload,仅在非 2xx 响应时出现。

data
object

AI SRE 技能 —— 智能体可加载的 SKILL.md 打包资源。