PostHog

Retrieve a list of all actions

Create a new action

Retrieve details of a specific action

Update an action’s configuration

Delete an action (soft delete)

Retrieve activity log entries for a project

Retrieve a list of all alerts

Send a single event to PostHog

Send multiple events to PostHog in a single request

Retrieve a list of all dashboards

Create a new dashboard

Retrieve details of a specific dashboard

Update a dashboard’s configuration

Retrieve a list of event definitions in a project

Retrieve details of a single event definition

Retrieve a list of property definitions in a project

Retrieve details of a single property definition

Retrieve a list of all feature flags

Create a new feature flag

Retrieve details of a specific feature flag

Update a feature flag’s configuration

Retrieve a list of all group types

Delete a group type

Retrieve metrics for a specific group type

Create a new metric for a group type

Retrieve details of a specific group type metric

Update a group type metric’s configuration

Delete a group type metric

Update group types metadata

Get the current PostHog connection’s unified credentials and identity.

List unified organizations in PostHog.

Get a unified PostHog organization by ID.

Return the resource types PostHog supports for resource-scoped IAM queries.

List the members of a PostHog organization with their membership-level role attached.

List unified roles in PostHog.

Get a unified PostHog role by ID.

List unified users in PostHog.

Get a unified PostHog user by ID.

Retrieve a list of all insights

Create a new insight

Retrieve details of a specific insight

Update an insight’s configuration

Delete an insight (soft delete)

Fetches the organizations that the user has access to, with their id, name, and membership level. Use this to discover o…

Fetches projects that the user has access to in the current organization.

Create an event definition for an event that has not been ingested yet. Use this to define the event name, description,…

Get one event definition by its exact name, like ‘$pageview’ or ‘user_signed_up’. Returns the description, owner, tags,…

Update event definition metadata. Can update description, owner, tags, mark status as verified or hidden. Use exact even…

Update property definition metadata. Can update description, tags, property type (DateTime, String, Numeric, Boolean, Du…

Get a feature flag by its string key (e.g. “new-checkout”) — the identifier used in code and shown in the UI. Use this w…

Run an experiment’s metric queries and return primary/secondary metric results plus exposure data in one call, with self…

Get an experiment by its feature flag key (e.g. “new-checkout”) — the identifier used in code and shown in the UI. Use t…

Execute a saved insight’s query and return results. THIS IS THE ONLY WAY TO RETRIEVE INSIGHT RESULTS — the insights-list…

Fetch daily LLM cost per model for the project over the last N days (default 7). Runs a trends query summing $ai_total_c…

Add a cell to a markdown notebook. SQL and Python cells run as soon as they are added: the call waits up to ~45s and ret…

Create a notebook for deep, step-by-step data analysis: query PostHog and connected data warehouse data with SQL (HogQL)…

Delete a cell from a markdown notebook by node_id. Nothing downstream is touched: the response lists orphaned_dependents…

Run every SQL and Python cell of a markdown notebook, in document order, in one call. Cells run one at a time, and the r…

Run one SQL or Python cell of a markdown notebook as it is, by node_id. Use it to run a cell added with run: false, to r…

Keep waiting on a notebook run that notebooks-run started, and write each cell’s result into the document as it lands. W…

Update a cell by node_id. For a SQL or Python cell pass code to replace its source and re-run it. To run a cell unchan…

Executes HogQL — PostHog’s variant of SQL that supports most of ClickHouse SQL. “HogQL” and “SQL” are used interchangeab…

Use this tool to explore the user’s data schema. The user implements PostHog SDKs to collect events, properties, and pro…

List sync job history for a data warehouse source. Returns jobs sorted by most recent first, with status, duration, rows…

Enable / activate a draft workflow and start processing events. From then on it runs on real people: test it first with…

Archive a workflow — sets its status to ‘archived’, retiring it from active use while keeping it readable via workflows-…

Broadcast a batch workflow to its matching users NOW — sends real messages/webhooks, not a test. Workflow must be enable…

Attach a recurring RRULE schedule to a workflow with a ‘batch’ or ‘schedule’ trigger (iCalendar RRULE, e.g. ‘FREQ=WEEKLY…

Create a new action in the project. Actions define reusable event triggers based on page views, clicks, form submissions…

Delete an action by ID (soft delete - marks as deleted). The action will no longer appear in lists but historical data i…

Get a specific action by ID. Returns the action configuration including all steps and their trigger conditions.

Update an existing action by ID. Can update name, description, steps, tags, and Slack notification settings.

Get actions in the project. Actions are reusable event definitions that can combine multiple trigger conditions (page vi…

Archive a dataset by ID. Its revisions and items remain readable, but item mutations are rejected until the dataset is r…

Create an empty dataset in the current project. Dataset names are unique within a project. The first immutable revision…

Retrieve an active or archived dataset by UUID, including its metadata and latest committed revision.

Archive an active dataset item by stable item ID. Pass its current version as base_version to prevent a stale write. T…

Add an item to a dataset and create its first immutable version. input accepts any non-null JSON value. Use `expected_…

Retrieve the current immutable version of an active or archived dataset item by its stable item UUID. Pass revision to…

List active items in a dataset by default. Set archived to list archived items, or pass revision to inspect the exac…

Update an active item by stable item ID. Pass its current version as base_version to prevent a stale write. Each updat…

List active datasets in the current project by default. Filter by search text, UUIDs, or tags, or set archived to list…

Restore an archived dataset by ID. This makes item mutations available again without changing item states or creating a…

Update an active dataset’s name, description, or metadata by ID. These descriptive changes do not create a dataset revis…

Retrieve the team’s evaluation config and active provider key. Call before creating an llm_judge eval to confirm a provi…

Create an evaluation. ‘llm_judge’: set evaluation_config.prompt and model_configuration with provider and model; provide…

Soft-delete an AI observability evaluation. The evaluation stops running and is hidden from list views. Historical evalu…

Get a specific AI observability evaluation by its UUID. Requires the evaluation id (UUID) as a parameter — if you don’…

List provider+model combinations supported for llm_judge. Call it with no arguments to get every supported provider and…

List all AI observability evaluations for the current project. Optionally filter by name/description search or enabled s…

Create an evaluation report configuration. Reports summarize recent evaluation runs (using AI) and are delivered to emai…

Immediately trigger an AI-generated evaluation report for this report config. Enqueues a Temporal workflow that analyzes…

Get a specific evaluation report configuration by UUID. Returns the full config including frequency, delivery targets, t…

List all evaluation report configurations for the current project. Optionally filter by evaluation UUID using the ‘evalu…

List the run history for a specific evaluation report config. Each run record includes the generated report content, the…

Manually trigger an evaluation run for a specific $ai_generation event. Enqueues a Temporal workflow that asynchronously…

Partially update an AI observability evaluation. Requires the evaluation id (UUID). If you don’t have it, call llma-ev…

Create a new LLM prompt for the current team. Requires a unique name and prompt content (string or JSON object). Optiona…

Get a specific LLM prompt by name. Requires prompt_name, which takes either the prompt’s exact name or the id UUID f…

Point a label (for example ‘production’) at a specific version of an LLM prompt. A label is a movable pointer to exactly…

List all LLM prompts stored for the current team. Optionally filter by name. Pass label (e.g. ‘production’) to get eac…

Publish a new version of an existing LLM prompt by name. Name is immutable after creation. You can either provide the fu…

Fetch one LLM provider key by ID — its provider, name, and validation state, with a masked preview (never the secret). U…

List the team’s configured LLM provider keys (OpenAI, Anthropic, Azure, etc.). Returns each key’s provider, name, valida…

Create a new scorer (a.k.a. score definition) used by trace reviews. Pass name, kind (categorical, numeric, or `…

Retrieve a scorer by ID, including its current immutable config payload, current_version number, kind, archived stat…

List active scorers for the current project. By default only active rows are returned — pass archived=true to see only…

Publish a new immutable config version for an existing scorer. Use this whenever the scoring rules change (add/remove…

Update a scorer’s metadata: rename via name, edit description, or toggle archived to hide (true) or restore (`fa…

Retrieve an exact immutable scorer version by definition id and version_id UUID. Its pinned config determines how histor…

List immutable versions of a scorer definition, newest first, including versions with no recent results and archived sco…

Save a trace review. Supports an optional comment, an optional scores array, and an optional queue_id to clear a matchin…

Delete a trace review by ID. This soft-deletes the review so the same trace can be reviewed again later if needed.

Retrieve a saved trace review by ID. Returns the trace_id, comment, scores, creator, reviewer, and timestamps.

List saved trace reviews. Supports filtering by trace_id, definition_id, search, and ordering. Returns comments, scores,…

Update a trace review. Pass comment and/or the full desired scores array. You can also pass queue_id to clear only a mat…

List LLM traces to inspect AI/LLM usage across your application. Returns traces with their events, latency, token usage,…

Fetch a single LLM trace by its trace ID for deep inspection. Returns the trace and every nested event, with model param…

Create a new alert on an insight. Alerts can use either threshold-based conditions or anomaly detection. For threshold a…

Delete an alert by ID. This permanently removes the alert and all its check history. Subscribed users will no longer rec…

Post this insight alert to a Slack channel as well as emailing its subscribed users. The Slack workspace must already be…

Remove a destination from an insight alert by passing the hog_function_ids that alert-destinations-create returned. The…

Get a specific alert by ID. Returns the full alert configuration including check results, threshold settings, detector_c…

Run an anomaly detector on an insight’s historical data without creating any alert or check records. Use this to preview…

Update an existing alert by ID. Can update name, threshold, condition, config, detector_config, subscribed users, enable…

List all insight alerts in the project. Returns alerts with their current state, threshold or detector configuration, ti…

Create an annotation to mark an important change (for example, a deployment) on charts and trends. Provide a note in `co…

Soft-delete an annotation by ID. This hides the annotation from normal lists while preserving historical records.

Retrieve a single annotation by ID from the current project. Use this when you already know the annotation ID and want c…

List annotations in the current project, newest first. Use this to review existing deployment markers and analysis notes…

Update an existing annotation by ID. You can change its text (content), when it happened (date_marker, ISO 8601), it…

List the changes that can affect production in a time window, newest first: feature flag and experiment edits, error tra…

Create a new batch export. This tool supports typed destination configs for Databricks, AzureBlob, BigQuery, Postgres, A…

Soft-delete a batch export. Stops all future scheduled runs and hides the export from list and get operations. Historic…

Get a batch export by ID. Returns full non-sensitive configuration including destination type and config, linked integra…

Partially update a batch export. Top-level fields (name, paused, interval, timezone, offset_day, offset_hour, incrementa…

List batch exports in the project. Batch exports send event, person, session data, or HogQL query results to destination…

Fetch the organization’s current billing state: subscribed products and addons, available features, plan tier, usage sum…

Fetch time-series spend (cost in USD) breakdowns for the organization across a date range. Same dimensional parameters a…

Fetch time-series usage breakdowns for the organization across a date range. Supports per-team (project) and per-usage-t…

List available function templates. Templates are pre-built function configurations for common integrations (Slack, webho…

Get a specific function template by its template ID (e.g. ‘template-slack’, ‘template-geoip’). Returns the full template…

Create a new function. Requires ‘type’ (destination, site_destination, internal_destination, source_webhook, warehouse_s…

Delete a function by ID (soft delete). The function will no longer appear in lists or process events, but historical dat…

Test-invoke a function with a mock event payload. Sends the function configuration and test data to the plugin server fo…

List all functions (destinations, transformations, site apps, and source webhooks) in the project. Returns each function…

Retrieve execution logs for a specific CDP function by ID. Returns log entries with timestamp, level (DEBUG, LOG, INFO,…

Retrieve execution metrics for a specific CDP function by ID. Returns time-series data showing success and failure count…

Partially update a function. Can enable/disable the function, change its name, description, source code, inputs, filters…

Apply the config staged on a function to what is actually running. Two steps, and the first is mandatory on an enabled f…

Get a specific function by ID. Returns the full configuration including source code, inputs schema, input values (secret…

Add persons to a static cohort by their UUIDs. Only works for static cohorts (is_static: true). ‘person_ids’ must be per…

Create a cohort (a saved group of persons). Two kinds: - Dynamic cohort (default): provide ‘filters’ with AND/OR groups…

List all cohorts in the project. Returns a summary of each cohort including id, name, description, count (person count)…

Update an existing cohort’s name, description, or filters. Changing filters on a dynamic cohort triggers recalculation…

Get a specific cohort by ID. Returns the cohort name, description, filters (for dynamic cohorts), count of matching user…

Remove a person from a static cohort by their UUID. Only works for static cohorts (is_static: true). The person must exi…

Create a new outbound email ticket and send its first message to the recipient. The message IS EMAILED to the customer i…

List support tickets in the project. Supports filtering by status (new, open, pending, on_hold, resolved), priority (low…

Return a support ticket’s message thread, ordered chronologically. The response is paginated (default 50, max 200 per pa…

Soft-delete a private note on a support ticket. Only private notes authored by the calling user can be deleted. Customer…

Update a private note on a support ticket. Only private notes authored by the calling user can be edited. Customer-facin…

Post a reply or internal note to a support ticket. IMPORTANT: With is_private=false (the default), the reply IS DELIVERE…

Get a specific support ticket by ID or ticket number. Returns full ticket details including status, priority, assignee,…

Update a support ticket. Can change status (new, open, pending, on_hold, resolved), priority (low, medium, high, critica…

Create a saved ticket view: a named, reusable set of ticket filters. filters accepts status, priority, channel, sla, a…

List the saved ticket views in the project. Each view is a named, saved set of ticket filters — for example the per-team…

Get a saved ticket view by its short_id, including the full filters object that conversations-views-list omits. Read t…

Update a saved ticket view by its short_id. Can change the name, the saved filters, and is_favorited. Sending `filters…

Create a project in the caller’s active organization. A project is a separate data container with its own API token, so…

Retrieve a project and its settings. Omit the ID to get the caller’s active project. This is the one tool that returns t…

Update a project’s settings using PATCH semantics — only the fields included in the request body are changed. Use `proje…

Retrieve the authenticated user’s own profile and settings — identity (id, uuid, distinct_id, email, name), security/aut…

Update the authenticated user’s profile and settings using PATCH semantics — only the fields included in the request bod…

Create a new usage metric for the project. The metric surfaces on both group and person Customer Analytics profile pages…

Permanently delete a usage metric by id. Pass group_type_index: 0 — usage metrics apply to both groups and persons reg…

List usage metrics defined for the project. Usage metrics apply to both groups and persons on Customer Analytics profile…

Update fields on an existing usage metric. Accepts a subset of fields; unspecified fields are left unchanged. filters…

Fetch a single usage metric by id. Pass group_type_index: 0 — usage metrics apply to both groups and persons regardles…

Create a new dashboard. Provide a name and optional description, tags, and pinned status. All viewers see the descriptio…

Add a dashboard tile. Set type to text or image. Use Markdown headings, dividers, or notes for a text tile. The deskto…

Delete a dashboard by ID. The dashboard will be soft-deleted and no longer appear in lists.

Soft-delete a single tile (text, insight, widget, or button) from a dashboard. Behaves the same as the delete button in…

Get a specific dashboard by ID. Returns the dashboard with all its tiles: insight IDs, short IDs, names and descriptions…

Run all insights on a dashboard and return their results. Uses cached results by default (may be stale); set refresh to…

Reorder tiles on a dashboard by providing an array of tile IDs in the desired display order. First, use dashboard-get to…

List available dashboard templates and use them as reference material for dashboards on a topic such as product analytic…

Get a single dashboard template by ID, including its full tiles (each tile’s insight query and layout) and variables…

Copy an insight, text card, or widget tile from one dashboard to another. The path dashboard ID is the destination. Prov…

Transfer a tile from the source dashboard to another dashboard. This does not resize or reposition the tile. To resize o…

Resize, reposition, or update dashboard tiles. It can also update the dashboard name, description, pinned status, tags,…

Update the user-facing markdown body, agent context, layout, or color of an existing text tile on a dashboard. Pass the…

Soft-delete up to 100 dashboards by ID. Saved insights are kept by default. Set delete_insights to true to also delete i…

List dashboards in the project. The optional search parameter runs a fuzzy match against name and description using Po…

Inspect the full semantic-layer definition for one metric, addressed by the name returned from metric-list. The response…

List every governed business and telemetry metric in the team’s semantic layer. Call this before a typed domain tool or…

Add or replace a semantic description for a data-modelling view (saved query) or one of its columns. Use this ONLY for v…

List semantic descriptions of data-modelling views (saved queries) and their columns. Use this for views (table_type = ’…

Create a new data warehouse saved query (view). If a view with the same name already exists, it will be updated instead…

Delete a data warehouse saved query (view) by ID. This is a soft delete — the view is marked as deleted and will no long…

Get a specific data warehouse saved query (view) by ID. Returns the full view definition including the HogQL query, colu…

List all data warehouse saved queries (views) in the project. Returns each view’s name, materialization status, sync fre…

Enable materialization for a saved query. This creates a physical table from the view’s query and sets up a sync schedul…

Resume a saved query whose materialization was suspended after repeated failures. Scheduled runs skip a suspended view a…

Trigger a manual materialization run for a saved query. By default, this refreshes only the selected view. Set direction…

Get the 5 most recent materialization run statuses for a saved query. Each entry includes the run status and timestamp…

Undo materialization for a saved query. Deletes the materialized table and removes the sync schedule, reverting the view…

Update an existing data warehouse saved query (view). Can change the name, HogQL query, sync frequency, or description…

Add a semantic description for a data warehouse table or column. Provide the table id, the column_name (empty string for…

List semantic descriptions of data warehouse tables and columns. Pass ?table_id=<uuid> to scope to one table. Each entry…

Update the description of an existing warehouse table or column annotation by its id. The annotation is marked user-edit…

Make files in the user’s own S3-compatible bucket queryable as a warehouse table, without an import pipeline or a recurr…

Re-introspect a self-managed (manually linked) data warehouse table’s schema from its underlying source files and overwr…

Use this tool for any PostHog questions to search the documentation. If the user’s question mentions multiple topics, se…

Create a new early access feature. A feature flag is automatically created unless feature_flag_id is provided. Stage det…

Delete an early access feature by ID. Clears enrollment conditions from the linked feature flag but does not delete the…

List early access features in the current project. Returns name, stage, description, linked feature flag, and creation d…

Update an early access feature by ID. Changing the stage automatically updates the linked feature flag’s enrollment cond…

Get a single early access feature by ID. Returns full details including the linked feature flag configuration.

Create a new API endpoint from a HogQL or insight query. The name must be URL-safe (letters, numbers, hyphens, underscor…

Delete an endpoint by name. The endpoint is soft-deleted and its materialized views are cleaned up.

Get a specific endpoint by name. Returns the full endpoint configuration including query definition, version info, mater…

Get lightweight materialization status for an endpoint without fetching full endpoint data. Returns whether materializat…

Get the OpenAPI 3.0 specification for an endpoint. Returns a JSON spec that can be used with SDK generators like openapi…

Execute an endpoint’s query and return results. Uses materialized results when available, otherwise runs inline. For Hog…

Update an existing endpoint by name. Can update the query (auto-creates a new version), description, data freshness, act…

List all versions for an endpoint, in descending order (latest first). Each version contains the query snapshot, descrip…

Get all API endpoints in the current project. Endpoints expose saved HogQL or insight queries as callable API routes. Re…

Get the most recent execution time per endpoint (endpoint-level, personal API key calls only). Pass an array of endpoint…

Preview the materialization transform for an endpoint before enabling it. Returns the transformed HogQL, detected range…

Create a new external issue in GitHub, GitLab, Linear, or Jira, then link it to a PostHog error tracking issue as an ext…

Assign an error tracking issue to an organization member or role. Provide the issue ID as id and set assignee to a u…

Merge one or more error tracking issues into an existing target issue. Provide the target issue as id and the issues t…

Update an error tracking issue’s status, severity, name, or description. Use `error-tracking-issues-assign-partial-updat…

Split one or more fingerprints out of an existing error tracking issue into new issues. Provide the source issue as id…

List error tracking recommendations for the current project. Each row is a server-computed suggestion with a fixed `type…

Get the error tracking ingestion settings for the current project. Returns ingestion_enabled, which is false when inge…

Update the error tracking ingestion settings for the current project. Only the fields you include are applied; omitted f…

Get a presigned download URL for a source map symbol set by ID. The URL expires after one hour. Use it immediately, and…

List source map symbol sets for the current project. Supports pagination plus filtering by exact ref or upload `status…

Get a source map symbol set by ID. If you only have a symbol set reference, call error-tracking-symbol-sets-list with…

Get compact details for one Error tracking issue. Use this after query-error-tracking-issues-list when you have an `is…

Fetch sampled $exception events for one Error tracking issue. Use this when the user asks for concrete examples, stack…

List and filter Error tracking issues. Returns compact issue rows with aggregate impact counts (occurrences, users,…

Create an error tracking alert that fires when an issue is created, reopened, or starts spiking. An alert is a HogFuncti…

Delete an error tracking alert by ID (soft delete). The alert stops firing immediately, but the HogFunction row and its…

List error tracking alerts in the project. Pass type=internal_destination and inspect each entry’s filters.events fo…

Partially update an error tracking alert. Use to enable or disable an alert, rename it, change the destination channel/U…

Get the audit trail for a specific experiment by ID. Returns a paginated list of changes to the experiment, its holdouts…

Requires an experiment ID. If you don’t have the ID, load the finding-experiments skill to resolve the user’s reference…

Estimate the recommended sample size and how many days an experiment needs to run to detect an effect. This is a statele…

RULES (follow before calling): 1. Load the creating-experiments skill for the full creation workflow. 2. If the user…

Delete an experiment by ID. If you don’t have the ID, load the finding-experiments skill to resolve the user’s reference…

Requires an experiment ID. If you don’t have the ID, load the finding-experiments skill to resolve the user’s reference…

Get a single experiment by ID. If you have the experiment’s feature flag key instead of its ID, call experiment-get-by-f…

Create a holdout group — a reserved slice of users excluded from experiment exposure, used as a held-back baseline. Requ…

Delete a holdout group by ID. Use experiment-holdouts-list first if you don’t have the ID, and always confirm by name be…

List the experiment holdout groups in the current project. A holdout reserves a stable slice of users who are excluded f…

Get a single experiment holdout group by ID, including its name, description, and filters array (the held-out population…

Requires an experiment ID. If you don’t have the ID, load the finding-experiments skill to resolve the user’s reference…

List experiments in the current project. This is the primary tool for resolving experiment references — load the finding…

Requires an experiment ID. If you don’t have the ID, load the finding-experiments skill to resolve the user’s reference…

Requires an experiment ID. If you don’t have the ID, load the finding-experiments skill to resolve the user’s reference…

Requires an experiment ID. If you don’t have the ID, load the finding-experiments skill to resolve the user’s reference…

Create a reusable shared metric. Requires name (unique per project, case-insensitive) and query (kind=‘ExperimentMetric’…

Delete a shared metric by ID. REQUIRES EXPLICIT USER CONFIRMATION — confirm by name first, and warn that any experiments…

List shared metrics in the current project. Returns paginated results with id, name, description, query, created_at, upd…

Get a single shared metric by ID. Returns the full query JSON (metric_type, source, math, filters, etc.). If you don’t h…

Requires an experiment ID. If you don’t have the ID, load the finding-experiments skill to resolve the user’s reference…

Get aggregate experiment velocity statistics for the current project. Returns: launched_last_30d (experiments launched i…

Only for the day-by-day history of a SINGLE metric — how its results moved over the course of the experiment. For an exp…

Requires an experiment ID. If you don’t have the ID, load the finding-experiments skill to resolve the user’s reference…

RULES (follow before calling): 1. If changing rollout or variants on a RUNNING experiment, you MUST warn the user abo…

Create a feature flag in the current project. Call when the user asks to add a flag, gate a feature behind a flag, set u…

Soft-delete a feature flag by ID in the current project. A flag whose filters.version is 2 requires version, so read…

Archive a feature flag, hiding it from the default flag list. Requires the flag’s numeric ID; use `feature-flag-get-defi…

Turn a feature flag off. Requires the flag’s numeric ID; use feature-flag-get-definition-by-key to get it from a key,…

Turn a feature flag on. Requires the flag’s numeric ID; use feature-flag-get-definition-by-key to get it from a key, o…

Get feature flags in the current project. Supports list filters including search by feature flag key or name (case-insen…

Get a single feature flag’s full definition — rollout conditions, variants, payloads, active state — by its numeric ID…

Serve a feature flag to its whole audience: every user, or every group of the configured type when the flag aggregates b…

Set what percentage of one release condition’s audience a feature flag is served to. Requires the flag’s numeric ID; use…

Restore an archived feature flag to the default flag list. Requires the flag’s numeric ID; pass {"archived":"true"} to…

Soft-delete multiple feature flags in one call. Provide either ids (explicit list of flag IDs) OR filters (same shap…

Resolve feature flag IDs to their string keys in one call. Pass ids as a list of integer flag IDs. Returns keys as a…

Preview what a cross-project copy would do to a flag’s transitive flag dependencies. Copies nothing and changes nothing…

Copy a feature flag from one project to other projects within the same organization. Provide the flag key, source projec…

Get other active feature flags that depend on this flag. Use this to understand flag dependency chains before making cha…

Debug why feature flags evaluate a certain way for a given user. Provide a distinct_id and optionally groups to see each…

List feature flags in the current project along with their evaluated value for the authenticated user (the API key owner…

Check the health and evaluation status of a feature flag by ID. Returns a status (active, stale, deleted, or unknown) an…

Simulate how one feature flag (by numeric ID) would evaluate for a specific user, optionally at a past point in time (`t…

Update a feature flag by numeric ID (partial update: only the fields you include are changed). Use this for edits that h…

Fetches a single health issue by id so you can drill into what’s wrong AND explain how to fix it. Alongside the issue’s…

Lists health issues detected across all of this project’s PostHog health checks — outdated SDKs, data warehouse sync fai…

Returns aggregated counts of active, non-dismissed health issues for the project, broken down by severity and by kind. U…

Create a threshold-based alert on log streams. The alert periodically counts log entries matching the given filters and…

Attach a Slack, webhook, Microsoft Teams, or PagerDuty notification destination to a log alert. Without a destination an…

Remove a notification destination from a log alert by passing the hog_function_ids returned from logs-alerts-destination…

Permanently delete a log alert configuration by ID.

List historical events for a log alert — fires, resolves, errors, enable/disable toggles, threshold changes. Use to eval…

List log alert configurations in the current project, newest first. Returns alert name, state, threshold, filters, and s…

Update a log alert configuration by ID. Only the fields you provide are changed. Use this to adjust thresholds, filters,…

Get a log alert configuration by ID. Returns full details including current state, threshold settings, filters, and sche…

List values for a specific log attribute key. Use to discover what values exist before building filters. Defaults to att…

List available log attribute names for filtering. Defaults to attribute_type “log” (log-level attributes). To search res…

Return a scalar count of log entries matching a filter set. Use this as a cheap pre-flight before query-logs — if the…

Return per-value counts for a single facet — the distribution of a log dimension across a filter set, ordered by count d…

Mine recurring log templates (“patterns”) from the logs matching a filter set, ordered by frequency. Each pattern is a m…

List every service that logged in the window, with its health against a baseline. All other parameters go inside query…

Group this project’s MCP tool-call activity by the resolved client harness — the friendly product label for the MCP clie…

Return the headline numbers for a single MCP tool over the window: total calls, error count, p50 and p95 latency, unique…

Return a day-by-day time series for a single MCP tool: calls, errors, p50/p95 latency, unique users, and unique sessions…

Return the most common failure buckets for a single MCP tool, each with the resolved client harness it came from. Failur…

Return individual errored $mcp_tool_call events for a single MCP tool within one failure bucket, newest first (up to 50)…

Return the top callers of a single MCP tool: per caller, the call count, error rate, resolved harness labels, last-seen…

Return the tools most often called immediately before or after a single MCP tool within the same conversation. Pass tool…

Return recent sample agent intents recorded for a single MCP tool, each with its resolved client harness. Pass toolName…

Return the distinct effective tool-description strings seen for a single MCP tool over the window. Pass toolName (effect…

Return capabilities that agents asked this MCP server for but could not access. Each row contains one $mcp_missing_capab…

Delete a notebook by short_id. The notebook will be soft-deleted and no longer appear in lists.

The full notebook view: title, markdown source, the notebook’s variables (name, type, value; a SQL cell reads one as `{n…

List all notebooks in the project. Supports filtering by search term, created_by, last_modified_by, date_from, date_to,…

Update an existing notebook by short_id. Can update title, content, and deleted status. IMPORTANT: when updating the con…

Read the durable state of a cell run: status (‘running’, ‘done’, ‘failed’, ‘interrupted’) and, once done or interrupted,…

Delete up to 1000 persons by PostHog person UUIDs or distinct IDs. Optionally delete associated events and recordings. P…

Get all cohorts that a specific person belongs to. Requires the person_id query parameter.

List persons in the current project. Supports search by email (full text) or distinct ID (exact match), and filtering by…

Remove a single property from a person by key. The property is deleted asynchronously via the event pipeline ($unset).

Set properties on a person. Pass key and value for one property, or properties for up to 1000 in a single request, which…

Retrieve a single person by numeric ID or UUID. Returns the person’s properties, distinct IDs, and metadata.

Get distinct values for a person property key. Useful for discovering what values exist for properties like ‘plan’, ‘rol…

Count comments, optionally narrowed to one resource by scope (e.g. Dashboard, Insight, FeatureFlag) and item_id. Use whe…

Get a specific comment by ID including its content, rich content with mentions, and metadata.

Get the full thread of replies for a parent comment. Useful for reading complete discussions on a resource.

Create a comment on an accessible resource, or reply by passing source_comment. For a canvas use scope canvas and th…

List comments across the project. Filter by scope (Dashboard, FeatureFlag, Insight, etc.) and item_id to find discussion…

List all members of the current organization with their names, emails, membership levels (member, admin, owner), and las…

Get details of an organization by ID including name, membership level, member count, teams, projects, and the plan featu…

List all organizations the user has access to. Returns org ID, name, slug, and membership level. Use the ID with organiz…

Get details of a specific role including its name, creation date, and creator.

List all members assigned to a specific role. Shows who has which role in the organization.

List all roles defined in the organization. Roles group members and can be used in approval policies and access control…

Get the authenticated user’s pinned navigation tabs and configured homepage for the current team. The homepage is the pa…

Update the authenticated user’s pinned tabs and/or homepage for the current team. Pass @me as the UUID. The homepage c…

List the caller’s PostHog AI (Max) chat threads in the project. Threads are ordered by most recent update. Each result h…

Get one PostHog AI (Max) chat thread by id. The response includes the full message thread in the messages field. The t…

Counts of autocapture clicks, rage clicks, and dead clicks grouped by page element, ordered by count. Each result carrie…

Create a new saved insight from a name and query definition. Test queries with query-trends / query-funnel / query-reten…

Soft-delete an insight by ID. The insight will be marked as deleted and no longer appear in lists.

Fetch a saved insight by its numeric id or 8-character short_id. Returns the insight metadata and query definition,…

Update a saved insight by numeric id or short_id. Can update name, description, query, tags, favorited status, and d…

List saved insights in the project with optional filtering by favorited status or search term. Returns metadata only (na…

Returns the most-viewed insights in the project, ranked by view count over the last N days (default 7). Use this to surf…

Run a trends query to analyze metrics over time. Trends insights visualize events over time using time series. They’re u…

Run a funnel query to analyze conversion rates through a sequence of steps. Funnel insights help understand user behavio…

Run a retention query to analyze how many users return over time after performing an initial action. Retention insights…

Run a stickiness query to measure how many intervals (e.g. days) within a date range users performed an event. Stickines…

Run a paths query to analyze the most common sequences of events or pages that users navigate through. Paths insights vi…

Run a lifecycle query to categorize users into lifecycle stages based on their activity pattern relative to a single eve…

List the persons behind a specific data point in a trends insight. Use this to answer “who were the users that did X on…

List the persons in a specific bucket of a lifecycle insight. Use this to answer “who are the new / returning / resurrec…

List the persons behind a paths insight — either everyone who traversed the path, or those at one specific node/edge. Pa…

List the persons in one retention acquisition cohort and show, for each, which subsequent intervals they came back in. P…

List the persons behind one bar of a stickiness insight — the users who were active in a given number of intervals. Pair…

List the persons behind one step of a funnel insight — either those who converted through it or those who dropped off at…

Delete a batch of session recordings by session ID, up to 100 per call. Deletion is permanent and cannot be undone — con…

Delete a session recording by ID. This permanently removes the recording data. Use for privacy or compliance workflows…

Get a specific session recording by ID. Returns full recording metadata including duration, interaction counts, console…

Create a new session recording playlist. Set type to ‘collection’ for a manually curated list or ‘filters’ for a saved f…

Get a specific session recording playlist by short_id. Returns full playlist metadata including name, description, filte…

Update an existing session recording playlist by short_id. Can update name, description, pinned status, and filters. Set…

List session recording playlists in the project. Returns both user-created and synthetic (system-generated) playlists wi…

List session recordings in the project. Returns recording metadata including duration, activity counts, console errors,…

Create a recurring subscription. The kind is inferred from which field you populate and returned as the read-only `resou…

Soft-delete a subscription. Stops all future deliveries and returns the subscription with deleted: true. One-way via M…

List the team’s subscriptions. Use search to filter by title, insight name (including the auto-generated name of an un…

Update a subscription’s mutable fields (title, target, schedule, the prompt for prompt subscriptions, enabled). The…

Fetch a single subscription by numeric ID. Returns its kind (resource_type: insight, dashboard, or ai_prompt), target…

List the AI summaries that subscriptions sent for one insight or dashboard, newest first. Set exactly one of insight o…

Trigger an immediate test delivery of a subscription to its configured target(s) (email, Slack, or Microsoft Teams). Run…

Creates a new survey in the project. For the draft, targeting, preview, and launch workflow, load the creating-surveys s…

Delete a survey by ID (soft delete - marks as archived).

Get a specific survey by ID. Returns its questions, targeting flag — including current property targeting rules under ta…

Launch a survey by setting start_date to the current time. Prefer this over survey-update with a manual start_date…

Get response statistics for a specific survey. Includes detailed event counts (shown, dismissed, sent), unique responden…

Stop a survey by setting end_date to the current time. No new responses are accepted after this; existing responses re…

Update an existing survey by ID. Omitted top-level fields are preserved, but nested objects and arrays you provide may r…

List surveys in the project. Use search for fuzzy match against survey name and description (handles typos and prefix-…

Get aggregated response statistics across all surveys in the project. Includes event counts (shown, dismissed, sent), un…

List individual responses for a specific survey. Question text is already resolved server-side — callers do not need to…

Summarize survey responses using PostHog’s LLM summarization. Pass question_id (preferred) or question_index to get a pe…

Query trace spans with filtering by service name, status code, date range, and structured attribute filters. Supports cu…

Create a place where warehouse sources write synced rows, from an integration that holds the credentials. Get the integr…

List the places this project’s warehouse sources can write synced rows to. The PostHog warehouse is one of them, and it…

Read one warehouse destination, including the target database or schema it writes to. Credentials live on the linked int…

Cancel a currently running sync job for a specific table schema. If no sync is running, returns an error. Use ‘external-…

List all table schemas across all data warehouse sources. Each schema represents one table being synced from an external…

Update one table schema’s sync configuration: enable/disable syncing (should_sync), sync_type (incremental, full_refresh…

Trigger a sync for a single table schema using its configured sync method (incremental, full refresh, append, or CDC). U…

Trigger a full resync for a table schema, discarding all previously synced data and re-importing from the source. This c…

Get a single table schema by ID. Returns full details including sync status, sync frequency, incremental field, primary…

List external data sources that can be used as a connectionId when running execute-sql against an external source: pure…

Low-level create for a data warehouse import source when you need to hand-pick tables and sync types. If you only have c…

Delete a data warehouse source and all its table schemas, synced tables, and sync schedules. This is a soft delete. Any…

Check what external data is already connected before answering any revenue, billing, subscription, CRM, support-ticket,…

Update an existing data warehouse source’s prefix (table name prefix in HogQL) or description. Cannot change the source_…

Fetch the latest table list from the remote database and create schema entries for any new tables found. This is a metad…

Trigger a sync for all enabled table schemas in the source using each table’s configured sync method. If the source uses…

Get a single data warehouse source by ID. Returns full details including source type, connection status, prefix, all tab…

Drill into the individual session interactions behind one or more heatmap coordinates. Pass points as a JSON array of…

Aggregated heatmap interactions captured on a page. Filter by url_exact (one page) or url_pattern (regex across page…

Create a saved heatmap for a page URL. For type ‘screenshot’ (the default) this enqueues a headless render of the page a…

Get a single saved heatmap by its short_id, including per-width render status. Poll this after `heatmaps-saved-creat…

List saved heatmaps for the project. A saved heatmap pins a page URL plus a set of viewport widths and (for type ‘screen…

Re-run screenshot generation for a saved heatmap of type ‘screenshot’ by its short_id. Clears the existing renders and…

Update a saved heatmap by its short_id. Send only the fields to change — rename via name, change widths, or soft-d…

Run a web analytics overview query — high-level KPIs over a period: visitors, pageviews, sessions, average session durat…

Run a web analytics breakdown table query — top pages, UTMs, devices, browsers, countries, etc. — with visitors and page…

Per-page Core Web Vitals breakdown — one metric at one percentile, with pages bucketed into good / `needs_improvements…

Create a workflow. For one email sent once or on a schedule to an audience (a batch trigger, one email step and an exit)…

Get a specific workflow by ID, where id is the workflow’s UUID. When you have a workflow’s name instead, resolve it firs…

Get a single workflow invocation by invocation_id, including invocation_globals — the raw triggering payload (event/pers…

At-a-glance health across ALL workflows in one call: per-workflow succeeded/failed counts over a window (after/before, d…

List all workflows in the project. Returns workflows with their name, description, status (draft/active/archived), versi…

List past batch runs for a workflow (both one-off broadcasts and schedule-triggered runs). Each entry shows the audience…

List a workflow’s individual invocations (one execution per person/event), each collapsed to its final outcome — status,…

Surgically edit a workflow’s graph by sending a small, ordered list of operations instead of resending every action and…

Apply a workflow’s staged draft to its live config. Two-step: call without confirm first — it returns in_flight_runs, a…

Execution stats for a single workflow by ID: time-series success/failure counts over a configurable interval (hour, day,…

Test-invoke a workflow one node at a time; it does NOT traverse the full graph in one call. The result includes nextActi…

Updates workflow fields a graph patch can’t express: name, description, tags, exit_condition, conversion, trigger_maskin…

Update a recurring schedule’s RRULE, start time, timezone, or variable overrides. Changing the cadence reschedules the n…

Retrieve a list of organization members

Update a member’s details

Remove a member from the organization

Retrieve a list of organizations

Retrieve details of a specific organization

Create a new organization

Update an organization’s settings

Delete an organization

List all organization-level integrations

Retrieve a list of all projects in the organization

Retrieve details of a project, including the current one

List all projects in an organization

Create a new project within an organization

Retrieve details of a specific project

Update a project’s configuration

Delete a project

Move a project to a different organization

Mark product onboarding as complete

Run a HogQL query against project data

Retrieve the status and results of an asynchronous query

Cancel a running asynchronous query

Retrieve a list of insight variables in a project

Retrieve details of a single insight variable

Create a variable that HogQL queries can substitute

Delete an insight variable from a project

Update an existing insight variable

Retrieve a list of all roles

Create a new role

Retrieve details of a specific role

Update a role’s details

Delete a role

List all memberships for a specific role

Assign a user to a role

Retrieve details of a specific role membership

Remove a user from a role

Retrieve a list of all session recordings

Retrieve details of a specific session recording

Update a session recording’s metadata

Delete a session recording

Retrieve a list of all users

Retrieve details of a specific user

Update a user’s details

Delete a user

Retrieve a list of data warehouse tables in a project

Retrieve details of a single data warehouse table

Create a data warehouse table from files in an S3-compatible bucket

Update a data warehouse table

Delete a data warehouse table

Retrieve a list of saved queries (views) in a project

Retrieve details of a single saved query (view)

Create a saved query (view) from a HogQL query

Update a saved query (view)

Delete a saved query (view)

Retrieve a list of joins between warehouse tables and PostHog tables

Retrieve details of a single join

Join a warehouse table or view onto another table

Delete a join between tables

Emits when a $pageview event is captured in PostHog, indicating a page was visited on the web.

Emits when a $pageleave event is captured in PostHog, indicating a visitor left a page.

Emits when a $screen event is captured in PostHog, indicating a screen was viewed in a mobile app.

Emits when an auto-captured interaction such as a click, form submission, or input change occurs.

Emits when an anonymous visitor is identified against a known distinct ID in PostHog.

Emits when person properties are set or updated on a PostHog person profile.

Emits when a group is created or its properties are updated in PostHog.

Emits when a feature flag is evaluated for a user in PostHog.

Emits when an error or exception is captured by PostHog error tracking.

Emits when any custom (non-system) event is captured in PostHog. The original event name is preserved in the payload.