Où en est l'API
Il n’y a pas encore d’API REST publique. Les routes /v1 ne sont pas livrées : aucune
adresse ne répond aujourd’hui, et appeler /v1/notes renvoie une erreur de route inconnue. Cette
page dit exactement ce qui existe, pour que vous ne cherchiez pas ailleurs.
Ce qui est livré : les clés
Section titled “Ce qui est livré : les clés”Depuis le 11 novembre 2026, une personne peut créer une clé d’API personnelle dans Paramètres > Connecteurs > Clés d’API (bureau). L’iPhone les liste et les révoque, sans les créer : un secret se colle dans un outil, donc depuis un ordinateur.
| Forme | kpn_ suivi de 43 caractères |
| Ce qui est conservé | Le SHA-256 du secret, jamais le secret : il s’affiche une fois |
| Ce que montrent les listes | Le préfixe (les 12 premiers caractères), pour reconnaître une clé |
| Clés actives | 20 au plus par personne |
| Validité | 30 jours, un an (par défaut) ou sans expiration |
| Révocation | Immédiate et définitive |
| Offre | api (Pilote, Pro, Business) pour créer ; lister et révoquer reste possible en Free |
Une clé reçoit les mêmes droits que le MCP (notes:read, notes:write, contacts:write,
transcripts:read, files:read, calendar:read) plus webhooks:manage. Une clé ne peut ni en
créer une autre ni se révoquer : les routes qui les gèrent (GET, POST, DELETE
/me/api-keys) n’acceptent que les jetons de l’application.
Une clé ne sert à rien pour l’instant. Elle est faite pour les routes à venir : la créer aujourd’hui ne donne accès à rien, et c’est normal.
Ce qui est posé côté serveur, et invisible
Section titled “Ce qui est posé côté serveur, et invisible”Le socle est en place, sans route publique pour l’utiliser :
- une garde qui authentifie
Authorization: Bearer kpn_…, refuse une clé inconnue, révoquée ou expirée (401), un compte suspendu, une offre sans le droitapi(403 plan_required, vérifiée à chaque appel) et un droit manquant (403 insufficient_scope) ; - une limite de débit par clé : 600 lectures et 60 écritures par minute, avec
X-RateLimit-Limit,X-RateLimit-Remaining,X-RateLimit-Reset, et429 rate_limitedau-delà ; - les schémas publics versionnés (
v1) : une note, un kalepin, un compte rendu, un enregistrement, une transcription, un espace, une action, une erreur.
Ce qui vient
Section titled “Ce qui vient”Dans l’ordre : les routes /v1 en lecture (notes, kalepins, espaces, enregistrements,
transcriptions, compte rendu, actions, avec pagination par curseur et filtre updatedSince),
puis l’écriture, puis la référence interactive de cette page — générée depuis les mêmes schémas,
pour qu’elle ne puisse pas mentir.
En attendant, les deux portes utilisables sont le serveur MCP et les webhooks.