Hub et documents

14 opérations servies.

/

Question à l'agent du Hub

POST/api/v1/hub/questions

Une question libre posée à l'agent du Hub, qui raisonne avec Gemini 4 Argon (Google). 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. Avec une clé personnelle, le profil investisseur, la mémoire du compte et le projet désigné entrent dans son contexte.

Coût: 120 crédits par appel réussi
Accès: À l'usage ou avec l'abonnement Data
Portée: hub
Outil MCP: question_hub
Bac à sable: Non
Mémoire: Jamais gardée
Délai: 120 s

Essayer en direct

Paramètres

questiontexteobligatoire
de 3 à 4 000 caractères
contexteobjet
Afficher les 4 champsMasquer
- projet_idtexte
  Projet du compte dont le contexte est repris (clé personnelle).
  format uuid
- annoncetexte
  Annonce dont parle la question.
  de 3 à 200 caractères
- cle_bantexte
  Adresse dont parle la question.
- inseetexte
  Commune dont parle la question.
memoirebooléen
Faux : ni profil investisseur ni mémoire du compte dans le contexte.
par défaut true
outils_autorisesliste de textes
Outils MCP que l'agent peut appeler (noms du catalogue) ; absent : toutes les opérations de lecture servies à cette clé.
1 éléments au moins ; 100 éléments au plus
plafond_creditsentier
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.
de 120 à 1 200

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/hub/questions \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"question":"<question>"}'

Réponse

reponsetexte
La réponse rédigée par l'agent, en Markdown.
appelsliste d'objets
Afficher les 5 champsMasquer
- outiltexte
  Nom de l'outil MCP (et de l'opération) appelé.
- entreeobjet
- resultatvaleur
  La sortie de l'opération, telle qu'un appel direct la rendrait ; null en cas d'erreur.
- erreurobjet ou null
  Afficher les 2 champsMasquer
  - codetexte
  - detailtexte
- creditsentier
  Crédits de cet appel, compris dans le débit de la question.
sourcesliste de textes
Les sources des résultats utilisés, lues dans leurs blocs qualite.
questionsliste de textes
Les faits que les opérations ont demandés pour aller plus loin ; vide si rien ne manque.
qualiteobjet
Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
- nentier ou null
  Nombre d'observations derrière la valeur ; null si sans objet.
  0 au moins
- provenancetexte ou null
  mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
  Valeurs : mesure, estime
- incertitudeobjet ou null
  Incertitude de la valeur : fourchette et demi-largeur.
  Afficher les 3 champsMasquer
  - demi_largeur_pctnombre ou null
    Demi-largeur de la fourchette, en % de la valeur.
  - basnombre ou null
  - hautnombre ou null
- drapeauxliste de textes
  Ce qui doit faire lire la valeur avec prudence ; vide si rien.
  Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne
- methodetexte ou null
  Méthode de calcul ou de rattachement, en clair.
- donnees_dutexte ou null
  Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
- sourcetexte
  Source publique ou moteur Pillr, en clair.
creditsobjet
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).
Afficher les 2 champsMasquer
- debitesentier
  0 au moins
- restantsentier ou null

Erreurs possibles

400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
415type_contenuLe corps n'est pas envoyé en application/json
400corps_illisibleLe corps n'est pas un JSON lisible
413corps_trop_lourdLe corps dépasse la taille permise
401cle_absenteL'en-tête Authorization manque
401cle_invalideLa clé est inconnue, révoquée ou expirée
403organisation_suspendueL'organisation de la clé n'est pas active
403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
429plafond_cleLe plafond mensuel de crédits de la clé est atteint
429quota_minuteLe débit par minute de l'organisation est atteint
503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
503service_indisponibleL'API est momentanément indisponible
500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.

Conversations du Hub

GET/api/v1/hub/conversations

Les conversations du Hub de l'utilisateur de la clé, les plus récemment modifiées d'abord, avec leur projet et leur annonce suivie.

Coût: 0 crédit par appel réussi
Accès: À l'usage ou avec l'abonnement Data
Portée: hub
Outil MCP: conversations_hub
Bac à sable: Non
Mémoire: Jamais gardée
Délai: 3 s

Essayer en direct

Paramètres

projet_idtexte
Les conversations d'un projet.
format uuid
epingleesvaleur
Vrai : les épinglées seulement ; faux : les autres.
limiteentier
Nombre d'éléments par page (50 au plus).
de 1 à 50 ; par défaut 20
curseurtexte
Curseur opaque rendu par la page précédente (curseur_suivant), à repasser tel quel.
de 1 à 1 024 caractères

Exemple d'appel

curl https://pillr.fr/api/v1/hub/conversations \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

conversationsliste d'objets
Afficher les 7 champsMasquer
- idtexte
  format uuid
- titretexte ou null
- annonce_idtexte ou null
  Annonce suivie par la conversation, si elle a été ouverte depuis une fiche.
- projet_idtexte ou null
  format uuid
- epingleebooléen
- cree_letexte ou null
- maj_letexte ou null
curseur_suivanttexte ou null
Curseur de la page suivante, à repasser dans curseur ; null sur la dernière page.
creditsobjet
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).
Afficher les 2 champsMasquer
- debitesentier
  0 au moins
- restantsentier ou null

Erreurs possibles

400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
401cle_absenteL'en-tête Authorization manque
401cle_invalideLa clé est inconnue, révoquée ou expirée
403organisation_suspendueL'organisation de la clé n'est pas active
403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
429plafond_cleLe plafond mensuel de crédits de la clé est atteint
429quota_minuteLe débit par minute de l'organisation est atteint
503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
503service_indisponibleL'API est momentanément indisponible
500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.

Une conversation du Hub

GET/api/v1/hub/conversations/{id}

Une conversation du Hub et ses messages dans l'ordre (les 200 derniers au plus), avec les outils appelés et leurs résultats.

Coût: 0 crédit par appel réussi
Accès: À l'usage ou avec l'abonnement Data
Portée: hub
Outil MCP: conversations_hub_lire
Bac à sable: Non
Mémoire: Jamais gardée
Délai: 4 s

Essayer en direct

Paramètres

idtexteobligatoire
Identifiant de la conversation.
format uuid

Exemple d'appel

curl https://pillr.fr/api/v1/hub/conversations/{id} \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

conversationobjet
Afficher les 7 champsMasquer
- idtexte
  format uuid
- titretexte ou null
- annonce_idtexte ou null
  Annonce suivie par la conversation, si elle a été ouverte depuis une fiche.
- projet_idtexte ou null
  format uuid
- epingleebooléen
- cree_letexte ou null
- maj_letexte ou null
messagesliste d'objets
Afficher les 4 champsMasquer
- rangentier
- roletexte
  user ou assistant.
- contenutexte
- outilsliste d'objets
  Afficher les 3 champsMasquer
  - nomtexte
  - entreevaleur
  - resultatvaleur
creditsobjet
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).
Afficher les 2 champsMasquer
- debitesentier
  0 au moins
- restantsentier ou null

Erreurs possibles

400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
401cle_absenteL'en-tête Authorization manque
401cle_invalideLa clé est inconnue, révoquée ou expirée
403organisation_suspendueL'organisation de la clé n'est pas active
403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
429plafond_cleLe plafond mensuel de crédits de la clé est atteint
429quota_minuteLe débit par minute de l'organisation est atteint
503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
503service_indisponibleL'API est momentanément indisponible
500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.

Poursuivre une conversation du Hub

POST/api/v1/hub/conversations/{id}/questions

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.

Coût: 120 crédits par appel réussi
Accès: À l'usage ou avec l'abonnement Data
Portée: hub
Outil MCP: conversations_hub_question
Bac à sable: Non
Mémoire: Jamais gardée
Délai: 120 s

Essayer en direct

Paramètres

idtexteobligatoire
Identifiant de la conversation.
format uuid
questiontexteobligatoire
de 3 à 4 000 caractères
outils_autorisesliste de textes
Outils MCP que l'agent peut appeler (noms du catalogue) ; absent : toutes les opérations de lecture servies à cette clé.
1 éléments au moins ; 100 éléments au plus
plafond_creditsentier
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.
de 120 à 1 200

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/hub/conversations/{id}/questions \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"question":"<question>"}'

Réponse

conversation_idtexte
format uuid
reponsetexte
La réponse rédigée par l'agent, en Markdown.
appelsliste d'objets
Afficher les 5 champsMasquer
- outiltexte
  Nom de l'outil MCP (et de l'opération) appelé.
- entreeobjet
- resultatvaleur
  La sortie de l'opération, telle qu'un appel direct la rendrait ; null en cas d'erreur.
- erreurobjet ou null
  Afficher les 2 champsMasquer
  - codetexte
  - detailtexte
- creditsentier
  Crédits de cet appel, compris dans le débit de la question.
sourcesliste de textes
Les sources des résultats utilisés, lues dans leurs blocs qualite.
questionsliste de textes
Les faits que les opérations ont demandés pour aller plus loin ; vide si rien ne manque.
qualiteobjet
Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
- nentier ou null
  Nombre d'observations derrière la valeur ; null si sans objet.
  0 au moins
- provenancetexte ou null
  mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
  Valeurs : mesure, estime
- incertitudeobjet ou null
  Incertitude de la valeur : fourchette et demi-largeur.
  Afficher les 3 champsMasquer
  - demi_largeur_pctnombre ou null
    Demi-largeur de la fourchette, en % de la valeur.
  - basnombre ou null
  - hautnombre ou null
- drapeauxliste de textes
  Ce qui doit faire lire la valeur avec prudence ; vide si rien.
  Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne
- methodetexte ou null
  Méthode de calcul ou de rattachement, en clair.
- donnees_dutexte ou null
  Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
- sourcetexte
  Source publique ou moteur Pillr, en clair.
creditsobjet
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).
Afficher les 2 champsMasquer
- debitesentier
  0 au moins
- restantsentier ou null

Erreurs possibles

400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
415type_contenuLe corps n'est pas envoyé en application/json
400corps_illisibleLe corps n'est pas un JSON lisible
413corps_trop_lourdLe corps dépasse la taille permise
401cle_absenteL'en-tête Authorization manque
401cle_invalideLa clé est inconnue, révoquée ou expirée
403organisation_suspendueL'organisation de la clé n'est pas active
403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
429plafond_cleLe plafond mensuel de crédits de la clé est atteint
429quota_minuteLe débit par minute de l'organisation est atteint
503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
503service_indisponibleL'API est momentanément indisponible
500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.

Renommer, épingler ou rattacher une conversation

POST/api/v1/hub/conversations/{id}

Renomme une conversation du Hub, l'épingle ou la désépingle, la rattache à un projet du compte ou l'en détache.

Coût: 0 crédit par appel réussi
Accès: À l'usage ou avec l'abonnement Data
Portée: hub
Outil MCP: conversations_hub_modifier
Bac à sable: Non
Mémoire: Jamais gardée
Délai: 3 s

Essayer en direct

Paramètres

idtexteobligatoire
Identifiant de la conversation.
format uuid
titretexte
de 1 à 200 caractères
epingleebooléen
projet_idtexte ou null
Projet du compte ; null détache.
format uuid

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/hub/conversations/{id} \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{}'

Réponse

conversationobjet
Afficher les 7 champsMasquer
- idtexte
  format uuid
- titretexte ou null
- annonce_idtexte ou null
  Annonce suivie par la conversation, si elle a été ouverte depuis une fiche.
- projet_idtexte ou null
  format uuid
- epingleebooléen
- cree_letexte ou null
- maj_letexte ou null
creditsobjet
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).
Afficher les 2 champsMasquer
- debitesentier
  0 au moins
- restantsentier ou null

Erreurs possibles

400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
415type_contenuLe corps n'est pas envoyé en application/json
400corps_illisibleLe corps n'est pas un JSON lisible
413corps_trop_lourdLe corps dépasse la taille permise
401cle_absenteL'en-tête Authorization manque
401cle_invalideLa clé est inconnue, révoquée ou expirée
403organisation_suspendueL'organisation de la clé n'est pas active
403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
429plafond_cleLe plafond mensuel de crédits de la clé est atteint
429quota_minuteLe débit par minute de l'organisation est atteint
503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
503service_indisponibleL'API est momentanément indisponible
500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.

Projets du compte

GET/api/v1/projets

Les projets de l'utilisateur de la clé (achat, mandat de vente, location et gestion) : titre, étape, annonce suivie, adresse, faits, échéances, date de clôture et nombre de conversations du Hub rattachées. Les projets ouverts d'abord, puis les plus récemment modifiés.

Coût: 0 crédit par appel réussi
Accès: À l'usage ou avec l'abonnement Data
Portée: hub
Outil MCP: projets
Bac à sable: Non
Mémoire: Jamais gardée
Délai: 3 s

Essayer en direct

Paramètres

closvaleur
Vrai : les projets clos seulement ; faux : les ouverts seulement ; absent : tous.

Exemple d'appel

curl https://pillr.fr/api/v1/projets \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

projetsliste d'objets
Afficher les 12 champsMasquer
- idtexte
  format uuid
- typetexte
- titretexte
- etapetexte
- annonce_idtexte ou null
  Identifiant Pillr de l'annonce suivie.
- adressetexte ou null
- faitsobjet
  Faits du projet (clés libres ; textes et urbanisme sont réservés).
- echeancesliste d'objets
- clos_letexte ou null
  Horodatage ISO 8601.
- cree_letexte ou null
  Horodatage ISO 8601.
- maj_letexte ou null
  Horodatage ISO 8601.
- nb_conversationsentier
creditsobjet
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).
Afficher les 2 champsMasquer
- debitesentier
  0 au moins
- restantsentier ou null

Erreurs possibles

400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
401cle_absenteL'en-tête Authorization manque
401cle_invalideLa clé est inconnue, révoquée ou expirée
403organisation_suspendueL'organisation de la clé n'est pas active
403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
429plafond_cleLe plafond mensuel de crédits de la clé est atteint
429quota_minuteLe débit par minute de l'organisation est atteint
503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
503service_indisponibleL'API est momentanément indisponible
500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.

Créer un projet

POST/api/v1/projets

Crée un projet dans le compte de l'utilisateur de la clé : type, titre, adresse en texte, annonce suivie. Une clé BAN donnée est rangée dans les faits du projet. Le Hub réinjecte le projet dans chaque conversation qui lui est rattachée.

Coût: 0 crédit par appel réussi
Accès: À l'usage ou avec l'abonnement Data
Portée: hub
Outil MCP: projets_creer
Bac à sable: Non
Mémoire: Jamais gardée
Délai: 4 s

Essayer en direct

Paramètres

typetexteobligatoire
achat, vente_mandat ou location_gestion.
Valeurs : achat, vente_mandat, location_gestion
titretexteobligatoire
de 1 à 120 caractères
adressetexte
Adresse du bien, en texte.
200 caractères au plus
cle_bantexte
Clé d'interopérabilité de la Base Adresse Nationale, ex. 69383_1234_00012.
annoncetexte
Annonce suivie par le projet.
de 3 à 200 caractères

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/projets \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"type":"achat","titre":"<titre>"}'

Réponse

projetobjet
Afficher les 12 champsMasquer
- idtexte
  format uuid
- typetexte
- titretexte
- etapetexte
- annonce_idtexte ou null
  Identifiant Pillr de l'annonce suivie.
- adressetexte ou null
- faitsobjet
  Faits du projet (clés libres ; textes et urbanisme sont réservés).
- echeancesliste d'objets
- clos_letexte ou null
  Horodatage ISO 8601.
- cree_letexte ou null
  Horodatage ISO 8601.
- maj_letexte ou null
  Horodatage ISO 8601.
- nb_conversationsentier
creditsobjet
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).
Afficher les 2 champsMasquer
- debitesentier
  0 au moins
- restantsentier ou null

Erreurs possibles

400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
415type_contenuLe corps n'est pas envoyé en application/json
400corps_illisibleLe corps n'est pas un JSON lisible
413corps_trop_lourdLe corps dépasse la taille permise
401cle_absenteL'en-tête Authorization manque
401cle_invalideLa clé est inconnue, révoquée ou expirée
403organisation_suspendueL'organisation de la clé n'est pas active
403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
429plafond_cleLe plafond mensuel de crédits de la clé est atteint
429quota_minuteLe débit par minute de l'organisation est atteint
503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
503service_indisponibleL'API est momentanément indisponible
500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.

Un projet et son contexte

GET/api/v1/projets/{id}

Un projet du compte avec son contexte : les derniers évènements datés de son fil, les textes longs rangés (modèles de courrier, textes de boîtage) et les conversations du Hub qui lui sont rattachées.

Coût: 0 crédit par appel réussi
Accès: À l'usage ou avec l'abonnement Data
Portée: hub
Outil MCP: projets_lire
Bac à sable: Non
Mémoire: Jamais gardée
Délai: 4 s

Essayer en direct

Paramètres

idtexteobligatoire
Identifiant du projet.
format uuid

Exemple d'appel

curl https://pillr.fr/api/v1/projets/{id} \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

projetobjet
Afficher les 12 champsMasquer
- idtexte
  format uuid
- typetexte
- titretexte
- etapetexte
- annonce_idtexte ou null
  Identifiant Pillr de l'annonce suivie.
- adressetexte ou null
- faitsobjet
  Faits du projet (clés libres ; textes et urbanisme sont réservés).
- echeancesliste d'objets
- clos_letexte ou null
  Horodatage ISO 8601.
- cree_letexte ou null
  Horodatage ISO 8601.
- maj_letexte ou null
  Horodatage ISO 8601.
- nb_conversationsentier
evenementsliste d'objets
Afficher les 3 champsMasquer
- typetexte
- contenuobjet
- letexte ou null
  Horodatage ISO 8601.
textesliste d'objets
Afficher les 4 champsMasquer
- libelletexte
- textetexte
- datetexte
- empreintetexte
conversationsliste d'objets
Afficher les 3 champsMasquer
- idtexte
  format uuid
- titretexte ou null
- maj_letexte ou null
  Horodatage ISO 8601.
creditsobjet
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).
Afficher les 2 champsMasquer
- debitesentier
  0 au moins
- restantsentier ou null

Erreurs possibles

400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
401cle_absenteL'en-tête Authorization manque
401cle_invalideLa clé est inconnue, révoquée ou expirée
403organisation_suspendueL'organisation de la clé n'est pas active
403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
429plafond_cleLe plafond mensuel de crédits de la clé est atteint
429quota_minuteLe débit par minute de l'organisation est atteint
503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
503service_indisponibleL'API est momentanément indisponible
500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.

Modifier ou clore un projet

POST/api/v1/projets/{id}

Modifie un projet du compte : titre, étape, adresse, faits (fusionnés, hors des clés réservées textes et urbanisme), échéances personnelles, clôture ou réouverture, et suivi d'un dépôt d'urbanisme (démarche revalidée et échéances calculées par le moteur du site, jamais reçues).

Coût: 0 crédit par appel réussi
Accès: À l'usage ou avec l'abonnement Data
Portée: hub
Outil MCP: projets_modifier
Bac à sable: Non
Mémoire: Jamais gardée
Délai: 4 s

Essayer en direct

Paramètres

idtexteobligatoire
Identifiant du projet.
format uuid
titretexte
de 1 à 120 caractères
etapetexte
de 1 à 60 caractères
adressetexte ou null
200 caractères au plus
closbooléen
Vrai : clôt le projet ; faux : le rouvre.
faitsobjet
Faits du projet à fusionner : une clé en snake_case, une valeur JSON ; null retire la clé.
echeancesliste d'objets
Échéances personnelles : remplacent les précédentes, celles d'un dépôt d'urbanisme restent.
20 éléments au plus
Afficher les 2 champsMasquer
- libelletexteobligatoire
  de 1 à 120 caractères
- datetexteobligatoire
urbanismeobjet
Afficher les 2 champsMasquer
- demarcheobjet
  La démarche établie par demarche_urbanisme, revalidée ici.
- date_depottexte ou null
  Date du dépôt, AAAA-MM-JJ ; null retire les échéances du dépôt.
  10 caractères au plus

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/projets/{id} \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{}'

Réponse

projetobjet
Afficher les 12 champsMasquer
- idtexte
  format uuid
- typetexte
- titretexte
- etapetexte
- annonce_idtexte ou null
  Identifiant Pillr de l'annonce suivie.
- adressetexte ou null
- faitsobjet
  Faits du projet (clés libres ; textes et urbanisme sont réservés).
- echeancesliste d'objets
- clos_letexte ou null
  Horodatage ISO 8601.
- cree_letexte ou null
  Horodatage ISO 8601.
- maj_letexte ou null
  Horodatage ISO 8601.
- nb_conversationsentier
creditsobjet
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).
Afficher les 2 champsMasquer
- debitesentier
  0 au moins
- restantsentier ou null

Erreurs possibles

400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
415type_contenuLe corps n'est pas envoyé en application/json
400corps_illisibleLe corps n'est pas un JSON lisible
413corps_trop_lourdLe corps dépasse la taille permise
401cle_absenteL'en-tête Authorization manque
401cle_invalideLa clé est inconnue, révoquée ou expirée
403organisation_suspendueL'organisation de la clé n'est pas active
403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
429plafond_cleLe plafond mensuel de crédits de la clé est atteint
429quota_minuteLe débit par minute de l'organisation est atteint
503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
503service_indisponibleL'API est momentanément indisponible
500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.

Ranger un texte dans un projet

POST/api/v1/projets/{id}/textes

Range un texte long dans un projet (modèle de courrier, texte de boîtage) : même préparation que le site, coordonnées remplacées par une mention, données sensibles refusées, dédoublonnage et plafond de textes par projet. Le Hub le réinjecte dans les conversations du projet.

Coût: 0 crédit par appel réussi
Accès: À l'usage ou avec l'abonnement Data
Portée: hub
Outil MCP: projets_textes_ajouter
Bac à sable: Non
Mémoire: Jamais gardée
Délai: 4 s

Essayer en direct

Paramètres

idtexteobligatoire
Identifiant du projet.
format uuid
libelletexteobligatoire
de 1 à 60 caractères
textetexteobligatoire
de 1 à 2 200 caractères

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/projets/{id}/textes \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"libelle":"<libelle>","texte":"<texte>"}'

Réponse

rangebooléen
deja_rangebooléen
empreintetexte
masquesentier
Coordonnées remplacées par une mention dans le texte rangé.
oubliesliste de textes
Libellés des textes sortis parce que le plafond était atteint.
totalentier
plafondentier
creditsobjet
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).
Afficher les 2 champsMasquer
- debitesentier
  0 au moins
- restantsentier ou null

Erreurs possibles

400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
415type_contenuLe corps n'est pas envoyé en application/json
400corps_illisibleLe corps n'est pas un JSON lisible
413corps_trop_lourdLe corps dépasse la taille permise
401cle_absenteL'en-tête Authorization manque
401cle_invalideLa clé est inconnue, révoquée ou expirée
403organisation_suspendueL'organisation de la clé n'est pas active
403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
429plafond_cleLe plafond mensuel de crédits de la clé est atteint
429quota_minuteLe débit par minute de l'organisation est atteint
503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
503service_indisponibleL'API est momentanément indisponible
500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.

Retirer un texte d'un projet

POST/api/v1/projets/{id}/textes/retrait

Retire d'un projet le texte désigné par son empreinte. Retirer un texte absent ne change rien.

Coût: 0 crédit par appel réussi
Accès: À l'usage ou avec l'abonnement Data
Portée: hub
Outil MCP: projets_textes_retirer
Bac à sable: Non
Mémoire: Jamais gardée
Délai: 4 s

Essayer en direct

Paramètres

idtexteobligatoire
Identifiant du projet.
format uuid
empreintetexteobligatoire
de 1 à 40 caractères

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/projets/{id}/textes/retrait \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"empreinte":"<empreinte>"}'

Réponse

retirebooléen
totalentier
creditsobjet
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).
Afficher les 2 champsMasquer
- debitesentier
  0 au moins
- restantsentier ou null

Erreurs possibles

400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
415type_contenuLe corps n'est pas envoyé en application/json
400corps_illisibleLe corps n'est pas un JSON lisible
413corps_trop_lourdLe corps dépasse la taille permise
401cle_absenteL'en-tête Authorization manque
401cle_invalideLa clé est inconnue, révoquée ou expirée
403organisation_suspendueL'organisation de la clé n'est pas active
403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
429plafond_cleLe plafond mensuel de crédits de la clé est atteint
429quota_minuteLe débit par minute de l'organisation est atteint
503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
503service_indisponibleL'API est momentanément indisponible
500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.

Requêtes programmées du compte

GET/api/v1/briefs/programmes

Les questions programmées du compte : rythme, état actif ou en pause, erreurs consécutives (trois mettent la requête en pause), dernier et prochain passage.

Coût: 0 crédit par appel réussi
Accès: À l'usage ou avec l'abonnement Data
Portée: hub
Outil MCP: briefs_programmes
Bac à sable: Non
Mémoire: Jamais gardée
Délai: 3 s

Essayer en direct

Paramètres

Aucun.

Exemple d'appel

curl https://pillr.fr/api/v1/briefs/programmes \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

requetesliste d'objets
Afficher les 9 champsMasquer
- idtexte
  format uuid
- questiontexte
- programmetexte
  hebdomadaire, quinzaine ou mensuel.
- actifbooléen
- erreurs_consecutivesentier
- dernier_passage_letexte ou null
  Horodatage ISO 8601.
- prochain_passage_letexte ou null
  null : au prochain passage hebdomadaire (lundi, 06h00 UTC).
- cree_letexte ou null
  Horodatage ISO 8601.
- maj_letexte ou null
  Horodatage ISO 8601.
maxentier
creditsobjet
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).
Afficher les 2 champsMasquer
- debitesentier
  0 au moins
- restantsentier ou null

Erreurs possibles

400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
401cle_absenteL'en-tête Authorization manque
401cle_invalideLa clé est inconnue, révoquée ou expirée
403organisation_suspendueL'organisation de la clé n'est pas active
403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
429plafond_cleLe plafond mensuel de crédits de la clé est atteint
429quota_minuteLe débit par minute de l'organisation est atteint
503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
503service_indisponibleL'API est momentanément indisponible
500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.

Briefs rédigés

GET/api/v1/briefs

Les briefs rédigés pour le compte par ses requêtes programmées, les plus récents d'abord : texte en Markdown, statut, jetons consommés. Le détail des outils appelés se lit par brief.

Coût: 0 crédit par appel réussi
Accès: À l'usage ou avec l'abonnement Data
Portée: hub
Outil MCP: briefs_programmes_resultats
Bac à sable: Non
Mémoire: Jamais gardée
Délai: 3 s

Essayer en direct

Paramètres

programme_idtexte
Les briefs d'une seule requête programmée.
format uuid
limiteentier
Nombre d'éléments par page (50 au plus).
de 1 à 50 ; par défaut 10
curseurtexte
Curseur opaque rendu par la page précédente (curseur_suivant), à repasser tel quel.
de 1 à 1 024 caractères

Exemple d'appel

curl https://pillr.fr/api/v1/briefs \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

briefsliste d'objets
Afficher les 7 champsMasquer
- idtexte
  format uuid
- programme_idtexte ou null
  format uuid
- questiontexte ou null
  La question programmée, null si la requête a été supprimée depuis.
- textetexte
  Le brief rédigé, en Markdown.
- statuttexte
  done (rédigé) ou error.
- jetonsnombre ou null
- cree_letexte ou null
  Horodatage ISO 8601.
curseur_suivanttexte ou null
Curseur de la page suivante, à repasser dans curseur ; null sur la dernière page.
creditsobjet
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).
Afficher les 2 champsMasquer
- debitesentier
  0 au moins
- restantsentier ou null

Erreurs possibles

400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
401cle_absenteL'en-tête Authorization manque
401cle_invalideLa clé est inconnue, révoquée ou expirée
403organisation_suspendueL'organisation de la clé n'est pas active
403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
429plafond_cleLe plafond mensuel de crédits de la clé est atteint
429quota_minuteLe débit par minute de l'organisation est atteint
503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
503service_indisponibleL'API est momentanément indisponible
500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.

Un brief et ses résultats d'outils

GET/api/v1/briefs/{id}

Un brief rédigé, avec le résultat structuré de chaque outil que l'agent du Hub a appelé pour l'écrire.

Coût: 0 crédit par appel réussi
Accès: À l'usage ou avec l'abonnement Data
Portée: hub
Outil MCP: briefs_programmes_resultat
Bac à sable: Non
Mémoire: Jamais gardée
Délai: 3 s

Essayer en direct

Paramètres

idtexteobligatoire
Identifiant du brief.
format uuid

Exemple d'appel

curl https://pillr.fr/api/v1/briefs/{id} \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

briefobjet
Afficher les 7 champsMasquer
- idtexte
  format uuid
- programme_idtexte ou null
  format uuid
- questiontexte ou null
  La question programmée, null si la requête a été supprimée depuis.
- textetexte
  Le brief rédigé, en Markdown.
- statuttexte
  done (rédigé) ou error.
- jetonsnombre ou null
- cree_letexte ou null
  Horodatage ISO 8601.
outilsliste d'objets
Afficher les 2 champsMasquer
- nomtexte
- resultatvaleur
creditsobjet
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).
Afficher les 2 champsMasquer
- debitesentier
  0 au moins
- restantsentier ou null

Erreurs possibles

400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
401cle_absenteL'en-tête Authorization manque
401cle_invalideLa clé est inconnue, révoquée ou expirée
403organisation_suspendueL'organisation de la clé n'est pas active
403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
429plafond_cleLe plafond mensuel de crédits de la clé est atteint
429quota_minuteLe débit par minute de l'organisation est atteint
503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
503service_indisponibleL'API est momentanément indisponible
500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.