> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# PostHog

> Connect PostHog to your Atako agents — 26 read and 23 write actions.

Let your agents work with your PostHog analytics — run queries, manage feature flags, insights, dashboards, cohorts, surveys and experiments.

## Connection

* **Authentication**: API key (Personal API key (phx\_...)).
* **Required settings**:
  * **Cloud region** — us for US Cloud, eu for EU Cloud

<Note>
  PostHog → click your avatar (top right) → Account settings → Personal API keys → Create personal API key. Pick the organization/project, grant only the scopes your agent needs (e.g. query:read, action:write, annotation:write, cohort:write, dashboard:write, insight:write, feature\_flag:write, experiment:write, survey:write, person:write), then copy the key (starts with phx\_) — it is shown only once.

  See [PostHog's documentation](https://posthog.com/docs/api).
</Note>

## Read actions (26)

| Action                       | Description                                                                  |
| ---------------------------- | ---------------------------------------------------------------------------- |
| `get_action`                 | Fetch a single action by id.                                                 |
| `get_alert`                  | Fetch a single alert by id (UUID).                                           |
| `get_annotation`             | Fetch a single annotation by id.                                             |
| `get_cohort`                 | Fetch a single cohort by id.                                                 |
| `get_dashboard`              | Fetch a single dashboard (including its tiles) by id.                        |
| `get_early_access_feature`   | Fetch a single early access feature by id (UUID).                            |
| `get_experiment`             | Fetch a single experiment by id.                                             |
| `get_feature_flag`           | Fetch a single feature flag by numeric id.                                   |
| `get_insight`                | Fetch a single insight by numeric id.                                        |
| `get_person`                 | Fetch a single person by numeric id.                                         |
| `get_survey`                 | Fetch a single survey by id (UUID).                                          |
| `list_actions`               | List the actions (saved event definitions) of a project.                     |
| `list_alerts`                | List the insight alerts of a project.                                        |
| `list_annotations`           | List annotations of a project, optionally filtered by a search term.         |
| `list_cohort_persons`        | List the persons belonging to a cohort.                                      |
| `list_cohorts`               | List the cohorts of a project.                                               |
| `list_dashboards`            | List the dashboards of a project.                                            |
| `list_early_access_features` | List the early access features of a project.                                 |
| `list_events`                | Fetch recent raw events, optionally filtered by event name or person.        |
| `list_experiments`           | List the A/B test experiments of a project.                                  |
| `list_feature_flags`         | List the feature flags of a project.                                         |
| `list_insights`              | List the saved insights of a project.                                        |
| `list_persons`               | List persons in a project, filterable by search term, email or distinct\_id. |
| `list_projects`              | List the projects the API key can access (use this to find project\_id).     |
| `list_surveys`               | List the surveys of a project.                                               |
| `query`                      | Run a read-only HogQL (SQL) query against project analytics data.            |

## Write actions (23)

| Action                        | Description                                                                       |
| ----------------------------- | --------------------------------------------------------------------------------- |
| `create_action`               | Create an action (saved event definition) with optional match steps.              |
| `create_alert`                | Create an alert on an insight (notifies when a threshold condition is met).       |
| `create_annotation`           | Create an annotation (e.g. mark a release or campaign on graphs).                 |
| `create_cohort`               | Create a cohort (dynamic via filters, or static).                                 |
| `create_dashboard`            | Create an empty dashboard to pin insights on.                                     |
| `create_early_access_feature` | Create an early access feature users can opt into, optionally linked to a flag.   |
| `create_experiment`           | Create an A/B test experiment in draft status, backed by a feature flag key.      |
| `create_feature_flag`         | Create a feature flag with optional release conditions.                           |
| `create_insight`              | Create a saved insight from a query definition (trends, funnel, HogQL...).        |
| `create_survey`               | Create a survey (created unlaunched; launch it from the PostHog UI or API).       |
| `delete_action`               | Delete an action (soft delete, as required by the API).                           |
| `delete_alert`                | Permanently delete an alert by id (UUID).                                         |
| `delete_annotation`           | Delete an annotation (soft delete, as required by the API).                       |
| `delete_cohort`               | Delete a cohort (soft delete, as required by the API).                            |
| `delete_dashboard`            | Delete a dashboard (soft delete, as required by the API).                         |
| `delete_early_access_feature` | Permanently delete an early access feature by id (UUID).                          |
| `delete_experiment`           | Delete an experiment (soft delete, as required by the API).                       |
| `delete_feature_flag`         | Delete a feature flag (soft delete, as required by the API).                      |
| `delete_insight`              | Delete an insight (soft delete, as required by the API).                          |
| `delete_person`               | Delete persons by numeric id or distinct\_id (optionally including their events). |
| `delete_survey`               | Permanently delete a survey by id (UUID).                                         |
| `update_feature_flag`         | Update a feature flag (toggle active, change name or release conditions).         |
| `update_person`               | Update the properties of a person.                                                |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.