PostHog

Retrieve a list of all projects in your PostHog organization. Use this to discover available projects, understand project structure, and get project IDs for other API calls. Returns project names, IDs, API tokens, and configuration settings.

Retrieve detailed information about a specific PostHog project including configuration settings, timezone, feature opt-ins (session recording, surveys, heatmaps), and group types. Use this to understand project settings and capabilities before performing other operations.

Retrieve information about the currently authenticated user including name, email, organization membership, and user UUID. Use this to verify authentication, understand user permissions, or get user details for audit logs.

Retrieve a list of feature flags in the project. Filter by active status (true/false/STALE), type (boolean/multivariant/experiment), search by name, or filter by tags and evaluation runtime (client/server). Use this to discover available flags, understand rollout configuration, find flags for specific features, or audit flag usage. Returns flag details including key, filters, variants, rollout percentage, and linked experiments.

Retrieve detailed information about a specific feature flag including its configuration, filters, rollout conditions, variants, and usage analytics. Use this to understand how a flag is configured, check rollout rules, review variant definitions, or see which experiments are linked to the flag.

Create a new feature flag in the project. Specify the flag key (unique identifier), name, rollout conditions, variants for multivariant tests, and targeting filters. Use this to programmatically create flags for new features, set up A/B tests, or configure gradual rollouts. The flag can be boolean, multivariant, or experiment type.

Update an existing feature flag's configuration including name, filters, rollout percentage, variants, active status, or tags. Use this to adjust rollout conditions, modify targeting rules, change variant distributions, or enable/disable flags. Supports partial updates - only provide fields you want to change.

Delete a feature flag from the project. This permanently removes the flag and its configuration. Use with caution - ensure the flag is no longer referenced in your application code before deletion. Consider deactivating the flag first as a safer alternative.

Retrieve a list of cohorts (user segments) in the project. Cohorts can be static (manually defined list of persons) or dynamic (automatically updated based on filters). Use this to discover available segments, understand cohort definitions, or find cohorts for targeting in experiments and feature flags. Returns cohort details including filters, person count, and calculation status.

Retrieve detailed information about a specific cohort including its definition filters, person count, calculation status, and whether it's static or dynamic. Use this to understand cohort membership criteria, check calculation progress for dynamic cohorts, or verify cohort size before using it in targeting.