Rapports personnalisés
Les rapports personnalisés créés dans la section Rapports personnalisés de l’application : listez-les, lisez-en un avec les données de chaque widget telles que sa page les affiche, et envoyez-le immédiatement par e-mail à ses destinataires. À partir du forfait Scale. Les adresses des destinataires, le jeton du lien partagé et le mot de passe ne sont jamais renvoyés.
GET/custom_reports
Les rapports personnalisés du projet, du plus récent au plus ancien, avec leur période, leur calendrier d’envoi, leur nombre de destinataires, l’état de publication du lien partagé et les widgets que chacun affiche. Également disponible via l’outil MCP list_custom_reports.
project_idobligatoirepageper_page20 par défaut, 100 maximumoutput
GET/custom_reports/:id
La configuration d’un rapport (période, filtres de modèle, de tag, de marque dans le prompt et de concurrents, calendrier d’envoi, mise en page) et les données de chaque widget calculées au moment de l’appel, soit les mêmes chiffres que ceux de sa page, de son lien partagé et de son PDF. Chaque widget porte un kind et un objet data dont la structure dépend de ce kind : series (timeseries), slices (donut), bars (bar), values et changes (kpi_grid) ou rows (table). Un widget dont la source de données n’est pas connectée renvoie available: false. Lecture seule. Également disponible via l’outil MCP get_custom_report.
project_idobligatoire:iddans l’URL
Renvoie ERR_NOT_FOUND pour un rapport qui n’appartient pas au projet.
POST/custom_reports/:id/send
Envoie dès maintenant le rapport par e-mail à ses destinataires, comme le bouton « Envoyer maintenant » de la page du rapport : le rapport doit être publié et avoir au moins un destinataire (sinon ERR_INVALID_PARAM), et chaque rapport ne peut être envoyé qu’une fois toutes les 10 minutes (429 ERR_RATE_LIMITED avec Retry-After). Renvoie 202 dès que le PDF est mis en file d’attente. Indisponible depuis un portail en marque blanche ou pour un rapport créé dans un tel portail (ERR_INTEGRATION_UNAVAILABLE). Nécessite une clé API avec droit d’écriture et, pour les membres de l’équipe, l’autorisation de modification sur les rapports personnalisés. Également disponible via l’outil MCP send_custom_report.
:idID du rapport
Corps (JSON) : project_id (obligatoire).