組織 Skill の更新

指定した skill_id を使用して指定組織の Skill を更新できます。更新が完了すると自動的に公開まで完了します。

リクエストメソッド

POST

リクエストURL

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` の Skill パッケージ。
`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 パッケージの `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 の作成にのみ使用され、更新の意味は持ちません。