Posthog

Learn how to use Posthog with Composio

Overview

Enum

POSTHOG

Description

PostHog is an open-source product analytics platform tracking user interactions and behaviors to help teams refine features, improve funnels, and reduce churn

Authentication Details

subdomain
stringDefaults to us.iRequired
apiKey
stringRequired

Actions

Add collaborators to a specific project dashboard. requires ‘project id’ and ‘dashboard id’. supports json, form-urlencoded, and multipart data. returns added collaborator details. auth: ‘personalapikeyauth’.

Action Parameters

added_at
stringRequired
dashboard_id
integerRequired
id
stringRequired
project_id
stringRequired
updated_at
stringRequired
user_uuid
stringRequired

Action Response

data
object
error
successful
boolean

Add a member to an organization role by submitting their details and uuid in json/form, using organization and role ids. requires personalapikeyauth. success gives a 201 status.

Action Parameters

id
stringRequired
joined_at
stringRequired
organization_id
stringRequired
role_id
stringRequired
updated_at
stringRequired
user_uuid
stringRequired

Action Response

data
object
error
successful
boolean

Add members with specific roles to a project by providing their user uuid and level (member or admin). requires project id in the url. supports json, form-data, and form-urlencoded input. returns the newly created membership data upon success.

Action Parameters

id
stringRequired
joined_at
stringRequired
parent_level
integerRequired
parent_membership_id
stringRequired
project_id
stringRequired
updated_at
stringRequired
user_uuid
stringRequired

Action Response

data
object
error
successful
boolean

Set up role-based access for a feature flag using project id and feature flag id. submit access info in json or form format, with feature flag:write rights. success returns new details with a 201 code.

Action Parameters

added_at
stringRequired
feature_flag_id
integerRequired
id
integerRequired
project_id
stringRequired
role_id
stringRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Create a bookmark for an activity notification in a project’s activity log. requires a project id and json payload with activity details. supports verification status, impersonation flags, and system activity distinction.

Action Parameters

activity
stringRequired
created_at
string
detail
id
stringRequired
is_system
boolean
item_id
string
organization_id
string
project_id
stringRequired
scope
stringRequired
unread
booleanRequired
user__distinct__id
string
user__email
string
user__first__name
string
user__hedgehog__config
object
user__id
integer
user__is__email__verified
boolean
user__last__name
string
user__uuid
string
was_impersonated
boolean

Action Response

data
object
error
successful
boolean

Post /api/organizations/{organization_id}/invites/bulk/: bulk-create organization invites with customizable levels, sender details, and validation checks. supports email automation and private project access settings.

Action Parameters

created_at
stringRequired
emailing_attempt_made
booleanRequired
first_name
string
id
stringRequired
is_expired
booleanRequired
message
string
organization_id
stringRequired
private_project_access
send_email
booleanDefaults to True
target_email
stringRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

The “/api/projects/{project_id}/insights/cancel/” endpoint allows users to cancel insights for a project by providing a project id and insight details in json or csv, and confirms cancellation in the response.

Action Parameters

cache_target_age
stringRequired
columns
stringRequired
created_at
stringRequired
dashboard_tiles
arrayRequired
dashboards
array
deleted
boolean
derived_name
string
description
string
favorited
boolean
filters
format
string
hogql
stringRequired
id
integerRequired
is_cached
stringRequired
is_sample
booleanRequired
last_modified_at
stringRequired
last_refresh
stringRequired
name
string
next_allowed_client_refresh
stringRequired
order
integer
project_id
stringRequired
query
query_status
stringRequired
result
stringRequired
saved
boolean
short_id
stringRequired
tags
array
timezone
stringRequired
types
stringRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Get the newest updates and plugin info for a pipeline destination by organization and destination id via get request to /api/…/{id}/check for updates.

Action Parameters

id
integerRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve the latest update information for a specific pipeline import app by its id within an organization. this endpoint returns details such as plugin type, name, description, and version data. requires ‘id’ and ‘organization id’ as path parameters.

Action Parameters

id
integerRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Get update status for a specific pipeline transformation plugin by its unique id within an organization. this endpoint requires the ‘organization id’ and ‘plugin’ ids and returns details like plugin type, name, and update information.

Action Parameters

id
integerRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Projects for the current organization.

Action Parameters

id
integerRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

This endpoint duplicates a specified cohort as a static one within a project. path parameters include project id (string) and cohort id (integer). successful requests return cohort details.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

The api for interacting with notebooks. this feature is in early access and the api can have breaking changes without announcement.

Action Parameters

content
created_at
stringRequired
deleted
boolean
id
stringRequired
last_modified_at
stringRequired
project_id
stringRequired
short_id
stringRequired
text_content
string
title
string
version
integer

Action Response

data
object
error
successful
boolean

Create a new dashboard for a specified project from a template. accepts project id in the path and a json payload with various dashboard object parameters. returns a dashboard instance on success.

Action Parameters

created_at
stringRequired
delete_insights
boolean
deleted
boolean
description
string
filters
id
integerRequired
is_shared
booleanRequired
name
string
pinned
boolean
project_id
stringRequired
tags
array
tiles
arrayRequired
use_dashboard
integer
use_template
string

Action Response

data
object
error
successful
boolean

Create a domain for a specific organization by post to /api/organizations/{id}/domains with json/form data. requires domain, saml setup, and write permissions. returns new domain data with status 201.

Action Parameters

domain
stringRequired
has_saml
booleanRequired
id
stringRequired
is_verified
booleanRequired
jit_provisioning_enabled
boolean
organization_id
stringRequired
saml_acs_url
string
saml_entity_id
string
saml_x509_cert
string
sso_enforcement
string
verification_challenge
stringRequired
verified_at
stringRequired

Action Response

data
object
error
successful
boolean

Create a new exposure cohort for an experiment in a project by sending a post request with experiment details and feature flag data. requires experiment id and project id in the path.

Action Parameters

archived
boolean
created_at
stringRequired
description
string
end_date
string
exposure_cohort
integerRequired
feature_flag_key
stringRequired
filters
id
integerRequired
name
stringRequired
parameters
project_id
stringRequired
secondary_metrics
start_date
string
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Manage feature flags by creating, reading, updating, and deleting them using posthog’s javascript library or api endpoint. details in the provided documentation.

Action Parameters

active
boolean
analytics_dashboards
array
can_edit
booleanRequired
created_at
string
deleted
boolean
ensure_experience_continuity
boolean
experiment_set
arrayRequired
features
objectRequired
filters
object
has_enriched_analytics
boolean
id
integerRequired
is_simple_flag
booleanRequired
key
stringRequired
name
string
performed_rollback
boolean
project_id
stringRequired
rollback_conditions
rollout_percentage
integerRequired
surveys
objectRequired
tags
array
usage_dashboard
integerRequired

Action Response

data
object
error
successful
boolean

Manage feature flags by creating, reading, updating, and deleting them. utilize javascript library or endpoint for user-specific flag status. refer to documentation for details.

Action Parameters

active
boolean
analytics_dashboards
array
can_edit
booleanRequired
created_at
string
deleted
boolean
ensure_experience_continuity
boolean
experiment_set
arrayRequired
features
objectRequired
filters
object
has_enriched_analytics
boolean
id
integerRequired
is_simple_flag
booleanRequired
key
stringRequired
name
string
performed_rollback
boolean
project_id
stringRequired
rollback_conditions
rollout_percentage
integerRequired
surveys
objectRequired
tags
array
usage_dashboard
integerRequired

Action Response

data
object
error
successful
boolean

Create a config for pipeline frontend apps within a specified project. requires project id and payload with object properties such as plugin, enabled status, order, etc. returns newly created config details.

Action Parameters

config
stringRequired
created_at
stringRequired
deleted
boolean
delivery_rate_24h
stringRequired
description
string
enabled
boolean
error
stringRequired
filters
id
integerRequired
name
string
order
integerRequired
plugin
integerRequired
plugin_info
stringRequired
project_id
stringRequired
team_id
integerRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

This endpoint handles reading and deleting persons. for creation or updates, use the capture api, \$set or \$unset properties, or sdks.

Action Parameters

created_at
stringRequired
distinct_ids
arrayRequired
format
string
id
integerRequired
name
stringRequired
project_id
stringRequired
properties
uuid
stringRequired

Action Response

data
object
error
successful
boolean

Post /api/organizations/ - create a new organization with details like name, membership level, and features access. requires organization:write permission. returns organization info on success.

Action Parameters

available_product_features
arrayRequired
created_at
stringRequired
customer_id
stringRequired
enforce_2fa
boolean
id
stringRequired
is_member_join_email_enabled
boolean
member_count
stringRequired
metadata
stringRequired
name
stringRequired
slug
stringRequired
teams
arrayRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Create a new experiment in a specific project using json, form, or multipart data. requires project id and experiment details, secured with personalapikeyauth. generates a 201 response with experiment info.

Action Parameters

archived
boolean
created_at
stringRequired
description
string
end_date
string
exposure_cohort
integerRequired
feature_flag_key
stringRequired
filters
id
integerRequired
name
stringRequired
parameters
project_id
stringRequired
secondary_metrics
start_date
string
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Send invites with roles (member, admin, owner) via email to join an organization by id. use json, form data, or multipart with a personal api key for security. successful invites return a 201 status.

Action Parameters

created_at
stringRequired
emailing_attempt_made
booleanRequired
first_name
string
id
stringRequired
is_expired
booleanRequired
message
string
organization_id
stringRequired
private_project_access
send_email
booleanDefaults to True
target_email
stringRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Create a new role for the specified organization by supplying role details. requires organization id (uuid) and role data in json. returns the created role on success with a 201 status code. security: personalapikeyauth.

Action Parameters

associated_flags
stringRequired
created_at
stringRequired
id
stringRequired
members
stringRequired
name
stringRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Create a proxy record for an org by sending org id in url and json/form/multipart data with domain, target cname, and status. requires personalapikeyauth and org write access; returns record details.

Action Parameters

created_at
stringRequired
created_by
integerRequired
domain
stringRequired
id
stringRequired
message
stringRequired
organization_id
stringRequired
target_cname
stringRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

This endpoint is for reading and deleting persons. use the capture api, \$set/\$unset properties, or sdks to create or update them.

Action Parameters

created_at
stringRequired
distinct_ids
arrayRequired
format
string
id
integerRequired
name
stringRequired
project_id
stringRequired
properties
uuid
stringRequired

Action Response

data
object
error
successful
boolean

This api endpoint is for reading and deleting users. use the capture api, \$set/\$unset properties, or sdks for creating/updating users.

Action Parameters

created_at
stringRequired
distinct_ids
arrayRequired
format
string
id
integerRequired
name
stringRequired
project_id
stringRequired
properties
uuid
stringRequired

Action Response

data
object
error
successful
boolean

Create pipeline destination configurations for a specific project by submitting plugin and order details, among other configuration info, with required project id. authentication needed. responds with 201 on success.

Action Parameters

config
stringRequired
created_at
stringRequired
deleted
boolean
delivery_rate_24h
stringRequired
description
string
enabled
boolean
error
stringRequired
filters
id
integerRequired
name
string
order
integerRequired
plugin
integerRequired
plugin_info
stringRequired
project_id
stringRequired
team_id
integerRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Create a job for a pipeline destination config with a specific id within the specified project. requires project id & config id in the path, and a json payload with plugin and order info.

Action Parameters

config
stringRequired
created_at
stringRequired
deleted
boolean
delivery_rate_24h
stringRequired
description
string
enabled
boolean
error
stringRequired
filters
id
integerRequired
name
string
order
integerRequired
plugin
integerRequired
plugin_info
stringRequired
project_id
stringRequired
team_id
integerRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

A job imports app settings into a project pipeline using project id and plugin config id, accepting json/form/multipart, and specifies plugin details, enabling status, and order for pipeline import apps configs.

Action Parameters

config
stringRequired
created_at
stringRequired
deleted
boolean
delivery_rate_24h
stringRequired
description
string
enabled
boolean
error
stringRequired
filters
id
integerRequired
name
string
order
integerRequired
plugin
integerRequired
plugin_info
stringRequired
project_id
stringRequired
team_id
integerRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Create a job-related configuration for a specific plugin by providing plugin and project ids. accepts json, form data, and returns config details on success. use carefully; requires mandatory fields.

Action Parameters

config
stringRequired
created_at
stringRequired
deleted
boolean
delivery_rate_24h
stringRequired
description
string
enabled
boolean
error
stringRequired
filters
id
integerRequired
name
string
order
integerRequired
plugin
integerRequired
plugin_info
stringRequired
project_id
stringRequired
team_id
integerRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

This post endpoint creates actions for a project, accepts various data types, requires project id and action data, optionally outputs in csv/json, and needs personalapikeyauth, returning a 201 with action details.

Action Parameters

bytecode_error
stringRequired
created_at
stringRequired
deleted
boolean
description
string
format
string
id
integerRequired
is_action
booleanDefaults to True
is_calculating
booleanRequired
last_calculated_at
string
name
string
post_to_slack
boolean
project_id
stringRequired
slack_message_format
string
steps
array
tags
array
team_id
integerRequired

Action Response

data
object
error
successful
boolean

Create cohorts for a specified project by posting json-form data to “/api/projects/{project_id}/cohorts/”. provide project id in url and the necessary payload, adhering to json schema constraints. authentication required. returns 201 upon success.

Action Parameters

count
integerRequired
created_at
stringRequired
deleted
boolean
description
string
errors_calculating
integerRequired
experiment_set
arrayRequired
filters
groups
id
integerRequired
is_calculating
booleanRequired
is_static
boolean
last_calculation
stringRequired
name
string
project_id
stringRequired
query

Action Response

data
object
error
successful
boolean

The post endpoint creates a dashboard within a project using a project id, accepting details in json/form formats. it uses ‘personalapikeyauth’ for security and returns http 201 with dashboard details on success.

Action Parameters

created_at
stringRequired
delete_insights
boolean
deleted
boolean
description
string
filters
id
integerRequired
is_shared
booleanRequired
name
string
pinned
boolean
project_id
stringRequired
tags
array
tiles
arrayRequired
use_dashboard
integer
use_template
string

Action Response

data
object
error
successful
boolean

The post endpoint enables creating insights for projects using a project id and supports json/csv. it offers detailed parameters for customizing insights and returns structured data with personalapikeyauth for security.

Action Parameters

cache_target_age
stringRequired
columns
stringRequired
created_at
stringRequired
dashboard_tiles
arrayRequired
dashboards
array
deleted
boolean
derived_name
string
description
string
favorited
boolean
filters
format
string
hogql
stringRequired
id
integerRequired
is_cached
stringRequired
is_sample
booleanRequired
last_modified_at
stringRequired
last_refresh
stringRequired
name
string
next_allowed_client_refresh
stringRequired
order
integer
project_id
stringRequired
query
query_status
stringRequired
result
stringRequired
saved
boolean
short_id
stringRequired
tags
array
timezone
stringRequired
types
stringRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Create project insights with optional csv/json format parameter. requires project id in the path and a json body with project insight details. supports personal api key authentication. successful requests return a 201 status code with insight data.

Action Parameters

cache_target_age
stringRequired
columns
stringRequired
created_at
stringRequired
dashboard_tiles
arrayRequired
dashboards
array
deleted
boolean
derived_name
string
description
string
favorited
boolean
filters
format
string
hogql
stringRequired
id
integerRequired
is_cached
stringRequired
is_sample
booleanRequired
last_modified_at
stringRequired
last_refresh
stringRequired
name
string
next_allowed_client_refresh
stringRequired
order
integer
project_id
stringRequired
query
query_status
stringRequired
result
stringRequired
saved
boolean
short_id
stringRequired
tags
array
timezone
stringRequired
types
stringRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Create pipeline app configurations for a specified project via post, requiring a project id and json, form, or multipart payload. supports configs, plugins, and app details. returns 201 on success. auth required.

Action Parameters

config
stringRequired
created_at
stringRequired
deleted
boolean
delivery_rate_24h
stringRequired
description
string
enabled
boolean
error
stringRequired
filters
id
integerRequired
name
string
order
integerRequired
plugin
integerRequired
plugin_info
stringRequired
project_id
stringRequired
team_id
integerRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Create a job for a pipeline frontend app config in a project. requires project id and config id, accepting json/form-data. returns the created job’s details.

Action Parameters

config
stringRequired
created_at
stringRequired
deleted
boolean
delivery_rate_24h
stringRequired
description
string
enabled
boolean
error
stringRequired
filters
id
integerRequired
name
string
order
integerRequired
plugin
integerRequired
plugin_info
stringRequired
project_id
stringRequired
team_id
integerRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Create a pipeline transformation config within a specific project by posting json, form, or multipart data. include plugin id, order, and enabled status. ensure project id is in the path. authentication required.

Action Parameters

config
stringRequired
created_at
stringRequired
deleted
boolean
delivery_rate_24h
stringRequired
description
string
enabled
boolean
error
stringRequired
filters
id
integerRequired
name
string
order
integerRequired
plugin
integerRequired
plugin_info
stringRequired
project_id
stringRequired
team_id
integerRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Create a new plugin configuration for a specified project by post to /api/projects/{project_id}/plugin configs/. requires project id and json payload with plugin details; must authenticate with personalapikeyauth.

Action Parameters

config
stringRequired
created_at
stringRequired
deleted
boolean
delivery_rate_24h
stringRequired
description
string
enabled
boolean
error
stringRequired
filters
id
integerRequired
name
string
order
integerRequired
plugin
integerRequired
plugin_info
stringRequired
project_id
stringRequired
team_id
integerRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Create a subscription for a given project by providing required details such as delivery method, frequency, and starting date. requires a project id and supports various content types. returns the newly created subscription. security: personalapikeyauth.

Action Parameters

bysetpos
integer
byweekday
array
count
integer
created_at
stringRequired
dashboard
integer
deleted
boolean
frequency
stringRequired
id
integerRequired
insight
integer
interval
integer
invite_message
string
next_delivery_date
stringRequired
project_id
stringRequired
start_date
stringRequired
summary
stringRequired
target_type
stringRequired
target_value
stringRequired
title
string
until_date
string

Action Response

data
object
error
successful
boolean

Create surveys in a project by providing a project id and details like type, questions, and targets in json, form-data, or urlencoded format. use personalapikeyauth for security. get a survey object on success.

Action Parameters

appearance
archived
boolean
conditions
created_at
stringRequired
current_iteration
integer
current_iteration_start_date
string
description
string
end_date
string
id
stringRequired
iteration_count
integer
iteration_frequency_days
integer
iteration_start_dates
array
linked_flag_id
integer
name
stringRequired
project_id
stringRequired
questions
remove_targeting_flag
boolean
responses_limit
integer
start_date
string
targeting_flag_filters
targeting_flag_id
integer
type
stringRequired

Action Response

data
object
error
successful
boolean

Create timing insights for a project by post to /api/projects/{project_id}/insights/timing, supporting csv or json. it returns a 200 status with content in the chosen format.

Action Parameters

cache_target_age
stringRequired
columns
stringRequired
created_at
stringRequired
dashboard_tiles
arrayRequired
dashboards
array
deleted
boolean
derived_name
string
description
string
favorited
boolean
filters
format
string
hogql
stringRequired
id
integerRequired
is_cached
stringRequired
is_sample
booleanRequired
last_modified_at
stringRequired
last_refresh
stringRequired
name
string
next_allowed_client_refresh
stringRequired
order
integer
project_id
stringRequired
query
query_status
stringRequired
result
stringRequired
saved
boolean
short_id
stringRequired
tags
array
timezone
stringRequired
types
stringRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

The /api/projects/{project_id}/query/ post endpoint allows users to submit queries for a specific project by providing the project id in the url and the query details in json or form data. authentication is required and it returns query results.

Action Parameters

async
boolean
client_query_id
string
project_id
stringRequired
query
objectRequired
refresh
boolean

Action Response

data
object
error
successful
boolean

Create and retrieve retention insights for a project using its id, allowing csv/json outputs. requires an api key with insight:read permissions and supports query node json strings and old dashboard ids.

Action Parameters

cache_target_age
stringRequired
columns
stringRequired
created_at
stringRequired
dashboard_tiles
arrayRequired
dashboards
array
deleted
boolean
derived_name
string
description
string
favorited
boolean
filters
format
string
hogql
stringRequired
id
integerRequired
is_cached
stringRequired
is_sample
booleanRequired
last_modified_at
stringRequired
last_refresh
stringRequired
name
string
next_allowed_client_refresh
stringRequired
order
integer
project_id
stringRequired
query
query_status
stringRequired
result
stringRequired
saved
boolean
short_id
stringRequired
tags
array
timezone
stringRequired
types
stringRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

The post endpoint generates a project’s session recording, needing ‘project id’, ‘short id’, and ‘session recording id’ in the url, and accepts various content formats for recording details.

Action Parameters

created_at
stringRequired
deleted
boolean
derived_name
string
description
string
filters
id
integerRequired
last_modified_at
stringRequired
name
string
pinned
boolean
project_id
stringRequired
session_recording_id
stringRequired
short_id
stringRequired

Action Response

data
object
error
successful
boolean

Create playlists of session recordings for a specified project. requires ‘project id’ path parameter and personal api key with write access. supports json, form-encoded, or multipart data. returns 201 on success with playlist details.

Action Parameters

created_at
stringRequired
deleted
boolean
derived_name
string
description
string
filters
id
integerRequired
last_modified_at
stringRequired
name
string
pinned
boolean
project_id
stringRequired
short_id
stringRequired

Action Response

data
object
error
successful
boolean

Summarize a session recording by providing the project id and the recording’s uuid. get details like duration, activities, and user info.

Action Parameters

active_seconds
integerRequired
click_count
integerRequired
console_error_count
integerRequired
console_log_count
integerRequired
console_warn_count
integerRequired
distinct_id
stringRequired
end_time
stringRequired
id
stringRequired
inactive_seconds
integerRequired
keypress_count
integerRequired
mouse_activity_count
integerRequired
person__created__at
string
person__distinct__ids
string
person__id
integer
person__name
string
person__properties
person__uuid
string
project_id
stringRequired
recording_duration
integerRequired
snapshot_source
stringRequired
start_time
stringRequired
start_url
stringRequired
storage
stringRequired
viewed
stringRequired

Action Response

data
object
error
successful
boolean

Manage feature flags for apps with create, read, update, and delete operations using posthog’s javascript library or dedicated endpoint. more info in the docs.

Action Parameters

active
boolean
analytics_dashboards
array
can_edit
booleanRequired
created_at
string
deleted
boolean
ensure_experience_continuity
boolean
experiment_set
arrayRequired
features
objectRequired
filters
object
has_enriched_analytics
boolean
id
integerRequired
is_simple_flag
booleanRequired
key
stringRequired
name
string
performed_rollback
boolean
project_id
stringRequired
rollback_conditions
rollout_percentage
integerRequired
surveys
objectRequired
tags
array
usage_dashboard
integerRequired

Action Response

data
object
error
successful
boolean

Create, read, update and delete annotations. see docs for more information on annotations.

Action Parameters

content
string
created_at
stringRequired
creation_type
string
dashboard_id
integerRequired
dashboard_item
integer
dashboard_name
stringRequired
date_marker
string
deleted
boolean
id
integerRequired
insight_derived_name
stringRequired
insight_name
stringRequired
insight_short_id
stringRequired
project_id
stringRequired
scope
string
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

The /api/projects/{project_id}/insights/funnel/ endpoint generates customizable funnel insights for a project in either csv or json, offering filtering, exclusion, and ordering features with cachable results. specify output with the format query.

Action Parameters

actions
array
aggregation_group_type_index
integer
breakdown
string
breakdown_limit
integerDefaults to 10
date_from
stringDefaults to -7d
date_to
stringDefaults to -7d
events
array
exclusions
array
filter_test_accounts
boolean
format
string
funnel_window_days
integerDefaults to 14
funnel_window_interval
integerDefaults to 14
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Delete an organization by its uuid. requires a ‘personalapikeyauth’ with ‘organization:write’ permission. on success, returns a 204 status code with no response body.

Action Parameters

id
stringRequired

Action Response

data
object
error
successful
boolean

Projects for the current organization.

Action Parameters

id
integerRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

This endpoint is used to read and delete user data. use the capture api, \$set/\$unset commands, or sdks for creating/updating persons.

Action Parameters

delete_events
boolean
format
string
id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Delete a session recording by providing the session’s uuid and the associated project id. requires session recording:write permission. returns no content on successful deletion.

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Delete a survey by providing its uuid and the associated project id. requires ‘survey:write’ permission. returns no content with a 204 status on success.

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Enables a new early access feature for a project using project id, payload with details, and personalapikeyauth. returns a 201 status on success.

Action Parameters

created_at
stringRequired
description
string
documentation_url
string
feature_flag_id
integer
id
stringRequired
name
stringRequired
project_id
stringRequired
stage
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve logs for a specific batch export within a project by its uuid. endpoint requires project id and export id (uuid). supports json responses detailing export properties, run statuses, and error info.

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve pipeline transformation export unsubscribe configurations for a specified organization by its uuid. returns details including id, plugin type, and configuration schema in json format.

Action Parameters

organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve activity details for a specific pipeline frontend app config by id within a project. requires both project id and config id in the path. returns json with app config details like plugin info, enablement, order, and error status.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve organization details by uuid. endpoint requires ‘organization:read’ access. response includes name, slug, timestamps, membership, plugins access level, and team structure.

Action Parameters

id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve details of pipeline import app repositories for a specific organization by its uuid. returns json with properties like plugin type, name, and url. supports ‘local’, ‘custom’, ‘repository’, ‘source’, ‘inline’ types.

Action Parameters

organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Use a get request to ‘/api/projects/{project_id}/pipeline destination configs/{id}/activity/’ to get details, status, config, and metrics for a pipeline destination by id, returning json.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve details of pipeline transformations from a specified organization’s repository. requires organization id (uuid). returns json with properties like id, plugin type, and name. supports filtering by types like local, custom, repository, etc.

Action Parameters

organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Fetch secondary experiment data in a project by its unique id, using project and experiment ids as path parameters. authenticated by personalapikeyauth, it returns a json with experiment info, features, and metrics.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve the activity log of surveys within a specific project by using the project id. this endpoint requires a personalapikeyauth with ‘activity log:read’ permission and returns survey details including types, flags, questions, and metadata.

Action Parameters

project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve session recording playlist details for a specific project by project id and playlist short id. requires personalapikeyauth with read access. returns playlist metadata including creation and modification info.

Action Parameters

project_id
stringRequired
short_id
stringRequired

Action Response

data
object
error
successful
boolean

Hard delete of this model is not allowed. use a patch api call to set “deleted” to true

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

The /api/projects/{project_id}/insights/funnel/correlation endpoint generates a correlation insight for funnel analysis in a project, accepting json/csv and needing ‘project id’ and insight details.

Action Parameters

cache_target_age
stringRequired
columns
stringRequired
created_at
stringRequired
dashboard_tiles
arrayRequired
dashboards
array
deleted
boolean
derived_name
string
description
string
favorited
boolean
filters
format
string
hogql
stringRequired
id
integerRequired
is_cached
stringRequired
is_sample
booleanRequired
last_modified_at
stringRequired
last_refresh
stringRequired
name
string
next_allowed_client_refresh
stringRequired
order
integer
project_id
stringRequired
query
query_status
stringRequired
result
stringRequired
saved
boolean
short_id
stringRequired
tags
array
timezone
stringRequired
types
stringRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Post /api/organizations/{organization_id}/domains/{id}/verify/: initiates verification for a domain within an organization using its uuid, updating its verification status and related saml configuration attributes. supports json and form data formats.

Action Parameters

domain
stringRequired
has_saml
booleanRequired
id
stringRequired
is_verified
booleanRequired
jit_provisioning_enabled
boolean
organization_id
stringRequired
saml_acs_url
string
saml_entity_id
string
saml_x509_cert
string
sso_enforcement
string
verification_challenge
stringRequired
verified_at
stringRequired

Action Response

data
object
error
successful
boolean

Create a pipeline transformation job for a specified plugin config in a project by posting to /api/projects/{project_id}/pipeline transformation configs/{id}/job/. requires project id and plugin config id.

Action Parameters

config
stringRequired
created_at
stringRequired
deleted
boolean
delivery_rate_24h
stringRequired
description
string
enabled
boolean
error
stringRequired
filters
id
integerRequired
name
string
order
integerRequired
plugin
integerRequired
plugin_info
stringRequired
project_id
stringRequired
team_id
integerRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

This endpoint for listing/filtering events is deprecated and maintained only for compatibility. users are discouraged from using it and should use the query endpoint for ad-hoc lists/aggregations or cdp/batch exports for bulk exports.

Action Parameters

after
string
before
string
distinct_id
integer
event
string
format
string
limit
integer
offset
integer
person_id
integer
project_id
stringRequired
properties
array
select
array
where
array

Action Response

data
object
error
successful
boolean

Create, read, update and delete annotations. see docs for more information on annotations.

Action Parameters

limit
integer
offset
integer
project_id
stringRequired
search
string

Action Response

data
object
error
successful
boolean

Manage feature flags with creation, reading, updating, and deletion capabilities. utilize javascript library or an endpoint for application integration. more details in the docs.

Action Parameters

limit
integer
offset
integer
project_id
stringRequired

Action Response

data
object
error
successful
boolean

List runs for a batch export by batch export id within a project. supports pagination & ordering of the results. requires batch export:read permission. returns status, errors, counts, and timestamps for each run.

Action Parameters

batch_export_id
stringRequired
cursor
string
ordering
string
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve a list of dashboard sharing configurations for a specified project and dashboard. requires dashboard id, project id, and sharing read permission via personalapikeyauth. returns json array of sharing settings.

Action Parameters

dashboard_id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

This get endpoint returns role access details for a feature flag in a project, needs ‘project id’ & ‘feature flag id’, and offers optional ‘limit’ & ‘offset’ for pagination.

Action Parameters

feature_flag_id
integerRequired
limit
integer
offset
integer
project_id
stringRequired

Action Response

data
object
error
successful
boolean

The api for interacting with notebooks. this feature is in early access and the api can have breaking changes without announcement.

Action Parameters

contains
string
created_by
integer
date_from
string
date_to
string
limit
integer
offset
integer
project_id
stringRequired
user
string

Action Response

data
object
error
successful
boolean

Retrieve a list of session recording playlists for a specific project. filter by creator, paginate with limit and offset, and identify playlists with project id and optional short id. requires ‘session recording playlist:read’ permission.

Action Parameters

created_by
integer
limit
integer
offset
integer
project_id
stringRequired
short_id
string

Action Response

data
object
error
successful
boolean

Fetch a list of an organization’s domains with pagination using limit and offset. access requires organization id and a personalapikeyauth. optional parameters available. provides domain info, verification, and saml setup.

Action Parameters

limit
integer
offset
integer
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve a paginated list of invites for a specific organization, identified by organization id, with optional limit and offset query params for result customization. requires organization member:read permission.

Action Parameters

limit
integer
offset
integer
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve members list from an organization with ‘limit’ and ‘offset’ options using personalapikeyauth and organization id. access requires organization member:read permission. returns members’ details and statuses.

Action Parameters

limit
integer
offset
integer
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve the list of plugins for a specified organization. supports pagination through ‘limit’ and ‘offset’ query parameters. requires a valid organization uuid and personalapikeyauth for access. returns plugin details including types and status.

Action Parameters

limit
integer
offset
integer
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Fetch a paginated list of roles in an organization using its uuid. supports query parameters for limits and offsets. access needs personalapikeyauth. returns details like id, name, and creator info.

Action Parameters

limit
integer
offset
integer
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve paginated batch exports for an organization, with filters and optional limits. includes team, interval, and status details. access requires personalapikeyauth with batch export:read rights.

Action Parameters

limit
integer
offset
integer
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve a paginated list of an organization’s proxy records by id, with ‘limit’ and ‘offset’ options. ‘organization id’ and ‘personalapikeyauth’ are necessary. includes status, domain, and counts.

Action Parameters

limit
integer
offset
integer
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve a paginated list of an organization’s pipeline destinations by id, with optional count and offset parameters. requires personalapikeyauth (plugin:read). returns details like id, type, and organization info.

Action Parameters

limit
integer
offset
integer
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve a paginated list of pipeline apps for an organization using ‘plugin:read’ personalapikeyauth. requires organization id (uuid) and supports limit and offset parameters. includes app types and statuses.

Action Parameters

limit
integer
offset
integer
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve a paginated list of pipeline import applications for a specified organization by id. supports optional ‘limit’ and ‘offset’ query parameters for result pagination. requires an organization uuid and a personal api key for authentication.

Action Parameters

limit
integer
offset
integer
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve paginated pipeline transformation lists for an organization using limit and offset, requiring a uuid and personalapikeyauth. supports filtering and detailed views.

Action Parameters

limit
integer
offset
integer
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

This endpoint is for reading/deleting persons. for creating/updating, use the capture api, set/unset properties, or sdks.

Action Parameters

distinct_id
string
email
string
format
string
limit
integer
offset
integer
project_id
stringRequired
properties
array
search
string

Action Response

data
object
error
successful
boolean

Get paginated surveys for a project with its id, using ‘limit’ and ‘offset’. needs personalapikeyauth (‘survey:read’). json output includes survey info, links, and metadata.

Action Parameters

limit
integer
offset
integer
project_id
stringRequired

Action Response

data
object
error
successful
boolean

List pipeline destination configurations for a given project by id, with optional pagination through ‘limit’ and ‘offset’ query parameters. returns details such as plugin info and delivery rates. authentication required.

Action Parameters

limit
integer
offset
integer
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve paginated configurations for pipeline frontend apps associated with a specified project. query parameters ‘limit’ and ‘offset’ control pagination. requires a project id and personalapikeyauth for access. supports json responses.

Action Parameters

limit
integer
offset
integer
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Projects for the current organization.

Action Parameters

limit
integer
offset
integer
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Get paginated project actions with filters by format. query params: limit, offset. needs personalapikeyauth for read. includes id, name, description, metadata.

Action Parameters

format
string
limit
integer
offset
integer
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve an indexed list of batch exports for a specified project with optional pagination. view export details, statuses, and pagination links. requires project id and supports personalapikeyauth.

Action Parameters

limit
integer
offset
integer
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve logs for a specific plugin configuration within a project. supports pagination with limit and offset query parameters. requires project and plugin configuration ids. auth: personalapikeyauth with plugin:read scope.

Action Parameters

limit
integer
offset
integer
plugin_config_id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Get paginated dashboards for a project by id, using ‘limit’ and ‘offset’. must authenticate with personalapikeyauth. includes count, pagination, and dashboard details.

Action Parameters

limit
integer
offset
integer
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Get dashboard collaborators list in a project using project string id and dashboard integer id. requires personalapikeyauth and dashboard:read permission. returns details like access level and timestamps.

Action Parameters

dashboard_id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

“retrieve a paginated list of dashboard templates for a specified project. use ‘limit’ and ‘offset’ query parameters to control result pagination. requires project’s id in the path and supports personalapikeyauth for security.”

Action Parameters

limit
integer
offset
integer
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve a paginated list of a project’s early access features by id with ‘limit’ and ‘offset’ parameters. an api key is needed. includes feature info like creation date, stage, and documentation link.

Action Parameters

limit
integer
offset
integer
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Get a paginated list of experiments within a project using ‘limit’ and ‘offset’ parameters. need a valid project id and ‘experiment:read’ permission. returns details like features and metrics.

Action Parameters

limit
integer
offset
integer
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve a paginated list of export items for a specific project by id with optional ‘limit’ and ‘offset’ query parameters. requires personalapikeyauth for export:read permission. supports multiple export formats.

Action Parameters

limit
integer
offset
integer
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve a list of group types within a specific project by providing the project id. this endpoint requires authentication with a personalapikey and grants read access to group data.

Action Parameters

project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve a list of project membership details for a specified project by id. members and their roles, such as member or admin, are included along with their join and update timestamps.

Action Parameters

project_id
stringRequired

Action Response

data
object
error
successful
boolean

Fetch paginated pipeline configuration list for a project by its id, utilizing optional limit and offset. endpoint returns json data.

Action Parameters

limit
integer
offset
integer
project_id
stringRequired

Action Response

data
object
error
successful
boolean

List pipeline import app configurations for a specified project, with pagination options ‘limit’ and ‘offset’. requires a project id and supports personalapikeyauth for security. responds with json objects including configuration details.

Action Parameters

limit
integer
offset
integer
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve a paginated list of plugin configurations for a specific project by project id. supports optional ‘limit’ & ‘offset’ query params for result batching. requires ‘personalapikeyauth’ for ‘plugin:read’ access.

Action Parameters

limit
integer
offset
integer
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve a paginated list of session recordings for a specific project, including viewing times and user interactions. specify project id, and use optional limit and offset query parameters to control result set size and starting point.

Action Parameters

limit
integer
offset
integer
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve a paginated list of subscriptions for a given project by its id. optional query params include ‘limit’ for results per page and ‘offset’ for results starting index. authentication is required. returns subscription details and navigation links.

Action Parameters

limit
integer
offset
integer
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve a paginated list of role memberships for a specific role within an organization, including membership details. optional query parameters ‘limit’ and ‘offset’ control pagination; ‘organization id’ and ‘role id’ are path parameters.

Action Parameters

limit
integer
offset
integer
organization_id
stringRequired
role_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve a list of sharing configurations for a specific session recording in a project, including creation timestamps and access tokens. requires project and recording ids.

Action Parameters

project_id
stringRequired
recording_id
stringRequired

Action Response

data
object
error
successful
boolean

List all groups of a specific group type. you must pass ?group type index= in the url. to get a list of valid group types, call /api/:project id/groups types/

Action Parameters

cursor
string
group_type_index
integerRequired
project_id
stringRequired
search
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve a list of unused pipeline transformations for a specified organization, identified by uuid. includes details like name, plugin type, and configuration. supports json response format.

Action Parameters

organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Api endpoint fetches a user list with staff filter, pagination (limit, offset), and requires a personal api key. data includes uuids, emails, and organizational details.

Action Parameters

is_staff
boolean
limit
integer
offset
integer

Action Response

data
object
error
successful
boolean

Learn to manage feature flags (creation, access, modification, removal) using posthog’s docs, with options to use a javascript library or a dedicated endpoint for user-specific flag status.

Action Parameters

active
boolean
analytics_dashboards
array
can_edit
booleanRequired
created_at
string
deleted
boolean
ensure_experience_continuity
boolean
experiment_set
arrayRequired
features
objectRequired
filters
object
has_enriched_analytics
boolean
id
integerRequired
is_simple_flag
booleanRequired
key
stringRequired
name
string
performed_rollback
boolean
project_id
stringRequired
rollback_conditions
rollout_percentage
integerRequired
surveys
objectRequired
tags
array
usage_dashboard
integerRequired

Action Response

data
object
error
successful
boolean

Learn to manage feature flags: create, read, update, delete, and check their status using the javascript library or an endpoint. consult the linked docs for details.

Action Parameters

project_id
stringRequired

Action Response

data
object
error
successful
boolean

Utilize feature flags to manage application features with creation, reading, updating, and deletion. consult posthog’s docs or use their js library or endpoint for user-specific flag checks.

Action Parameters

project_id
stringRequired

Action Response

data
object
error
successful
boolean

Manage feature flags in your app with create, read, update, and delete options. use posthog’s javascript library or endpoint to verify user access. see documentation for details.

Action Parameters

active
boolean
analytics_dashboards
array
can_edit
booleanRequired
created_at
string
deleted
boolean
ensure_experience_continuity
boolean
experiment_set
arrayRequired
features
objectRequired
filters
object
has_enriched_analytics
boolean
id
integerRequired
is_simple_flag
booleanRequired
key
stringRequired
name
string
performed_rollback
boolean
project_id
stringRequired
rollback_conditions
rollout_percentage
integerRequired
surveys
objectRequired
tags
array
usage_dashboard
integerRequired

Action Response

data
object
error
successful
boolean

Hard delete of this model is not allowed. use a patch api call to set “deleted” to true

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

The post endpoint marks an insight as viewed for a specified project, requires project id and id, supports csv or json formats, and returns fast-loading serialized data.

Action Parameters

cache_target_age
stringRequired
columns
stringRequired
created_at
stringRequired
dashboard_tiles
arrayRequired
dashboards
array
deleted
boolean
derived_name
string
description
string
favorited
boolean
filters
format
string
hogql
stringRequired
id
integerRequired
is_cached
stringRequired
is_sample
booleanRequired
last_modified_at
stringRequired
last_refresh
stringRequired
name
string
next_allowed_client_refresh
stringRequired
order
integer
project_id
stringRequired
query
query_status
stringRequired
result
stringRequired
saved
boolean
short_id
stringRequired
tags
array
timezone
stringRequired
types
stringRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Hard delete of this model is not allowed. use a patch api call to set “deleted” to true

Action Parameters

format
string
id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Hard delete of this model is not allowed. use a patch api call to set “deleted” to true

Action Parameters

project_id
stringRequired
short_id
stringRequired

Action Response

data
object
error
successful
boolean

Hard delete of this model is not allowed. use a patch api call to set “deleted” to true

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Put /api/organizations/{id}/: update organization details by providing a uuid as ‘id’. supports json, form-urlencoded, multipart/form-data. requires ‘organization:write’ permission. returns updated organization data.

Action Parameters

available_product_features
arrayRequired
created_at
stringRequired
customer_id
stringRequired
enforce_2fa
boolean
id
stringRequired
is_member_join_email_enabled
boolean
member_count
stringRequired
metadata
stringRequired
name
stringRequired
slug
stringRequired
teams
arrayRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Endpoint to move a tile within a dashboard by id. requires project id, accepts json/form-data (e.g., name, pinned), and returns updated dashboard info.

Action Parameters

created_at
string
delete_insights
boolean
deleted
boolean
description
string
filters
id
integerRequired
is_shared
boolean
name
string
pinned
boolean
project_id
stringRequired
tags
array
tiles
array
use_dashboard
integer
use_template
string

Action Response

data
object
error
successful
boolean

Update plugin configuration partially for a specified project using patch on ‘/api/projects/{project_id}/plugin configs/{id}’. requires plugin write authority. accepts json, form data, and multipart. returns updated plugin config details.

Action Parameters

config
string
created_at
string
deleted
boolean
delivery_rate_24h
string
description
string
enabled
boolean
error
string
filters
id
integerRequired
name
string
order
integer
plugin
integer
plugin_info
string
project_id
stringRequired
team_id
integer
updated_at
string

Action Response

data
object
error
successful
boolean

Patch /api/projects/{project_id}/property definitions/{id}/: partially update a specific property definition by uuid in a project. requires property definition:write auth. no response body.

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Endpoint enables partial updates to an experiment in a project using patch, needing project id, experiment id, and various payload types. returns updated details. authentication is mandatory.

Action Parameters

archived
boolean
created_at
string
description
string
end_date
string
exposure_cohort
integer
feature_flag_key
string
filters
id
integerRequired
name
string
parameters
project_id
stringRequired
secondary_metrics
start_date
string
updated_at
string

Action Response

data
object
error
successful
boolean

Patch method to partially update config of a pipeline frontend app for a project by id. requires write permission on plugin. accepts json, form-data; returns updated config details.

Action Parameters

config
string
created_at
string
deleted
boolean
delivery_rate_24h
string
description
string
enabled
boolean
error
string
filters
id
integerRequired
name
string
order
integer
plugin
integer
plugin_info
string
project_id
stringRequired
team_id
integer
updated_at
string

Action Response

data
object
error
successful
boolean

The patch endpoint supports partial insight updates in a project, allows format specification (csv/json), and requires personalapikeyauth and insight:write scope for access.

Action Parameters

cache_target_age
string
columns
string
created_at
string
dashboard_tiles
array
dashboards
array
deleted
boolean
derived_name
string
description
string
favorited
boolean
filters
format
string
hogql
string
id
integerRequired
is_cached
string
is_sample
boolean
last_modified_at
string
last_refresh
string
name
string
next_allowed_client_refresh
string
order
integer
project_id
stringRequired
query
query_status
string
result
string
saved
boolean
short_id
string
tags
array
timezone
string
types
string
updated_at
string

Action Response

data
object
error
successful
boolean

Endpoint patch /api/projects/{project_id}/dashboards/{id}: allows partial update of a project’s dashboard with specified id. accepts json, form data, and provides a detailed response schema based on user license. requires dashboard write access.

Action Parameters

created_at
string
delete_insights
boolean
deleted
boolean
description
string
filters
id
integerRequired
is_shared
boolean
name
string
pinned
boolean
project_id
stringRequired
tags
array
tiles
array
use_dashboard
integer
use_template
string

Action Response

data
object
error
successful
boolean

Learn to manage feature flags (create, read, update, delete) using posthog’s docs, with options for javascript library use or dedicated endpoints for user flag status.

Action Parameters

active
boolean
analytics_dashboards
array
can_edit
boolean
created_at
string
deleted
boolean
ensure_experience_continuity
boolean
experiment_set
array
features
object
filters
object
has_enriched_analytics
boolean
id
integerRequired
is_simple_flag
boolean
key
string
name
string
performed_rollback
boolean
project_id
stringRequired
rollback_conditions
rollout_percentage
integer
surveys
object
tags
array
usage_dashboard
integer

Action Response

data
object
error
successful
boolean

The api for interacting with notebooks. this feature is in early access and the api can have breaking changes without announcement.

Action Parameters

content
created_at
string
deleted
boolean
id
string
last_modified_at
string
project_id
stringRequired
short_id
stringRequired
text_content
string
title
string
version
integer

Action Response

data
object
error
successful
boolean

Create, read, update and delete annotations. see docs for more information on annotations.

Action Parameters

content
string
created_at
string
creation_type
string
dashboard_id
integer
dashboard_item
integer
dashboard_name
string
date_marker
string
deleted
boolean
id
integerRequired
insight_derived_name
string
insight_name
string
insight_short_id
string
project_id
stringRequired
scope
string
updated_at
string

Action Response

data
object
error
successful
boolean

Post /api/projects/{project_id}/session recordings/{id}/persist: endpoint for persisting session recording data identified by uuid. requires project id and accepts json containing various read-only session metrics. responds with session data.

Action Parameters

active_seconds
integerRequired
click_count
integerRequired
console_error_count
integerRequired
console_log_count
integerRequired
console_warn_count
integerRequired
distinct_id
stringRequired
end_time
stringRequired
id
stringRequired
inactive_seconds
integerRequired
keypress_count
integerRequired
mouse_activity_count
integerRequired
person__created__at
string
person__distinct__ids
string
person__id
integer
person__name
string
person__properties
person__uuid
string
project_id
stringRequired
recording_duration
integerRequired
snapshot_source
stringRequired
start_time
stringRequired
start_url
stringRequired
storage
stringRequired
viewed
stringRequired

Action Response

data
object
error
successful
boolean

This endpoint allows reading and deleting individuals. for creation or updates, use the capture api, \$set/\$unset properties, or sdks.

Action Parameters

created_at
string
distinct_ids
array
format
string
id
integerRequired
name
string
project_id
stringRequired
properties
uuid
string

Action Response

data
object
error
successful
boolean

This endpoint is for reading and deleting user data. use the capture api, \$set/\$unset, or sdks for creating/updating users.

Action Parameters

created_at
stringRequired
distinct_ids
arrayRequired
format
string
id
integerRequired
name
stringRequired
project_id
stringRequired
properties
unset
stringRequired
uuid
stringRequired

Action Response

data
object
error
successful
boolean

The /api/projects/{project_id}/insights/trend/ endpoint provides project trends in csv/json, requires project id and optional parameters, and needs ‘personalapikeyauth’. it outputs event data and cache status.

Action Parameters

actions
array
breakdown
string
compare
boolean
compare_to
string
date_from
stringDefaults to -7d
date_to
stringDefaults to -7d
events
array
filter_test_accounts
boolean
format
string
formula
string
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Hard delete of this model is not allowed. use a patch api call to set “deleted” to true

Action Parameters

project_id
stringRequired
short_id
stringRequired

Action Response

data
object
error
successful
boolean

Patch /api/projects/{project_id}/pipeline frontend apps configs/rearrange/: rearrange the config of frontend apps in a project’s pipeline. requires project id in the path and a json object in the request body. responds with updated config details.

Action Parameters

config
string
created_at
string
deleted
boolean
delivery_rate_24h
string
description
string
enabled
boolean
error
string
filters
id
integer
name
string
order
integer
plugin
integer
plugin_info
string
project_id
stringRequired
team_id
integer
updated_at
string

Action Response

data
object
error
successful
boolean

Endpoint /api/projects/{project_id}/pipeline transformation configs/rearrange/ allows for partial updates to the arrangement of pipeline configurations for a given project. accepts patch requests with necessary parameters and the project id in the path.

Action Parameters

config
string
created_at
string
deleted
boolean
delivery_rate_24h
string
description
string
enabled
boolean
error
string
filters
id
integer
name
string
order
integer
plugin
integer
plugin_info
string
project_id
stringRequired
team_id
integer
updated_at
string

Action Response

data
object
error
successful
boolean

Rearrange app import settings in a project using patch /api/projects/{project_id}/… by updating plug-in order and status. requires project id and a json with configurations.

Action Parameters

config
string
created_at
string
deleted
boolean
delivery_rate_24h
string
description
string
enabled
boolean
error
string
filters
id
integer
name
string
order
integer
plugin
integer
plugin_info
string
project_id
stringRequired
team_id
integer
updated_at
string

Action Response

data
object
error
successful
boolean

“patch /api/projects/{project_id}/pipeline destination configs/rearrange/”: adjust order and settings of pipeline destinations for a project by project id. requires json body with plugin, enabled state, etc. returns updated configuration.

Action Parameters

config
string
created_at
string
deleted
boolean
delivery_rate_24h
string
description
string
enabled
boolean
error
string
filters
id
integer
name
string
order
integer
plugin
integer
plugin_info
string
project_id
stringRequired
team_id
integer
updated_at
string

Action Response

data
object
error
successful
boolean

Patch endpoint to reconfigure the order of plugins within a project by project id. supports json, form, and multipart bodies to update plugin order and status.

Action Parameters

config
string
created_at
string
deleted
boolean
delivery_rate_24h
string
description
string
enabled
boolean
error
string
filters
id
integer
name
string
order
integer
plugin
integer
plugin_info
string
project_id
stringRequired
team_id
integer
updated_at
string

Action Response

data
object
error
successful
boolean

Delete a specific domain by its uuid within an organization, given valid organization and domain ids. requires ‘organization:write’ permission; no response body on success (204).

Action Parameters

id
stringRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Delete an early access feature by id from a specified project. requires a uuid for the feature and the project’s id. authentication via personalapikeyauth is necessary. no response body upon success.

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Delete a specific user (by uuid) from the explicit members of a given project. requires ‘project id’ and member’s ‘parent membership user uuid’. returns 204 on success with no response body.

Action Parameters

parent__membership__user__uuid
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Delete /api/projects/{project_id}/feature flags/{feature flag_id}/role access/{id}: remove role access from a feature flag in a project by id, requiring authorization. expect no response body upon success (204).

Action Parameters

feature_flag_id
integerRequired
id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Delete /api/organizations/{org_id}/members/{user_uuid}: removes a specific member from an organization using uuids for both entities. requires ‘organization member:write’ permission; returns 204 with no content on success.

Action Parameters

organization_id
stringRequired
user__uuid
stringRequired

Action Response

data
object
error
successful
boolean

Delete a specific batch export by its uuid in an organization. requires personalapikeyauth with batch export:write permission. returns 204 on success with no response body.

Action Parameters

id
stringRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Delete a specific pipeline destination in an organization by id. requires an integer ‘id’ of the destination, and the organization’s ‘uuid’. auth: personalapikey with plugin:write. no return body on success (204).

Action Parameters

id
integerRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Delete a specific pipeline transformation plugin for an organization by id. requires a uuid for the organization and an integer for the plugin. auth: personalapikey with write access. no response body on success (204).

Action Parameters

id
integerRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Delete a specific plugin (by its integer id) from the organization (identified by uuid) with no response body on success. requires plugin:write authorization via personalapikeyauth.

Action Parameters

id
integerRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Delete a proxy record by id for a specific organization. requires an authenticated user with ‘organization:write’ permission. on success, it responds with a 204 status and no content.

Action Parameters

id
stringRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Delete a role with a specific uuid in an organization. requires ‘organization:write’ permission. no response body on success (204). path parameters include ‘id’ and ‘organization id’.

Action Parameters

id
stringRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Delete a specific pipeline import app plugin associated with an organization by id. requires a personal api key with write permissions for plugins. responds with no content on success (204).

Action Parameters

id
integerRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Delete a pipeline destination configuration by specifying a unique integer id within a project. requires ‘plugin:write’ permission via personalapikeyauth. no response body on success (204). project id is mandatory.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Delete a specific pipeline frontend app by its id within an organization. requires the organization id (uuid) and the app’s integer id. auth: personalapikeyauth with plugin:write scope. no response body on success (204).

Action Parameters

id
integerRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Delete a pipeline frontend app configuration for a specific project. requires ‘project id’ and config ‘id’ in the path and ‘plugin:write’ permissions. responds with 204 on success without a body.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Delete a specific pipeline import app configuration using its id within a project. requires project id and config id, and auth via personalapikeyauth with plugin write access. no response body on success (204).

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Delete a specific pipeline transformation configuration by id within a project. requires the project id and configuration id. secured by personalapikeyauth with plugin:write access. no response body upon success (204).

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Remove a collaborator from a project dashboard. provide the project id, dashboard id, and user’s uuid. requires ‘dashboard:write’ permissions. expect no response body on success (204). project id guidance at ‘/api/projects/’.

Action Parameters

dashboard_id
integerRequired
project_id
stringRequired
user__uuid
stringRequired

Action Response

data
object
error
successful
boolean

Delete an event definition by providing its uuid and the associated project id. requires event definition:write permission. successful deletion returns no content (204 status).

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Delete a specific experiment by its unique integer id within a project. requires a project id and personal api key with experiment write permission. no response body upon success.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Delete /api/projects/{project_id}/plugin configs/{id}/: removes a specific plugin configuration by id from a given project. requires ‘plugin:write’ permissions and project id. returns 204 with no body on success.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Delete a property definition by providing its uuid and the associated project id. requires ‘property definition:write’ permission. on success, no response body is returned (204).

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Delete /api/organizations/{org_id}/roles/{role_id}/role memberships/{id}: removes a role membership from an organization using a specific uuid. requires write access. returns 204 on success.

Action Parameters

id
stringRequired
organization_id
stringRequired
role_id
stringRequired

Action Response

data
object
error
successful
boolean

Delete a session recording from a playlist using its id within a specified project. requires project id, short id, and session recording id in the path. returns no content on success (204).

Action Parameters

project_id
stringRequired
session_recording_id
stringRequired
short_id
stringRequired

Action Response

data
object
error
successful
boolean

Delete a specific batch export by providing the uuid and project id. requires a personal api key with ‘batch export:write’ permissions. responds with no body upon successful deletion (http 204).

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

(experimental)

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve app-specific metrics for a given project by providing the project id and app metric id. requires a personal api key with plugin:read access. no response body provided upon success (200).

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieves detailed error information for a specific app metric by id within a project. requires project id and metric’s integer id as path parameters. no response body for a successful query.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

(experimental)

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve details of a specific batch export by its uuid in a project. requires project id and batch export id. supports personalapikeyauth and responds with export details including destination, interval, and status.

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve logs for a specific batch export given by uuid within an organization. essential for tracking export status, errors, and configurations. supports json responses detailing export properties and history.

Action Parameters

id
stringRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve logs for a specific batch export run within a project. requires project id, batch export id, and id (all uuids). the endpoint returns run status, error info, record count, and timestamps.

Action Parameters

batch_export_id
stringRequired
id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve activity details for a specific cohort within a project. requires a project id and cohort id, returning status, filters, query, and creator data. auth: personalapikeyauth with ‘activity log:read’ scope.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve details of persons within a cohort by its unique id in the specified project. the endpoint supports json and csv formats and requires authorization. project and cohort ids must be provided.

Action Parameters

format
string
id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Fetch specific dashboard template details by uuid in a project with ‘dashboard template:read’ rights using a personalapikeyauth. returns name, description, filters, and creation info.

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve the json schema for dashboard templates of a specific project. pass the project id in the path and receive details such as template name, description, filters, and more. supports get requests.

Action Parameters

project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve definitions for events within a specified project by providing the unique project id. requires personalapikeyauth privileges for event definition:read. no response body provided upon a successful call.

Action Parameters

project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve an event definition by its uuid within a specified project. requires a project id and an event definition id, with access secured by personalapikeyauth. (get /api/projects/{project_id}/event definitions/{id})

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve details for experiments that require feature flag implementation in a specific project. requires a valid ‘project id’ and user must have ‘experiment:read’ permission. returns information like experiment names, dates, flags, and creation data.

Action Parameters

project_id
stringRequired

Action Response

data
object
error
successful
boolean

Access detailed experiment info within a project using unique experiment id & project id, with ‘experiment:read’ rights. response includes dates, feature flag key, metrics, creator details.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve the configuration for unsubscribing from exports in the pipeline import apps for a specific organization. requires an organization uuid in the path. returns various properties including ids, plugin types, and metadata as a json object.

Action Parameters

organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Learn to manage feature flags by creating, reading, updating, and deleting them. use posthog’s javascript library or endpoint for application integration. details in the docs.

Action Parameters

project_id
stringRequired

Action Response

data
object
error
successful
boolean

Manage feature flags—create, read, update, delete—using the posthog javascript library or endpoint for user-specific flag status. (more in docs).

Action Parameters

project_id
stringRequired

Action Response

data
object
error
successful
boolean

Manage feature flags (creation, reading, updating, and deleting) using posthog’s guides or via javascript library/endpoint for user-specific flag status. details

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

This guide details how to manage (create, read, update, delete) feature flags in applications using posthog’s javascript library or endpoint. for more info, visit the provided documentation.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve details for a specific role’s access to a feature flag within a project. requires ‘feature flag id’, ‘id’ for role access, and ‘project id’. returns a json object with access details.

Action Parameters

feature_flag_id
integerRequired
id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Get property definitions for a project using project id, with filters for event names, property types, exclusions, and numerical or feature flags. also, view properties relevant to specific events.

Action Parameters

event_names
string
excluded_properties
string
filter_by_event_names
boolean
group_type_index
integer
is_feature_flag
boolean
is_numerical
boolean
project_id
stringRequired
properties
string
search
string
type
stringDefaults to event

Action Response

data
object
error
successful
boolean

Gain insights from funnel analysis of a specific project by providing its id and having ‘insight:read’ permission. supports json/csv formats and offers detailed info like creation, modification, and dashboards quickly.

Action Parameters

format
string
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve property definitions for a group within a project by providing the project id. this endpoint returns details like group type index, key, and creation time in json format.

Action Parameters

project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve property values by ‘group type index’ and ‘key’ within a ‘project id’. parameters must be provided. output is a json with property details and creation timestamp.

Action Parameters

group_type_index
integerRequired
key
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve user’s hedgehog configuration details by their uuid. this endpoint requires the user’s uuid as a path parameter and returns various user-related settings such as email, team info, timezone, and more in json format. supports get requests.

Action Parameters

uuid
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve historical export data for app metrics by supplying the project id and plugin config id. requires plugin:read permission. no response body provided upon a successful request.

Action Parameters

plugin_config_id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve a log of important changes for a specified project. requires a project id and returns details about the change, including user info, read status, and timestamps. use /api/projects/{project_id}“ to obtain project ids.

Action Parameters

project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve sharing configurations for a specific insight within a project, requiring project and insight ids. validates access via personalapikeyauth. returns data such as creation time and access tokens.

Action Parameters

insight_id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Returns basic details about the last 5 insights viewed by this user. most recently viewed first.

Action Parameters

format
string
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieves event ids matching a filter with one session id and at least one event/action criterion. intended for internal use and may have sudden changes.

Action Parameters

project_id
stringRequired

Action Response

data
object
error
successful
boolean

The api for interacting with notebooks. this feature is in early access and the api can have breaking changes without announcement.

Action Parameters

project_id
stringRequired

Action Response

data
object
error
successful
boolean

The api for interacting with notebooks. this feature is in early access and the api can have breaking changes without announcement.

Action Parameters

project_id
stringRequired
short_id
stringRequired

Action Response

data
object
error
successful
boolean

The api for interacting with notebooks. this feature is in early access and the api can have breaking changes without announcement.

Action Parameters

project_id
stringRequired
short_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve pipeline frontend app details for an organization using its ‘organization id’ (uuid). response includes id, plugin type, name, url in json format, covering various plugin types.

Action Parameters

organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve unsubscribe config details for an organization’s pipeline frontend apps. requires an organization id (uuid). returns json with config data including plugin types and more.

Action Parameters

organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve activity details for plugins in a specified organization by id. supports various plugin types, including local, custom, and repository. response includes plugin’s id, name, type, and relevant metrics. requires a valid uuid for ‘organization id’.

Action Parameters

organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve a specific plugin’s details for an organization. requires the plugin’s integer id and the organization’s uuid. only returns plugin info if authenticated with ‘plugin:read’ permission. responds with plugin data in json format.

Action Parameters

id
integerRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve plugin repository details for a specific organization by its uuid, including plugin type, name, url, and more. accessible via get request to ‘/api/organizations/{organization_id}/plugins/repository/’.

Action Parameters

organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve plugin export unsubscribe configurations for a specified organization by organization id. supports local, custom, repository, source, and inline plugin types, providing details like name, description, url, and icon.

Action Parameters

organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Projects for the current organization.

Action Parameters

id
integerRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve the details of a specific role within an organization using its uuid. requires the organization’s uuid and role’s uuid in the path and is protected by personalapikeyauth with ‘organization:read’ scope. returns role data in json.

Action Parameters

id
stringRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve details for repository pipeline destinations within a specific organization by its uuid. returns objects like id, name, and urls with support for various plugin types (local, custom, etc.).

Action Parameters

organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve unused pipeline import apps for a specified organization. endpoint requires an organization id (uuid) and returns details like plugin type, name, description, and more in json format.

Action Parameters

organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve pipeline transformation activity details for a specific organization using its uuid. returns data such as plugin type, name, description, and related metrics. requires ‘organization id’ in url path.

Action Parameters

organization_id
stringRequired

Action Response

data
object
error
successful
boolean

This endpoint is for reading and deleting person data; use the capture api, \$set/\$unset properties, or sdks for creation and updates.

Action Parameters

format
string
project_id
stringRequired

Action Response

data
object
error
successful
boolean

This api endpoint is for reading and deleting user data. use the capture api, \$set and \$unset properties, or sdks for creating/updating users.

Action Parameters

format
string
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve a paginated list of organizations with optional ‘limit’ and ‘offset’ query parameters. the response includes organization details like id, name, and membership level, with secure access controlled via personalapikeyauth.

Action Parameters

limit
integerDefaults to 1
offset
integer

Action Response

data
object
error
successful
boolean

This endpoint is for reading and deleting persons. use the capture api, \$set and \$unset properties, or sdks for creating or updating persons.

Action Parameters

format
string
project_id
stringRequired

Action Response

data
object
error
successful
boolean

This endpoint is used to read and delete persons. for creating or updating, use the capture api, \$set and \$unset properties, or sdks.

Action Parameters

format
string
id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

This endpoint allows reading and deleting persons; for creation or updates, use the capture api, the \$set and \$unset properties, or sdks.

Action Parameters

format
string
project_id
stringRequired

Action Response

data
object
error
successful
boolean

This endpoint is for reading and deleting persons. use the capture api, property methods, or sdks for creating or updating persons.

Action Parameters

format
string
project_id
stringRequired

Action Response

data
object
error
successful
boolean

This endpoint allows reading and deleting individuals. use the capture api, \$set and \$unset properties, or sdks for creating or updating persons.

Action Parameters

format
string
id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

This endpoint is for reading and deleting persons; for creating/updating, use the capture api, \$set/\$unset properties, or sdks.

Action Parameters

format
string
id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

This endpoint is for reading and deleting persons. for creation or updates, use the capture api, \$set/\$unset, or sdks.

Action Parameters

format
string
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve activity details for pipeline destinations within an organization. required: uuid-formatted organization id. outputs application/json with attributes: id, latest tag, etc. supports get requests.

Action Parameters

organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve details of a specific pipeline destination config for a project by its id. requires project id and destination config id. supports personalapikeyauth for read access. responds with config details including plugin info, status, and timestamps.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Fetch a pipeline destination’s details by id and organization uuid, using a personalapikeyauth with read access to plugins. returns json with plugin info.

Action Parameters

id
integerRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve configuration details for a specific pipeline destination in a project by getting the frontend data of the config with a given id. this endpoint requires the ‘project id’ and ‘id’ of the config.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve details of a specific pipeline destination plugin within an organization by its unique id. the response includes various properties like name, description, url, and plugin type for the given organization uuid.

Action Parameters

id
integerRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve activity details for pipeline front-end apps within a specified organization by organization id. returns json object with app properties such as id, type, name, and configuration. uuid path parameter required.

Action Parameters

organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieves details of a specified pipeline frontend app within an organization. requires plugin read access and organization id (uuid), and app id (integer) as path parameters. returns json with app information.

Action Parameters

id
integerRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve details for a specific pipeline frontend app’s source by its id within an organization. requires an integer id of the app and uuid of the organization. returns json object with app properties.

Action Parameters

id
integerRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve the frontend configuration for a specific plugin in a project’s pipeline. requires project and config ids and returns details like plugin info, status, and creation timestamps.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve activity details of pipeline import apps for a given organization. requires ‘organization id’ (uuid). returns app id, type, name, url, and other metadata. supports ‘local’, ‘custom’, ‘repository’, ‘source’, and ‘inline’ plugin types.

Action Parameters

organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Access specific pipeline import app details in an organization using its id and a valid organization uuid. requires ‘personalapikeyauth’ with ‘plugin:read’ access. outputs app properties in json format.

Action Parameters

id
integerRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieves source details of a pipeline import app by its id within a specified organization. expects organization id (uuid) and id (integer) as path parameters. returns app properties including type, name, and related info.

Action Parameters

id
integerRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve pipeline transformation plugin details by id for a specified organization. requires authentication and provides information like plugin type, name, and configuration for authorized users. supports json response.

Action Parameters

id
integerRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve the activity details of a specific pipeline transformation configuration in a project using its unique integer id. requires project id. returns json including config, plugin info, and activity data.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve the configuration for a specific pipeline transformation plugin in a project by its id using a get request. requires project id and plugin config id in the path and ‘plugin:read’ permission.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve the frontend configuration details for a specific pipeline transformation by id within a given project. this endpoint requires the project id and transformation config id in the path.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve activity details for a specific plugin config within a project’s pipeline import apps. requires ‘project id’ and plugin config ‘id’ within the api path.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve activity details for a specific plugin configuration within a project. requires project id and unique id of the plugin config. responds with plugin info, status, and activity metrics.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve the configuration details of a specific plugin by its id for a given project. this endpoint requires a project id and plugin config id, with read permission, and returns an object containing config settings and status.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve the frontend configuration of an app’s pipeline import by id within a specified project. requires project id and id of the plugin config. returns json object with config details.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve the frontend configuration of a specific plugin for a given project. requires the project id and plugin config id. provides details including plugin state, order, and related info.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve plugin source details by organization and plugin id. requires integer ‘id’ for the plugin and ‘organization id’ as uuid. responds with plugin attributes including type, name, and url.

Action Parameters

id
integerRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve the source details of a pipeline transformation for a specific plugin by id within an organization. access plugin metadata, like its type, url, and config, relevant to organizing and managing pipeline operations.

Action Parameters

id
integerRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

This endpoint retrieves update information for a specific plugin within an organization’s pipeline frontend app by its integer id and the organization’s uuid. it returns details such as plugin type, name, and latest version.

Action Parameters

id
integerRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve the latest update status for a specific plugin, identified by its integer id, within an organization specified by uuid. check compatibility and change logs.

Action Parameters

id
integerRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Get details on a project action by id. supports json/csv format via query. needs ‘project id’ and ‘id’ path parameters. secured by personalapikeyauth.

Action Parameters

format
string
id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Projects for the current organization.

Action Parameters

id
integerRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve activity insights for a specific project by project id, supporting csv or json formats. requires an api key with activity log:read permission. limited to essential data to enhance response time for large datasets.

Action Parameters

format
string
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Access a project’s activity log using pagination and cursor-based navigation. requires project id and personalapikeyauth. outputs activity list with user data and timestamps.

Action Parameters

cursor
string
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Create, read, update and delete annotations. see docs for more information on annotations.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve activity log for a specific project’s cohorts. requires a project id and personalapikeyauth with activity log:read permission. response includes cohort details and creator info.

Action Parameters

project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve a paginated list of cohorts for a specific project using project id. supports limit and offset query params to customize the response. requires personalapikeyauth with cohort:read permissions.

Action Parameters

limit
integer
offset
integer
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve detailed information about a specific cohort within a project using its id. requires project id and cohort id; returns cohort details including name, creator info, and status. auth: personalapikeyauth with cohort:read permission.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve the draft sql query for a specific project using its project id. ensure to obtain the project id by calling /api/projects/. note: this endpoint does not return a response body.

Action Parameters

project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve details of a specific early access feature in a project by id. requires project id and feature uuid. must have ‘early access feature:read’ permission. returns feature details including status, flag info, and timestamps.

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve details for a specific event by id within a project. supports csv or json format. requires project id in path and adheres to personalapikeyauth for security.

Action Parameters

format
string
id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve event values for a specific project by id. supports querying in csv or json format. requires a project id and personal api key with query:read permission. responds with event details such as id, distinct id, properties, etc.

Action Parameters

format
string
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve experiment results within a project by project and experiment id. requires project id and experiment id in the path. returns experiment details in json, with authentication via personalapikeyauth.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve detailed info on a specific export of a project using its unique id. requires project id and supports various export formats like png, pdf, csv, and xlsx. auth: personalapikeyauth with export:read scope.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve insights about funnel correlations for a specific project by id, offering results in json or csv. supports querying and output formatting, with a focus on fast loading of large datasets.

Action Parameters

format
string
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieves specified group details within a project by group key and type index. requires ‘group key’, ‘group type index’, and ‘project id’. responds with group details, including creation timestamp.

Action Parameters

group_key
stringRequired
group_type_index
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve detailed insights for a specific project using its id. queries can be made in csv or json format. requires ‘insight:read’ permission. results include various metadata like creation, last refresh, and associated dashboard info.

Action Parameters

format
string
project_id
stringRequired

Action Response

data
object
error
successful
boolean

The get /api/projects/{project_id}/insights/ endpoint retrieves a paginated list of insights for a specified project. filter by creator, response format (csv/json), and use limit/offset for result batching. requires insight:read permission.

Action Parameters

created_by
integer
format
string
limit
integerDefaults to 1
offset
integer
project_id
stringRequired
short_id
string

Action Response

data
object
error
successful
boolean

Retrieve insights activity for a specific project and insight id, offering data in json or csv format. requires project id and insight id in the path, with optional data format query. secure access via personalapikeyauth.

Action Parameters

format
string
id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve details for a specific project insight by id, with options to format as json/csv, request refresh, and specify dashboard context. supports personalapikeyauth with insight read access. responses include metadata, results, and caching info.

Action Parameters

format
string
from_dashboard
integer
id
integerRequired
project_id
stringRequired
refresh
boolean

Action Response

data
object
error
successful
boolean

Retrieve detailed information about a specific user’s membership level and status within a project by their uuid. access project members’ data, roles, and timestamps. (get /api/projects/{project_id}/explicit members/{uuid})

Action Parameters

parent__membership__user__uuid
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

This endpoint allows reading and deleting individuals. for creating or updating, use the capture api, \$set/\$unset properties, or sdks.

Action Parameters

format
string
project_id
stringRequired

Action Response

data
object
error
successful
boolean

This endpoint allows reading and deletion of persons; for creation or updates, use the capture api, \$set/\$unset properties, or sdks.

Action Parameters

format
string
project_id
stringRequired

Action Response

data
object
error
successful
boolean

This endpoint allows for reading and deleting persons. for creations or updates, use the capture api, set/unset properties, or sdks.

Action Parameters

format
string
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve configuration details of a specific plugin for a given project pipeline by id. requires a valid project id and plugin config id. supports personalapikeyauth for ‘plugin:read’ access. responds with json containing configuration data.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve session values for a specified project. pass the project id in the url path to obtain the information. only the project’s id is required as a parameter. no response body for the 200 ok status code.

Action Parameters

project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve a specific subscription for a project, identified by ‘project id’ and ‘id’. requires valid api key with read access. supports get method, returns subscription details including frequency, type, and creator info.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve trend insights for a specific project, supporting csv or json formats. mandatory project id required. provides details on insight cache status, creator, and associated dashboards. auth: personalapikeyauth.

Action Parameters

format
string
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Allows a caller to provide a list of event names and a single property name returns a map of the event names to a boolean representing whether that property has ever been seen with that event name

Action Parameters

project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve details of a specific property definition by uuid within a project. requires project id and property definition id. security: personalapikeyauth with read access. no response body provided.

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve a specific proxy record’s details by id within an organization. requires path parameters ‘organization id’ and ‘id’. returns json data including domain, status, and timestamps. auth: personalapikeyauth with ‘organization:read’.

Action Parameters

id
stringRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve retention insights for a specified project. options to output in csv or json format. requires a project id and supports query customization. authenticated access with ‘insight:read’ permission necessary.

Action Parameters

format
string
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve property definitions for a specific project by providing the project’s id. access this get endpoint at /api/projects/{project_id}/sessions/property definitions/. project id is mandatory. no response body is returned upon a successful call.

Action Parameters

project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve detailed information about a specific session recording by providing the session’s uuid and associated project id. the response includes metrics such as duration, activity, timestamps, and user data. authentication is required.

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve error clusters from session recordings for a specified project. this endpoint provides details on user interactions, console logs, and activity times in json format, requiring the project id in the path.

Action Parameters

project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve session recording playlists for a specified project and playlist short id. returns details like name, creator info, and recordings. access by making a get request to /api/projects/{project_id}/session recording playlists/{short_id}/recordings/.

Action Parameters

project_id
stringRequired
short_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve properties of session recordings for a given project by id, including activity metrics, timestamps, and participant details. requires project id in the path. returns json data with recording details.

Action Parameters

project_id
stringRequired

Action Response

data
object
error
successful
boolean

Snapshots for a session can be loaded from s3 (if old) or redis (if recent). clients call the api without a source to get supported sources, then per source for snapshots. api v1 is deprecated; clickhouse support removed.

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve similar session recordings for a given session by uuid within a project. details include session activity data, user info, and timestamps. requires project id and session id.

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve details of a specific batch export for an organization by its uuid. requires a personalapikeyauth with ‘batch export:read’ permission. responses include export details like name, model, destination, interval, and more.

Action Parameters

id
stringRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve details for a specific batch export run within a project by id. requires a uuid for batch export id and run id. provides run status, record count, timestamps, latest error, and intervals. security: personalapikeyauth.

Action Parameters

batch_export_id
stringRequired
id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve details of a specific domain within an organization using its uuid. authorized users can check domain verification status and saml configuration. requires the personalapikeyauth with organization:read scope.

Action Parameters

id
stringRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve the content of a specific exported asset by id within a project. requires ‘export:read’ permission. supports fetching details like creation time, format (png, pdf, csv, excel), etc.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve historical export data for a specific plugin configuration within a project. requires project, plugin config, and export item ids. auth via personalapikeyauth. no body in 200 response.

Action Parameters

id
stringRequired
plugin_config_id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve the configuration details of a specific pipeline frontend app by providing its unique id and the associated project id. permissions: ‘plugin:read’. response includes plugin config info like enabled state and creation timestamp.

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve details of a specific dashboard within a project. requires a dashboard id & project id, and returns information such as dashboard properties, owner, and access levels. auth: personalapikeyauth[dashboard:read].

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve activity logs for specific survey in a project, identified by uuids. requires valid api key with ‘activity log:read’ permissions. supports json response detailing survey’s properties, types, and creator info.

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve survey details using survey uuid and associated project id. supports secure access with ‘personalapikeyauth’. returns survey name, type, linking, targeting flags, creator info, and questions with branching logic descriptions.

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve the count of survey responses for a specific project by its id. it requires the project id parameter and returns details like the survey type, linked flags, and creator info.

Action Parameters

project_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve config details for unsubscribed pipeline destinations in an organization. requires ‘organization id’ (uuid). returns plugin info, name, description, and more in json format.

Action Parameters

organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve unused pipeline frontend apps for a specific organization by its uuid. returns details like app ids, types, names, descriptions, and other metadata in json format. requires organization id in path.

Action Parameters

organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve a list of unused plugins for a specified organization by its uuid. the response includes plugin details such as type, name, and configuration. access restricted to the specified organization’s context.

Action Parameters

organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Retrieve unused pipeline destinations for a specified organization by id. this get endpoint returns a json object with details like destination id, plugin type, and url, among other attributes. (uuid for organization id is required.)

Action Parameters

organization_id
stringRequired

Action Response

data
object
error
successful
boolean

The endpoint get /api/users/{uuid}/start 2fa setup/ fetches details for initiating 2fa setup for a user, providing information like email status, password presence, and more. fields are mostly read-only.

Action Parameters

uuid
stringRequired

Action Response

data
object
error
successful
boolean

Fetch user info like profile, team, org, and notifications via uuid using personalapikeyauth (‘user:read’). returns json with name, email, teams, and status.

Action Parameters

uuid
stringRequired

Action Response

data
object
error
successful
boolean

Delete an organization invite by its uuid. requires a valid personalapikeyauth with organization member write permission. no response body returned on success (http 204).

Action Parameters

id
stringRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Hard delete of this model is not allowed. use a patch api call to set “deleted” to true

Action Parameters

format
string
id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Hard delete of this model is not allowed. use a patch api call to set “deleted” to true

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Hard delete of this model is not allowed. use a patch api call to set “deleted” to true

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Hard delete of this model is not allowed. use a patch api call to set “deleted” to true

Action Parameters

id
integerRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

This endpoint allows reading and deleting persons; for creation or updates, use the capture api, \$set/\$unset properties, or sdks.

Action Parameters

created_at
stringRequired
distinct_ids
arrayRequired
format
string
id
integerRequired
name
stringRequired
project_id
stringRequired
properties
uuid
stringRequired

Action Response

data
object
error
successful
boolean

The /api/projects/{project_id}/exports/ endpoint triggers a project export, requiring project id and export format. it accepts json, form-encoded, and multipart data, responding with a 201 code and export information.

Action Parameters

created_at
stringRequired
dashboard
integer
expires_after
string
export_context
export_format
stringRequired
filename
stringRequired
has_content
stringRequired
id
integerRequired
insight
integer
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Create, read, update and delete annotations. see docs for more information on annotations.

Action Parameters

content
string
created_at
stringRequired
creation_type
string
dashboard_id
integerRequired
dashboard_item
integer
dashboard_name
stringRequired
date_marker
string
deleted
boolean
id
integerRequired
insight_derived_name
stringRequired
insight_name
stringRequired
insight_short_id
stringRequired
project_id
stringRequired
scope
string
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

This patch endpoint updates a specific early access project feature. it requires project id and id (uuid) as path parameters. the body can include feature details like name, description, and stage. security: personalapikeyauth.

Action Parameters

created_at
string
description
string
documentation_url
string
id
stringRequired
name
string
project_id
stringRequired
stage
string

Action Response

data
object
error
successful
boolean

Update an event definition by sending a put request to ‘/api/projects/{project_id}/event definitions/{id}/’ using the uuid and project id, provided you have ‘event definition:write’ authorization.

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Update an experiment by sending a put request with project id and id, including new details as json/form data. changes to name, description, dates, etc., allowed. experiment:write permission needed.

Action Parameters

archived
boolean
created_at
stringRequired
description
string
end_date
string
exposure_cohort
integerRequired
feature_flag_key
stringRequired
filters
id
integerRequired
name
stringRequired
parameters
project_id
stringRequired
secondary_metrics
start_date
string
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Manage feature flags for your app with creation, reading, updating, and deletion options. utilize posthog’s js library or endpoint for flag status. more info in docs.

Action Parameters

active
boolean
analytics_dashboards
array
can_edit
booleanRequired
created_at
string
deleted
boolean
ensure_experience_continuity
boolean
experiment_set
arrayRequired
features
objectRequired
filters
object
has_enriched_analytics
boolean
id
integerRequired
is_simple_flag
booleanRequired
key
stringRequired
name
string
performed_rollback
boolean
project_id
stringRequired
rollback_conditions
rollout_percentage
integerRequired
surveys
objectRequired
tags
array
usage_dashboard
integerRequired

Action Response

data
object
error
successful
boolean

Update specific details of an organization using its uuid. allows patch requests with json, form data, or multipart. requires organization:write permission. returns updated organization info.

Action Parameters

available_product_features
array
created_at
string
customer_id
string
enforce_2fa
boolean
id
stringRequired
is_member_join_email_enabled
boolean
member_count
string
metadata
string
name
string
slug
string
teams
array
updated_at
string

Action Response

data
object
error
successful
boolean

Update a domain’s info for a specific organization by id, including verification status and saml configuration. requires uuid path params and supports json, form-data content types.

Action Parameters

domain
stringRequired
has_saml
booleanRequired
id
stringRequired
is_verified
booleanRequired
jit_provisioning_enabled
boolean
organization_id
stringRequired
saml_acs_url
string
saml_entity_id
string
saml_x509_cert
string
sso_enforcement
string
verification_challenge
stringRequired
verified_at
stringRequired

Action Response

data
object
error
successful
boolean

Updates selected properties of a domain in an organization via patch request, supports various data formats but saml fields are immutable. authentication needed.

Action Parameters

domain
string
has_saml
boolean
id
stringRequired
is_verified
boolean
jit_provisioning_enabled
boolean
organization_id
stringRequired
saml_acs_url
string
saml_entity_id
string
saml_x509_cert
string
sso_enforcement
string
verification_challenge
string
verified_at
string

Action Response

data
object
error
successful
boolean

Patch ‘/api/organizations/{id}/members/{uuid}’: updates org member with user and org uuids. supports json/form/multipart. returns member data. secured by personalapikeyauth.

Action Parameters

has_social_auth
boolean
id
string
is_2fa_enabled
boolean
joined_at
string
organization_id
stringRequired
updated_at
string
user__uuid
stringRequired

Action Response

data
object
error
successful
boolean

Update member details in an organization by id and user uuid. requires org member write permission. accepts json, form, or multipart. responses reflect member info, including roles and security settings.

Action Parameters

has_social_auth
booleanRequired
id
stringRequired
is_2fa_enabled
booleanRequired
joined_at
stringRequired
organization_id
stringRequired
updated_at
stringRequired
user__uuid
stringRequired

Action Response

data
object
error
successful
boolean

Update a proxy record’s domain details for a specified organization and proxy record id using put. requires organization and record ids, supports json, form, and multipart data. responses include status and timestamps. auth required.

Action Parameters

created_at
stringRequired
created_by
integerRequired
domain
stringRequired
id
stringRequired
message
stringRequired
organization_id
stringRequired
target_cname
stringRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Update partial cohort details for a specific project. requires a cohort id and project id, supports json, form data, and accepts patch changes like name or description. returns updated cohort data. auth required.

Action Parameters

count
integer
created_at
string
deleted
boolean
description
string
errors_calculating
integer
experiment_set
array
filters
groups
id
integerRequired
is_calculating
boolean
is_static
boolean
last_calculation
string
name
string
project_id
stringRequired
query

Action Response

data
object
error
successful
boolean

Patch /api/organizations/{organization_id}/roles/{id}/: update partial details of a role by id within an organization, including name and feature flag access level. requires uuids for both organization and role. supports json, form, and multipart data.

Action Parameters

associated_flags
string
created_at
string
id
stringRequired
members
string
name
string
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Patch /api/projects/{project_id}/subscriptions/{id}/: update partial details of a specific project subscription by id. modify target, frequency, and more. requires subscription:write permission.

Action Parameters

bysetpos
integer
byweekday
array
count
integer
created_at
string
dashboard
integer
deleted
boolean
frequency
string
id
integerRequired
insight
integer
interval
integer
invite_message
string
next_delivery_date
string
project_id
stringRequired
start_date
string
summary
string
target_type
string
target_value
string
title
string
until_date
string

Action Response

data
object
error
successful
boolean

Update partial survey details by patch to /api/projects/{project_id}/surveys/{id}/ with uuid. edit attributes like name, type, questions, targeting, and flags. needs personalapikeyauth for write access.

Action Parameters

appearance
archived
boolean
conditions
created_at
string
current_iteration
integer
current_iteration_start_date
string
description
string
end_date
string
id
stringRequired
iteration_count
integer
iteration_frequency_days
integer
iteration_start_dates
array
linked_flag_id
integer
name
string
project_id
stringRequired
questions
remove_targeting_flag
boolean
responses_limit
integer
start_date
string
targeting_flag_filters
targeting_flag_id
integer
type
string

Action Response

data
object
error
successful
boolean

Request data’s “properties” will be updated on a person using “$set” event, affecting only listed properties without deletion or other changes. for property removal, use ‘delete property’ endpoint.

Action Parameters

created_at
stringRequired
distinct_ids
arrayRequired
format
string
id
integerRequired
name
stringRequired
project_id
stringRequired
properties
uuid
stringRequired

Action Response

data
object
error
successful
boolean

This endpoint allows for reading and deleting individuals. use the capture api, \$set and \$unset properties, or sdks for creating or updating persons.

Action Parameters

created_at
stringRequired
distinct_ids
arrayRequired
format
string
id
integerRequired
key
stringRequired
name
stringRequired
project_id
stringRequired
properties
uuid
stringRequired
value
Required

Action Response

data
object
error
successful
boolean

Update the configuration for a pipeline destination in a project. accepts a json, form-urlencoded, or multipart data payload to modify plugin settings by providing project and config ids. requires plugin:write authority. responds with updated data.

Action Parameters

config
stringRequired
created_at
stringRequired
deleted
boolean
delivery_rate_24h
stringRequired
description
string
enabled
boolean
error
stringRequired
filters
id
integerRequired
name
string
order
integerRequired
plugin
integerRequired
plugin_info
stringRequired
project_id
stringRequired
team_id
integerRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Update configuration for a specific pipeline frontend app by providing its id and the project id. configure details like activation, order, and optional parameters via json or form data. authentication required.

Action Parameters

config
stringRequired
created_at
stringRequired
deleted
boolean
delivery_rate_24h
stringRequired
description
string
enabled
boolean
error
stringRequired
filters
id
integerRequired
name
string
order
integerRequired
plugin
integerRequired
plugin_info
stringRequired
project_id
stringRequired
team_id
integerRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Update a project-specific pipeline plugin configuration by supplying the project id and config id. this put request expects details like plugin state, order, and more in json, form data, or url-encoded format. authentication is required.

Action Parameters

config
stringRequired
created_at
stringRequired
deleted
boolean
delivery_rate_24h
stringRequired
description
string
enabled
boolean
error
stringRequired
filters
id
integerRequired
name
string
order
integerRequired
plugin
integerRequired
plugin_info
stringRequired
project_id
stringRequired
team_id
integerRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Update a pipeline transformation configuration for a specific project and config id. requires project id and config id in the path and json payload. supports plugin activation and order changes.

Action Parameters

config
stringRequired
created_at
stringRequired
deleted
boolean
delivery_rate_24h
stringRequired
description
string
enabled
boolean
error
stringRequired
filters
id
integerRequired
name
string
order
integerRequired
plugin
integerRequired
plugin_info
stringRequired
project_id
stringRequired
team_id
integerRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Update a plugin config’s partial details in a project by its id using patch. requires project id, config id. accepts json/form data. authenticated with personalapikeyauth. returns updated config.

Action Parameters

config
string
created_at
string
deleted
boolean
delivery_rate_24h
string
description
string
enabled
boolean
error
string
filters
id
integerRequired
name
string
order
integer
plugin
integer
plugin_info
string
project_id
stringRequired
team_id
integer
updated_at
string

Action Response

data
object
error
successful
boolean

Put endpoint ‘/api/projects/{project_id}/actions/{id}/’ updates actions in a project by id, accepts json/form data, supports ‘format’ query, and needs ‘action:write’ authentication.

Action Parameters

bytecode_error
stringRequired
created_at
stringRequired
deleted
boolean
description
string
format
string
id
integerRequired
is_action
booleanDefaults to True
is_calculating
booleanRequired
last_calculated_at
string
name
string
post_to_slack
boolean
project_id
stringRequired
slack_message_format
string
steps
array
tags
array
team_id
integerRequired

Action Response

data
object
error
successful
boolean

Update an action within a project with a specified id. supports partial updates. accepts json, form-data, and query parameters including ‘project id’ and ‘id’. formats response in csv or json. requires ‘action:write’ permission.

Action Parameters

bytecode_error
string
created_at
string
deleted
boolean
description
string
format
string
id
integerRequired
is_action
booleanDefaults to True
is_calculating
boolean
last_calculated_at
string
name
string
post_to_slack
boolean
project_id
stringRequired
slack_message_format
string
steps
array
tags
array
team_id
integer

Action Response

data
object
error
successful
boolean

Update cohort details of a specific project by id. requires project and cohort id in the path and a json, form-encoded, or multipart form body. permissions: cohort:write. returns updated cohort data.

Action Parameters

count
integerRequired
created_at
stringRequired
deleted
boolean
description
string
errors_calculating
integerRequired
experiment_set
arrayRequired
filters
groups
id
integerRequired
is_calculating
booleanRequired
is_static
boolean
last_calculation
stringRequired
name
string
project_id
stringRequired
query

Action Response

data
object
error
successful
boolean

Endpoint to update an existing dashboard within a project. provide project id and dashboard id in path, send json or form data with dashboard details. requires dashboard:write permission; responds with updated dashboard data.

Action Parameters

created_at
stringRequired
delete_insights
boolean
deleted
boolean
description
string
filters
id
integerRequired
is_shared
booleanRequired
name
string
pinned
boolean
project_id
stringRequired
tags
array
tiles
arrayRequired
use_dashboard
integer
use_template
string

Action Response

data
object
error
successful
boolean

Update a specific early access feature of a project by providing the project id and feature id (uuid). requires a json body with feature details and responds with the updated status. authentication via personalapikeyauth is mandatory.

Action Parameters

created_at
stringRequired
description
string
documentation_url
string
id
stringRequired
name
stringRequired
project_id
stringRequired
stage
stringRequired

Action Response

data
object
error
successful
boolean

Update an existing event definition for a specified project using its uuid. requires a project id and event definition write permissions. responds without a body on success.

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Patch /api/projects/{project_id}/groups types/update metadata: update group type metadata for a specific project using its project id. can modify name singular and name plural fields up to 400 characters each.

Action Parameters

group_type
string
group_type_index
integer
name_plural
string
name_singular
string
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Endpoint “/api/projects/{project_id}/insights/{id}/” allows for updating an insight’s details for a given project and insight id, supporting json and csv formats, with fields like name, query, and various timestamps. requires insight write permission.

Action Parameters

cache_target_age
stringRequired
columns
stringRequired
created_at
stringRequired
dashboard_tiles
arrayRequired
dashboards
array
deleted
boolean
derived_name
string
description
string
favorited
boolean
filters
format
string
hogql
stringRequired
id
integerRequired
is_cached
stringRequired
is_sample
booleanRequired
last_modified_at
stringRequired
last_refresh
stringRequired
name
string
next_allowed_client_refresh
stringRequired
order
integer
project_id
stringRequired
query
query_status
stringRequired
result
stringRequired
saved
boolean
short_id
stringRequired
tags
array
timezone
stringRequired
types
stringRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Update a project member’s role using their uuid in a specific project. accepts partial data to modify membership details such as role level, provided the member’s uuid and project id.

Action Parameters

id
string
joined_at
string
parent__membership__user__uuid
stringRequired
parent_level
integer
parent_membership_id
string
project_id
stringRequired
updated_at
string
user_uuid
string

Action Response

data
object
error
successful
boolean

Update explicit project membership using uuids. this put endpoint modifies a project member’s role, where ‘1’ stands for member and ‘8’ for administrator. requires project id and parent membership user uuid.

Action Parameters

id
stringRequired
joined_at
stringRequired
parent__membership__user__uuid
stringRequired
parent_level
integerRequired
parent_membership_id
stringRequired
project_id
stringRequired
updated_at
stringRequired
user_uuid
stringRequired

Action Response

data
object
error
successful
boolean

The api for interacting with notebooks. this feature is in early access and the api can have breaking changes without announcement.

Action Parameters

content
created_at
stringRequired
deleted
boolean
id
stringRequired
last_modified_at
stringRequired
project_id
stringRequired
short_id
stringRequired
text_content
string
title
string
version
integer

Action Response

data
object
error
successful
boolean

Update a project’s pipeline destination config by id via patch api request. supports json/form requests, with fields like plugin & order. requires personalapikeyauth.

Action Parameters

config
string
created_at
string
deleted
boolean
delivery_rate_24h
string
description
string
enabled
boolean
error
string
filters
id
integerRequired
name
string
order
integer
plugin
integer
plugin_info
string
project_id
stringRequired
team_id
integer
updated_at
string

Action Response

data
object
error
successful
boolean

Update a specific pipeline transformation configuration for a project by providing a project id and configuration id. this patch request can modify properties like plugin, enabled, and order. authentication via a personal api key is required.

Action Parameters

config
string
created_at
string
deleted
boolean
delivery_rate_24h
string
description
string
enabled
boolean
error
string
filters
id
integerRequired
name
string
order
integer
plugin
integer
plugin_info
string
project_id
stringRequired
team_id
integer
updated_at
string

Action Response

data
object
error
successful
boolean

Update project plugin config using its integer id and project string id; accepts json, url-encoded, or form-data. requires authentication; returns the updated config.

Action Parameters

config
stringRequired
created_at
stringRequired
deleted
boolean
delivery_rate_24h
stringRequired
description
string
enabled
boolean
error
stringRequired
filters
id
integerRequired
name
string
order
integerRequired
plugin
integerRequired
plugin_info
stringRequired
project_id
stringRequired
team_id
integerRequired
updated_at
stringRequired

Action Response

data
object
error
successful
boolean

Update a property definition in a project by its uuid. requires a project id and definition id, both as path parameters. security: personalapikeyauth with write access. no body in the response.

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
object
error
successful
boolean

Update an existing session recording playlist for a project with the specified project id and playlist short id. requires json or form data input to modify the playlist’s properties like name, description, and status.

Action Parameters

created_at
stringRequired
deleted
boolean
derived_name
string
description
string
filters
id
integerRequired
last_modified_at
stringRequired
name
string
pinned
boolean
project_id
stringRequired
short_id
stringRequired

Action Response

data
object
error
successful
boolean

Update a subscription for a specific project. provide project id and subscription id in the path and use mime types like application/json with fields like frequency, target type, etc. requires subscription:write permission.

Action Parameters

bysetpos
integer
byweekday
array
count
integer
created_at
stringRequired
dashboard
integer
deleted
boolean
frequency
stringRequired
id
integerRequired
insight
integer
interval
integer
invite_message
string
next_delivery_date
stringRequired
project_id
stringRequired
start_date
stringRequired
summary
stringRequired
target_type
stringRequired
target_value
stringRequired
title
string
until_date
string

Action Response

data
object
error
successful
boolean

The /api/projects/{project_id}/surveys/{id}/ put endpoint updates survey details in a project using survey uuid and project id, accepts json/form/multipart data, needs survey:write permission, and returns the updated survey.

Action Parameters

appearance
archived
boolean
conditions
stringRequired
created_at
stringRequired
current_iteration
integer
current_iteration_start_date
string
description
string
end_date
string
id
stringRequired
iteration_count
integer
iteration_frequency_days
integer
iteration_start_dates
array
linked_flag_id
integer
name
stringRequired
project_id
stringRequired
questions
responses_limit
integer
start_date
string
type
stringRequired

Action Response

data
object
error
successful
boolean

Update an organization role by submitting its uuid and organization id in uuid format. role details must be in json or form-data. only users with ‘organization:write’ can do this. returns updated role data.

Action Parameters

associated_flags
stringRequired
created_at
stringRequired
id
stringRequired
members
stringRequired
name
stringRequired
organization_id
stringRequired

Action Response

data
object
error
successful
boolean

Update session recording playlists using patch on the endpoint with project id and short id. accepts json and forms data for detail amendments. partial updates allowed. personalapikeyauth needed.

Action Parameters

created_at
string
deleted
boolean
derived_name
string
description
string
filters
id
integer
last_modified_at
string
name
string
pinned
boolean
project_id
stringRequired
short_id
stringRequired

Action Response

data
object
error
successful
boolean

Patch /api/organizations/{organization_id}/proxy records/{id}/: update specific fields of a proxy record by id within an organization. supports json, form data, and multipart. requires organization:write permission. returns updated proxy record.

Action Parameters

created_at
string
created_by
integer
domain
string
id
stringRequired
message
string
organization_id
stringRequired
target_cname
string
updated_at
string

Action Response

data
object
error
successful
boolean