更新組織 Skill

透過指定的 skill_id 可用於更新指定組織的 Skill，更新完成即自動完成發布。

請求方式

POST

請求地址

https://api.${endpoint}/v1/org/skill/update

調用驗證

使用組織帳號的 DevKey 和 DevSecret 進行 HTTP Basic 驗證。調用帳號必須有目標組織的 Skill 管理權限。

請求範例

curl -X POST 'https://api.${endpoint}/v1/org/skill/update' \ -H 'Authorization: Basic ${BASIC_TOKEN}' \ -F 'org_id=org-xxxx' \ -F 'skill_id=skill-xxxx' \ -F 'file=@/path/to/refund-policy-v2.skill' \ -F 'category_id=category-xxxx'

                      
                      curl -X POST 'https://api.${endpoint}/v1/org/skill/update' \
  -H 'Authorization: Basic ${BASIC_TOKEN}' \
  -F 'org_id=org-xxxx' \
  -F 'skill_id=skill-xxxx' \
  -F 'file=@/path/to/refund-policy-v2.skill' \
  -F 'category_id=category-xxxx'

此代碼塊在浮窗中顯示

Form Data 參數

參數	類型	必填	說明
`skill_id`	String	是	要更新的組織共享 Skill ID。
`org_id`	String	是	Skill 所屬組織 ID，必須與目標 Skill 一致。
`file`	File	是	`.skill` 或 `.zip` 技能包。
`category_id`	String	否	更新後的分類 ID；不傳時保持原分類。

成功回應

{ "code": 0, "message": "OK", "data": { "skill_id": "skill-xxxx", "name": "refund_policy", "owner_type": "ORGANIZATION" } }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "skill_id": "skill-xxxx",
    "name": "refund_policy",
    "owner_type": "ORGANIZATION"
  }
}

此代碼塊在浮窗中顯示

欄位	說明
`skill_id`	已更新的組織共享 Skill ID。
`name`	本次技能包 `SKILL.md` frontmatter 中的 `name`。
`owner_type`	固定為 `ORGANIZATION`。

調用邊界

僅更新 owner_type=ORGANIZATION 且未綁定 Agent 的共享 Skill。
Agent 私有 Skill、帶 bot_id 的歷史私有記錄和 SYSTEM Skill 均會被拒絕。
僅接受 .skill、.zip；壓縮包最大 20 MiB，必須包含 SKILL.md，其 frontmatter 必須包含 name。
POST /v1/org/skill/import 僅用於建立組織 Skill，不承擔更新語義。