---
title: "Poursuivre une conversation du Hub"
method: POST
path: "/hub/conversations/{id}/questions"
---

# Poursuivre une conversation du Hub

`POST /hub/conversations/{id}/questions`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/hub/conversations/{id}/questions`
- Auth: HTTP bearer

Pose une question qui poursuit une conversation du Hub : l'agent reprend le fil (derniers messages), l'annonce suivie et le projet rattaché, et l'échange est enregistré dans la conversation, lisible sur le site. L'agent enchaîne les opérations de lecture de ce catalogue servies à la clé (portée et palier vérifiés comme pour un appel direct), puis rédige sa réponse ; il rend aussi chaque appel avec son résultat structuré et ses crédits. Chaque opération appelée est facturée à son barème, en plus du prix de la question, dans la limite de plafond_credits : au-delà, l'agent conclut avec ce qu'il a. Exige une clé rattachée à un compte Pillr. Coût : 120 crédits par appel réussi.

## Path parameters

- `id` string, uuid, required: Identifiant de la conversation.

## Request body

- object
  - `question` string, required
  - `outils_autorises` string[]: Outils MCP que l'agent peut appeler (noms du catalogue) ; absent : toutes les opérations de lecture servies à cette clé.
  - `plafond_credits` integer: Crédits au plus pour la question : son prix plus celui des opérations que l'agent appelle. Au-delà, l'agent conclut avec ce qu'il a.

## Response `200`

Écriture faite et débitée selon le barème.

- object
  - `conversation_id` string, uuid, required
  - `reponse` string, required: La réponse rédigée par l'agent, en Markdown.
  - `appels` object[], required
    - `outil` string, required: Nom de l'outil MCP (et de l'opération) appelé.
    - `entree` object, required
    - `resultat` unknown, required
    - `erreur` object, nullable, required
      - `code` string, required
      - `detail` string, required
    - `credits` integer, required: Crédits de cet appel, compris dans le débit de la question.
  - `sources` string[], required: Les sources des résultats utilisés, lues dans leurs blocs qualite.
  - `questions` string[], required: Les faits que les opérations ont demandés pour aller plus loin ; vide si rien ne manque.
  - `qualite` object, required: Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
    - `n` integer, nullable, required: Nombre d'observations derrière la valeur ; null si sans objet.
    - `provenance` 'mesure' | 'estime', nullable, required: mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
    - `incertitude` object, nullable, required: Incertitude de la valeur : fourchette et demi-largeur.
      - `demi_largeur_pct` number, nullable, required: Demi-largeur de la fourchette, en % de la valeur.
      - `bas` number, nullable, required
      - `haut` number, nullable, required
    - `drapeaux` string[], required: Ce qui doit faire lire la valeur avec prudence ; vide si rien.
    - `methode` string, nullable, required: Méthode de calcul ou de rattachement, en clair.
    - `donnees_du` string, nullable, required: Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
    - `source` string, required: Source publique ou moteur Pillr, en clair.
  - `credits` object, required: Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
    - `debites` integer, required
    - `restants` integer, nullable, required

## Other responses

- `400`: Paramètres invalides
- `401`: Clé d'API absente
- `402`: Crédits insuffisants ; Carte requise ; Plafond mensuel de dépense atteint
- `403`: Portée insuffisante ; Clé sans compte rattaché
- `404`: Ressource absente : rien n'est débité
- `429`: Trop de requêtes par minute
- `500`: Erreur interne
- `503`: API indisponible ; Donnée momentanément indisponible

---

[API](https://skmtc.dev/pillr/apis/api-pillr.md) · [All operations](https://skmtc.dev/pillr/apis/api-pillr/llms.txt) · [OpenAPI document](https://skmtc.dev/pillr/apis/api-pillr/revisions/218b2866bd6c?raw)