API Créer un Skill d'organisation

Permet de créer un Skill de niveau organisation au sein de l'organisation spécifiée ; vous pouvez, via cette interface, créer un Skill de niveau organisation au sein de l'organisation spécifiée.

Seuls les formats .skill et .zip sont acceptés ; l'archive ne doit pas dépasser 20 MiB.
Le répertoire racine de l'archive ou son unique répertoire de premier niveau doit contenir un fichier SKILL.md, dont le frontmatter doit inclure name.
Après une création réussie, utilisez POST /v1/org/skill/update en transmettant skill_id dans les Form Data pour mettre à jour ce Skill.

Méthode de requête

POST

Adresse d'appel

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

Vérification de l'appel

Authentification Basic à l'aide de la DevKey / du DevSecret de niveau compte, l'appelant devant disposer du droit de création de Skill d'organisation.

Requête

Exemple de requête

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

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

Ce bloc de code dans la fenêtre flottante

En-têtes de requête

Champ	Type	Description
Authorization	Basic ${BASIC_TOKEN}	Basic Token obtenu en encodant `DevKey:DevSecret` en Base64.
Content-Type	application/json	Format du corps de la requête.

Paramètres de requête (Body Parameters)

Paramètre	Type	Obligatoire	Description
`org_id`	String	Oui	ID de l'organisation dans laquelle créer le Skill partagé.
`file`	File	Oui	Package de compétences `.skill` ou `.zip`.

Réponse

Exemple de réponse

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

Réponse en cas de succès

Champ	Type	Description
skill_id	String	ID du Skill nouvellement créé.
name	String	Nom du Skill.
owner_type	String	Type d'appartenance du Skill.

Réponse en cas d'échec

Champ	Type	Description
code	Integer	Code d'erreur.
message	String	Détail de l'erreur.

Codes de statut

Code de statut	Description
200	Succès
400	Erreur de paramètre
401	Non autorisé
403	Droits insuffisants
429	Requêtes trop fréquentes
500	Erreur serveur