Skip to main content
POST
上传技能

限制说明

使用说明

  • multipart/form-data 提交,包含 file 部分;支持的压缩包类型为 .skill.zip.tar.gz.tgz,最大 100MB(超限文件会在读取正文前即被拒绝)。
  • skill_id + replace=true 会定向覆盖该指定技能,且跳过团队归属校验,因为调用者本就拥有该行。
  • replace=true(不带 skill_id)会按技能名称做 upsert;不设置 replace 则始终创建新技能 —— 这两条路径都要求调用者被允许向目标 team_id 创建资源。
  • 响应始终将 can_edit 标记为 true
  • 每次调用都会记录到账户审计日志。

授权

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.

请求体

multipart/form-data

上传技能压缩包的 multipart 表单。

file
file
必填

技能压缩包(.skill / .zip / .tar.gz / .tgz),最大 100MB;超限文件会在读取正文前即被拒绝。

team_id
integer<int64>

新建/upsert 技能的团队范围:0 表示账户级。通过 skill_id 定向替换时会忽略该字段。

replace
boolean

为 true 时覆盖已有技能而非在名称冲突时报错 —— 若提供 skill_id 则按其匹配,否则按技能名称匹配。

skill_id
string

定向替换指定技能时的技能 ID(需配合 replace=true)。

响应

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