yuno.chat
Clés API

Référence de l’API

Sources de connaissances

Les sources de connaissances fournissent à l’assistant les informations nécessaires à ses réponses : pages explorées depuis une URL ou un sitemap, ou texte envoyé directement. Elles sont synchronisées chaque nuit.

Points de terminaison

L’objet source de connaissances

Attributs

  • idstring

    Identifiant unique, préfixé par src_.

  • objectstring

    Toujours knowledge_source.

  • typeenum

    url explore une page et les pages du même domaine vers lesquelles elle pointe, sitemap lit toutes les URL d’un sitemap et text correspond au contenu que vous envoyez.

    urlsitemaptext

  • namestring

    Un libellé pour votre équipe.

  • urlstring | null

    L’URL des sources de type url et sitemap.

  • statusenum

    État de l’indexation.

    pendingindexingreadyfailed

  • page_countinteger

    Nombre de pages actuellement indexées.

  • last_synced_atstring | null

    Dernière synchronisation réussie.

  • created_atstring

    Date de création de l’objet, au format ISO 8601 en UTC.

Objet source de connaissances
{
  "id": "src_5Tn3bKx8",
  "object": "knowledge_source",
  "type": "sitemap",
  "name": "Site principal",
  "url": "https://atelier-gres.fr/sitemap.xml",
  "status": "ready",
  "page_count": 142,
  "last_synced_at": "2026-10-02T03:00:12Z",
  "created_at": "2026-06-11T15:10:44Z"
}

Créer une source de connaissances

POST/knowledge-sources

Ajoute une source et démarre son indexation. Vous recevrez un webhook knowledge_source.ready ou knowledge_source.failed une fois l’opération terminée.

Paramètres du corps

  • typeenumobligatoire

    Le type de source.

    urlsitemaptext

  • namestringobligatoire

    Un libellé pour votre équipe.

  • urlstring

    Obligatoire pour url et sitemap.

  • contentstring

    Obligatoire pour text. Contenu Markdown, limité à 100 000 caractères.

  • site_idstring

    Limite la source à un seul site. Par défaut, elle est utilisée sur tous les sites.

Requête
curl -X POST https://api.yuno.chat/v1/knowledge-sources \
  -H "Authorization: Bearer $YUNO_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "sitemap",
    "name": "Site principal",
    "url": "https://atelier-gres.fr/sitemap.xml"
  }'
Réponse · 201
{
  "id": "src_5Tn3bKx8",
  "object": "knowledge_source",
  "type": "sitemap",
  "name": "Site principal",
  "url": "https://atelier-gres.fr/sitemap.xml",
  "status": "pending",
  "page_count": 0,
  "last_synced_at": null,
  "created_at": "2026-06-11T15:10:44Z"
}

Lister les sources de connaissances

GET/knowledge-sources

Renvoie toutes les sources de connaissances.

Paramètres de requête

  • limitinteger

    Nombre d’objets à renvoyer, entre 1 et 100. Valeur par défaut : 20.

  • cursorstring

    Le next_cursor d’une page précédente. Omettez-le pour commencer par l’objet le plus récent.

Requête
curl https://api.yuno.chat/v1/knowledge-sources \
  -H "Authorization: Bearer $YUNO_SECRET_KEY"
Réponse · 200
{
  "object": "list",
  "data": [
    {
      "id": "src_5Tn3bKx8",
      "object": "knowledge_source",
      "type": "sitemap",
      "name": "Site principal",
      "url": "https://atelier-gres.fr/sitemap.xml",
      "status": "ready",
      "page_count": 142,
      "last_synced_at": "2026-10-02T03:00:12Z",
      "created_at": "2026-06-11T15:10:44Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Récupérer une source de connaissances

GET/knowledge-sources/{id}

Renvoie une seule source de connaissances.

Paramètres de chemin

  • idstringobligatoire

    L’identifiant de la source.

Requête
curl https://api.yuno.chat/v1/knowledge-sources/src_5Tn3bKx8 \
  -H "Authorization: Bearer $YUNO_SECRET_KEY"
Réponse · 200
{
  "id": "src_5Tn3bKx8",
  "object": "knowledge_source",
  "type": "sitemap",
  "name": "Site principal",
  "url": "https://atelier-gres.fr/sitemap.xml",
  "status": "ready",
  "page_count": 142,
  "last_synced_at": "2026-10-02T03:00:12Z",
  "created_at": "2026-06-11T15:10:44Z"
}

Synchroniser une source de connaissances

POST/knowledge-sources/{id}/sync

Réindexe immédiatement une source sans attendre la synchronisation nocturne. Limité à une fois toutes les 10 minutes par source.

Paramètres de chemin

  • idstringobligatoire

    L’identifiant de la source.

Requête
curl -X POST https://api.yuno.chat/v1/knowledge-sources/src_5Tn3bKx8/sync \
  -H "Authorization: Bearer $YUNO_SECRET_KEY"
Réponse · 202
{
  "id": "src_5Tn3bKx8",
  "object": "knowledge_source",
  "type": "sitemap",
  "name": "Site principal",
  "url": "https://atelier-gres.fr/sitemap.xml",
  "status": "indexing",
  "page_count": 142,
  "last_synced_at": "2026-10-02T03:00:12Z",
  "created_at": "2026-06-11T15:10:44Z"
}

Supprimer une source de connaissances

DELETE/knowledge-sources/{id}

Retire la source et ses pages des connaissances de l’assistant.

Paramètres de chemin

  • idstringobligatoire

    L’identifiant de la source.

Requête
curl -X DELETE https://api.yuno.chat/v1/knowledge-sources/src_5Tn3bKx8 \
  -H "Authorization: Bearer $YUNO_SECRET_KEY"
Réponse · 200
{
  "id": "src_5Tn3bKx8",
  "object": "knowledge_source",
  "deleted": true
}