Lister les cohortes avec l'API PostHog
Liste les cohortes du projet avec id, nom, description, nombre de personnes et si elles sont statiques. Paginez avec limit et offset.
- Identifiant
- posthog_list_cohorts
L'appel
POST https://connect.reportei.com/api/tools/posthog_list_cohorts/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"project_id": "<project_id>"
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| project_id | string | Oui | Id of the project: the project_id of a team in List organizations, or the number after /project/ in the URL of PostHog. |
| search | string | Non | Text matched against the name. |
| type | string | Non | Only dynamic or only static cohorts.Valeurs : dynamic, static |
| limit | integer | Non | Cohorts per page. |
| offset | integer | Non | Index of the first cohort of the page. |
Connexions possibles
Votre client connecte son compte PostHog une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
À la connexion, votre client indique aussi {region} : l'adresse de son compte sur l'API de l'app.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/posthog_list_cohorts. Il devient la définition de tool de votre agent sans conversion.
Autres tools PostHog
- Lister les organisationsGETListe les organisations accessibles avec la clé, chacune avec ses projets dans teams. Le project_id de chaque team est ce que demandent les autres outils. Paginez avec limit et offset.
- Lister les définitions d'événementsGETListe les événements suivis dans le projet avec nom, description, tags et last_seen_at, à utiliser dans les requêtes et annotations. Paginez avec limit et offset.
- Exécuter une requêtePOSTExécute une requête d'analytics ad hoc et renvoie ses résultats, jusqu'à 100 lignes sauf si le SQL définit un LIMIT. Ce n'est pas un export : PostHog refuse OFFSET, limite chaque projet à 3 requêtes simultanées et débite chaque requête d'un budget de lecture horaire.
- Lister les insightsGETListe les insights du projet avec id, short_id, nom, description et query. Sauf si basic est true, chacun porte aussi son résultat en cache. Paginez avec limit et offset.
- Obtenir un insightGETRenvoie un insight avec sa requête et son résultat. Par défaut, le résultat vient du cache, et refresh à blocking le recalcule quand il est périmé.
- Lister les dashboardsGETListe les dashboards du projet avec id, nom, description, pinned et tags. Paginez avec limit et offset.
- Obtenir un dashboardGETRenvoie un dashboard avec ses filtres et ses tuiles, chaque tuile avec son insight et le résultat en cache.
- Lister les personnesGETListe les personnes du projet avec leurs distinct_ids et propriétés. search les trouve par email, nom, id de la personne ou distinct id. Paginez avec limit et offset.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
