> For the complete documentation index, see [llms.txt](https://docs.dydu.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dydu.ai/developpeurs/reference-api/import-export-base-de-connaissances.md).

# Import/Export Base de connaissances

Ces API permettent d'exporter, d'importer ou de supprimer la base de connaissances d'un bot, au format XML.

Avant de commencer, vous avez besoin :

* de l'**identifiant du bot** (botUUID) et, pour l'import, de l'**identifiant de votre compte** (accountUUID). Ils sont affichés sur la page **Préférences > Api > Accès aux APIs** (voir [Accès aux APIs](https://docs.dydu.ai/developpeurs/reference-api/acces-aux-apis)) ;
* d'une **autorisation** pour le champ **Authorization** (voir [Authentification](https://docs.dydu.ai/developpeurs/reference-api/authentification)).

Ces API se trouvent dans l'interface Swagger : dirigez-vous sur la page **Préférences > Api > Accès aux APIs**, cliquez sur le lien proposé puis sur **Bot knowledge base**.

## Exporter une base de connaissances

L'export est réservé aux administrateurs.

1. Cliquez sur **GET /bot/knowledgebase/export/{botUUID}/{excludeGalleryContent}** puis sur **Try it out**.
2. Remplissez les champs :
   * **botUUID** : identifiant du bot à exporter ;
   * **excludeGalleryContent** : `true` pour exclure la galerie de l'export, `false` pour l'inclure ;
   * **Authorization** : votre jeton.
3. Cliquez sur **Execute**.
4. Cliquez sur **Download file** pour récupérer la base de connaissances.

## Importer une base de connaissances

L'import est réservé aux administrateurs.

1. Cliquez sur **POST /bot/knowledgebase/import/{botUUID}/{accountUUID}** puis sur **Try it out**.
2. Remplissez les champs :
   * **botUUID** : identifiant du bot sur lequel importer la base de connaissances ;
   * **accountUUID** : identifiant de votre compte ;
   * **Authorization** : votre jeton.
3. Cliquez sur **Choisir un fichier** et sélectionnez le fichier XML à importer.
4. Cliquez sur **Execute**. L'import peut prendre un peu de temps.

L'API renvoie un rapport d'import au format XML (fichier `import-knowledgeBase-<identifiant>.xml`). Consultez-le pour vérifier le résultat de l'import.

## Supprimer une base de connaissances

{% hint style="warning" %}
La suppression est définitive. Elle supprime les connaissances, les groupes de formulations, les conditions de contexte, les espaces de consultation et, si vous ne l'excluez pas, la galerie. Exportez la base de connaissances avant de la supprimer.
{% endhint %}

La suppression est réservée aux super utilisateurs.

1. Cliquez sur **DELETE /bot/knowledgebase/delete/{botUUID}/{excludeGalleryContent}** puis sur **Try it out**.
2. Remplissez les champs :
   * **botUUID** : identifiant du bot dont vous voulez supprimer la base de connaissances ;
   * **excludeGalleryContent** : `true` pour conserver la galerie, `false` pour la supprimer aussi ;
   * **Authorization** : votre jeton.
3. Cliquez sur **Execute**.
