Skip to main content
POST
更新技能

限制说明

使用说明

  • descriptiondescription_enteam_id 可编辑;技能正文需通过重新上传修改。
  • description 仅在非空时更新 —— 无法通过该字段清空;description_en 可为 null,传入空字符串即可显式清空。
  • team_id 重新分配到不同团队时,除编辑权限外还会触发第二重授权检查,验证调用者是否可将资源指派到目标团队。
  • 每次调用都会记录到账户审计日志。

授权

app_key
string
query
必填

App key issued from the Flashduty console. Required on every public API call. Keep it secret — it grants the same access as the owning account.

请求体

application/json

可编辑的技能元数据。

skill_id
string
必填

目标技能 ID。

description
string

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

Maximum string length: 1024
description_en
string | null

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

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

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

响应

Success

Standard response envelope used by every Flashduty public API. On success data contains the endpoint-specific payload and error is absent. On failure error is present and data is absent. request_id is always present and is also mirrored in the Flashcat-Request-Id response header.

request_id
string
必填

Unique ID for this request. Mirrored in the Flashcat-Request-Id header. Include it when reporting issues.

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

error
object

Error payload inside the response envelope. Present only on non-2xx responses.

data
object

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