Skip to main content
POST
更新技能

授权

app_key
string
query
必填

在 Flashduty 控制台 账户 → APP Key 中签发的 app_key。调用任何公开 API 时都必须携带。它等同于所属账户的身份凭证,请妥善保管。

请求体

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 打包资源。