Tapez pour filtrer les pages, les guides et les endpoints.
Chaque endpoint, ses paramètres, ses réponses, et les outils du serveur MCP.
API v1
Créer et lire vos clients, projets, tâches et étapes depuis vos propres outils — un script, un agent, une automatisation.
Authentification
Une clé d'API par organisation, dans l'en-tête Authorization. Comment l'obtenir, ce qu'elle donne, ce qui la refuse.
Conventions
Format des erreurs, nommage, pagination par curseur, idempotence et limite de débit — communs à toutes les routes.
Créer un projet
/api/v1/projectsCrée un projet pour un client — existant, ou créé à la volée — et renvoie le lien de son portail.
Lister les projets
/api/v1/projectsLes projets de l'organisation, les plus récents d'abord.
Lire un projet
/api/v1/projects/{ref}Le détail d'un projet, par id ou par slug, avec son client, son nombre de tâches et l'URL de son portail.
Créer une tâche
/api/v1/projects/{ref}/tasksAjoute une tâche à un projet — pour vous, ou à faire par le client dans son portail.
Lister les tâches
/api/v1/projects/{ref}/tasksLes tâches d'un projet, les plus récentes d'abord, filtrables par statut.
Lire une tâche
/api/v1/projects/{ref}/tasks/{task}Le détail d'une tâche, par id ou par slug.
Modifier une tâche
/api/v1/projects/{ref}/tasks/{task}Met à jour une tâche : seuls les champs fournis changent.
Lire l'onboarding
/api/v1/projects/{ref}/onboardingLes questions du questionnaire d'onboarding d'un projet, et les réponses du client.
Ajouter des questions d'onboarding
/api/v1/projects/{ref}/onboarding/questionsAjoute des questions à une étape du questionnaire, sans toucher au reste ni aux réponses déjà saisies.
Envoyer des chiffres
/api/v1/projects/{ref}/metrics/dataEnvoie les valeurs des indicateurs d'un projet. La page Résultats du portail client les affiche dans les 30 secondes.
Définir des indicateurs
/api/v1/projects/{ref}/metricsCrée ou met à jour les indicateurs d'un projet : leur libellé et leur explication pour le client, leur unité, leur calcul.
Lire les résultats
/api/v1/projects/{ref}/metricsLes indicateurs d'un projet avec leur valeur sur une période, celle de la période précédente et la variation.
Préparer un rapport
/api/v1/projects/{ref}/reportsPrépare le rapport d'une période avec le mot de l'agence ; il peut être publié et envoyé au client par mail.