Mettre à jour un Skill d'organisation

Le paramètre skill_id spécifié permet de mettre à jour le Skill de l'organisation indiquée ; la mise à jour terminée déclenche automatiquement la publication.

Méthode de requête

POST

Adresse de requête

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

Vérification de l'appel

Authentification HTTP Basic à l'aide de la DevKey et du DevSecret du compte de l'organisation. L'appelant doit disposer du droit de gestion des Skills sur l'organisation cible.

Exemple de requête

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'

Ce bloc de code dans la fenêtre flottante

Paramètres Form Data

Paramètre	Type	Obligatoire	Description
`skill_id`	String	Oui	ID du Skill partagé de l'organisation à mettre à jour.
`org_id`	String	Oui	ID de l'organisation à laquelle appartient le Skill ; doit correspondre au Skill cible.
`file`	File	Oui	Package de compétences `.skill` ou `.zip`.
`category_id`	String	Non	ID de catégorie après mise à jour ; si non fourni, la catégorie d'origine est conservée.

Réponse en cas de succès

{ "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"
  }
}

Ce bloc de code dans la fenêtre flottante

Champ	Description
`skill_id`	ID du Skill partagé de l'organisation mis à jour.
`name`	Valeur `name` du frontmatter de `SKILL.md` du package de compétences transmis.
`owner_type`	Fixé à `ORGANIZATION`.

Limites d'appel

Seuls les Skills partagés avec owner_type=ORGANIZATION et non liés à un Agent peuvent être mis à jour.
Les Skills privés d'un Agent, les anciens enregistrements privés comportant un bot_id et les Skills SYSTEM seront tous rejetés.
Seuls les formats .skill et .zip sont acceptés ; l'archive ne doit pas dépasser 20 MiB et doit contenir un fichier SKILL.md, dont le frontmatter doit inclure name.
POST /v1/org/skill/import sert uniquement à créer un Skill d'organisation et n'assure pas la sémantique de mise à jour.