{ "service": "posthog", "displayName": "PostHog", "categories": [ "Data", "Developer Tools" ], "authTypes": [ "oauth2", "api_key" ], "auth": [ { "type": "oauth2", "authorizationUrl": "https://oauth.posthog.com/oauth/authorize/", "tokenUrl": "https://oauth.posthog.com/oauth/token/", "scopes": [ "openid", "profile", "email", "user:read", "organization:read", "project:read", "query:read", "query:write", "insight:read", "insight:write", "dashboard:read", "dashboard:write", "event_definition:read", "event_definition:write", "property_definition:read", "property_definition:write", "annotation:read", "annotation:write", "cohort:read", "cohort:write", "person:read", "feature_flag:read", "feature_flag:write" ], "tokenEndpointAuthMethod": "none", "pkce": { "method": "S256" }, "authorizationParams": { "response_mode": "query", "required_access_level": "organization" }, "tokenRequestFields": { "clientSecret": false } }, { "type": "api_key", "label": "Personal API Key", "placeholder": "phx_...", "description": "PostHog personal API key used with the Authorization Bearer header. Create or manage it at https://us.posthog.com/settings/user-api-keys or https://eu.posthog.com/settings/user-api-keys.", "extraFields": [ { "key": "baseUrl", "label": "Base URL", "inputType": "text", "required": true, "secret": false, "placeholder": "https://us.posthog.com", "description": "PostHog private API base URL, such as https://us.posthog.com, https://eu.posthog.com, or your self-hosted domain." } ] } ], "homepageUrl": "https://posthog.com", "actions": [ { "id": "posthog.add_dashboard_collaborator", "service": "posthog", "name": "add_dashboard_collaborator", "description": "Add a collaborator to a PostHog dashboard.", "requiredScopes": [], "providerPermissions": [ "dashboard:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "dashboard_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." }, "user_uuid": { "type": "string", "minLength": 1, "description": "User UUID to add as a collaborator." }, "level": { "type": "integer", "description": "Restriction level to grant to the collaborator." } }, "additionalProperties": false, "description": "Input for adding a PostHog dashboard collaborator." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "string", "description": "Dashboard collaborator UUID." }, "dashboard_id": { "type": "integer", "description": "Dashboard identifier." }, "user": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, "level": { "type": "integer", "description": "Restriction level granted to the collaborator." }, "added_at": { "type": "string", "description": "Datetime when the collaborator was added." }, "updated_at": { "type": "string", "description": "Datetime when the collaborator was updated." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": true, "required": [ "raw" ], "description": "PostHog dashboard collaborator." } }, { "id": "posthog.add_persons_to_static_cohort", "service": "posthog", "name": "add_persons_to_static_cohort", "description": "Add person UUIDs to a static PostHog cohort.", "requiredScopes": [], "providerPermissions": [ "cohort:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." }, "person_ids": { "type": "array", "items": { "type": "string", "description": "Person UUID." }, "description": "Person UUIDs to add to the static cohort.", "minItems": 1 } }, "additionalProperties": false, "description": "Input for adding persons to a static PostHog cohort." }, "outputSchema": { "type": "object", "properties": { "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": false, "description": "Raw PostHog cohort endpoint payload." } }, { "id": "posthog.bulk_update_event_definition_tags", "service": "posthog", "name": "bulk_update_event_definition_tags", "description": "Bulk add, remove, or set tags on PostHog event definitions.", "requiredScopes": [], "providerPermissions": [ "event_definition:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "ids": { "type": "array", "items": { "type": "integer", "description": "Object ID." }, "description": "Object IDs to update tags on.", "minItems": 1, "maxItems": 500 }, "action": { "type": "string", "enum": [ "add", "remove", "set" ], "description": "Bulk tag action to perform." }, "tags": { "type": "array", "items": { "type": "string", "description": "Tag name." }, "description": "Tag names to add, remove, or set.", "minItems": 1 } }, "additionalProperties": false, "description": "Input for bulk updating tags on PostHog definitions." }, "outputSchema": { "type": "object", "properties": { "updated": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Objects whose tags were updated." }, "skipped": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Objects skipped by PostHog during tag update." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": false, "description": "PostHog bulk tag update response." } }, { "id": "posthog.bulk_update_property_definition_tags", "service": "posthog", "name": "bulk_update_property_definition_tags", "description": "Bulk add, remove, or set tags on PostHog property definitions.", "requiredScopes": [], "providerPermissions": [ "property_definition:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "ids": { "type": "array", "items": { "type": "integer", "description": "Object ID." }, "description": "Object IDs to update tags on.", "minItems": 1, "maxItems": 500 }, "action": { "type": "string", "enum": [ "add", "remove", "set" ], "description": "Bulk tag action to perform." }, "tags": { "type": "array", "items": { "type": "string", "description": "Tag name." }, "description": "Tag names to add, remove, or set.", "minItems": 1 } }, "additionalProperties": false, "description": "Input for bulk updating tags on PostHog definitions." }, "outputSchema": { "type": "object", "properties": { "updated": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Objects whose tags were updated." }, "skipped": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Objects skipped by PostHog during tag update." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": false, "description": "PostHog bulk tag update response." } }, { "id": "posthog.cancel_query", "service": "posthog", "name": "cancel_query", "description": "Cancel a PostHog async query by project ID and query ID.", "requiredScopes": [], "providerPermissions": [ "query:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "query_id": { "type": "string", "minLength": 1, "description": "Asynchronous query identifier returned by PostHog." } }, "additionalProperties": false, "description": "Input for retrieving or cancelling a PostHog asynchronous query." }, "outputSchema": { "type": "object", "properties": { "cancelled": { "type": "boolean", "description": "Whether the cancel request was sent successfully." }, "query_id": { "type": "string", "description": "Asynchronous query identifier." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": false, "description": "Result returned after cancelling a PostHog asynchronous query." } }, { "id": "posthog.copy_dashboard_tile", "service": "posthog", "name": "copy_dashboard_tile", "description": "Copy an existing PostHog dashboard tile to another dashboard.", "requiredScopes": [], "providerPermissions": [ "dashboard:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." }, "fromDashboardId": { "type": "integer", "description": "Dashboard ID the tile currently belongs to." }, "tileId": { "type": "integer", "description": "Dashboard tile ID to copy." } }, "additionalProperties": false, "description": "Input for copying a PostHog dashboard tile to another dashboard." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric dashboard identifier." }, "name": { "anyOf": [ { "type": "string", "description": "Dashboard name." }, { "type": "null" } ] }, "description": { "type": "string", "description": "Dashboard description." }, "pinned": { "type": "boolean", "description": "Whether the dashboard is pinned to the top of the list." }, "created_at": { "type": "string", "description": "Datetime when the dashboard was created." }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "last_accessed_at": { "anyOf": [ { "type": "string", "description": "Datetime when the dashboard was last accessed." }, { "type": "null" } ] }, "last_viewed_at": { "anyOf": [ { "type": "string", "description": "Datetime when the dashboard was last viewed." }, { "type": "null" } ] }, "is_shared": { "type": "boolean", "description": "Whether the dashboard is shared." }, "deleted": { "type": "boolean", "description": "Whether the dashboard is marked as deleted." }, "creation_mode": { "type": "string", "description": "Dashboard creation mode returned by PostHog." }, "filters": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Dashboard filters returned by PostHog." }, { "type": "null" } ] }, "variables": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Dashboard variables returned by PostHog." }, { "type": "null" } ] }, "breakdown_colors": { "description": "Custom color mapping for breakdown values." }, "data_color_theme_id": { "anyOf": [ { "type": "number", "description": "Color theme ID used for chart visualizations." }, { "type": "null" } ] }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the dashboard." }, "restriction_level": { "type": "integer", "description": "Dashboard restriction level." }, "effective_restriction_level": { "type": "integer", "description": "Effective restriction level for the current user." }, "effective_privilege_level": { "type": "integer", "description": "Effective privilege level for the current user." }, "user_access_level": { "anyOf": [ { "type": "string", "description": "Effective user access level for the dashboard." }, { "type": "null" } ] }, "access_control_version": { "type": "string", "description": "Dashboard access control version." }, "last_refresh": { "anyOf": [ { "type": "string", "description": "Datetime when the dashboard last refreshed." }, { "type": "null" } ] }, "persisted_filters": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Persisted dashboard filters." }, { "type": "null" } ] }, "persisted_variables": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Persisted dashboard variables." }, { "type": "null" } ] }, "team_id": { "type": "integer", "description": "Project or team ID this dashboard belongs to." }, "quick_filter_ids": { "anyOf": [ { "type": "array", "items": { "type": "string", "description": "Quick filter ID." }, "description": "Quick filter IDs associated with this dashboard." }, { "type": "null" } ] }, "tiles": { "anyOf": [ { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, "description": "Dashboard tile payloads returned by PostHog." }, { "type": "null" } ] }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": true, "required": [ "id", "raw" ], "description": "PostHog dashboard with a stable top-level connector shape." } }, { "id": "posthog.create_annotation", "service": "posthog", "name": "create_annotation", "description": "Create an annotation in a PostHog project.", "requiredScopes": [], "providerPermissions": [ "annotation:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "content": { "anyOf": [ { "type": "string", "description": "Annotation text shown on charts." }, { "type": "null" } ] }, "date_marker": { "anyOf": [ { "type": "string", "description": "ISO 8601 timestamp when this annotation happened." }, { "type": "null" } ] }, "creation_type": { "type": "string", "enum": [ "USR", "GIT" ], "description": "Annotation creation type." }, "dashboard_item": { "anyOf": [ { "type": "number", "description": "Dashboard tile or insight identifier attached to the annotation." }, { "type": "null" } ] }, "dashboard_id": { "anyOf": [ { "type": "number", "description": "Dashboard identifier attached to the annotation." }, { "type": "null" } ] }, "deleted": { "type": "boolean", "description": "Whether the annotation should be marked as deleted." }, "scope": { "type": "string", "enum": [ "dashboard_item", "dashboard", "project", "organization" ], "description": "Annotation visibility scope." } }, "additionalProperties": false, "required": [ "project_id" ], "description": "Input for creating a PostHog annotation." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric annotation identifier." }, "content": { "anyOf": [ { "type": "string", "description": "Annotation text shown on charts." }, { "type": "null" } ] }, "date_marker": { "anyOf": [ { "type": "string", "description": "ISO 8601 timestamp when this annotation happened." }, { "type": "null" } ] }, "creation_type": { "type": "string", "description": "Annotation creation type returned by PostHog." }, "dashboard_item": { "anyOf": [ { "type": "number", "description": "Dashboard tile or insight identifier attached to the annotation." }, { "type": "null" } ] }, "dashboard_id": { "anyOf": [ { "type": "number", "description": "Dashboard identifier attached to the annotation." }, { "type": "null" } ] }, "dashboard_name": { "anyOf": [ { "type": "string", "description": "Dashboard name attached to the annotation." }, { "type": "null" } ] }, "insight_short_id": { "anyOf": [ { "type": "string", "description": "Insight short ID attached to the annotation." }, { "type": "null" } ] }, "insight_name": { "anyOf": [ { "type": "string", "description": "Insight name attached to the annotation." }, { "type": "null" } ] }, "insight_derived_name": { "anyOf": [ { "type": "string", "description": "Derived insight name attached to the annotation." }, { "type": "null" } ] }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "created_at": { "anyOf": [ { "type": "string", "description": "Datetime when the annotation was created." }, { "type": "null" } ] }, "updated_at": { "type": "string", "description": "Datetime when the annotation was updated." }, "deleted": { "type": "boolean", "description": "Whether the annotation is marked as deleted." }, "scope": { "type": "string", "description": "Annotation visibility scope." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": true, "required": [ "id", "raw" ], "description": "PostHog annotation." } }, { "id": "posthog.create_cohort", "service": "posthog", "name": "create_cohort", "description": "Create a cohort in a PostHog project.", "requiredScopes": [], "providerPermissions": [ "cohort:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "name": { "anyOf": [ { "type": "string", "maxLength": 400, "description": "Cohort name." }, { "type": "null" } ] }, "description": { "type": "string", "maxLength": 1000, "description": "Description for the cohort." }, "groups": { "description": "Group configuration defining cohort criteria." }, "deleted": { "type": "boolean", "description": "Whether the cohort should be marked as deleted." }, "filters": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, { "type": "null" } ] }, "query": { "anyOf": [ { "description": "Query payload defining this cohort." }, { "type": "null" } ] }, "is_static": { "type": "boolean", "description": "Whether the cohort is static." }, "_create_in_folder": { "type": "string", "description": "Folder identifier where PostHog should create the cohort." }, "_create_static_person_ids": { "type": "array", "items": { "type": "string", "description": "Person UUID." }, "description": "Person UUIDs to seed when creating a static cohort.", "minItems": 1 } }, "additionalProperties": false, "required": [ "project_id", "name" ], "description": "Input for creating a PostHog cohort." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric cohort identifier." }, "name": { "anyOf": [ { "type": "string", "description": "Cohort name." }, { "type": "null" } ] }, "description": { "type": "string", "description": "Description for the cohort." }, "groups": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Raw group configuration returned by PostHog." }, "deleted": { "type": "boolean", "description": "Whether the cohort is marked as deleted." }, "filters": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Cohort filters returned by PostHog." }, { "type": "null" } ] }, "query": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Query payload returned by PostHog for this cohort." }, { "type": "null" } ] }, "version": { "anyOf": [ { "type": "number", "description": "Current cohort version." }, { "type": "null" } ] }, "pending_version": { "anyOf": [ { "type": "number", "description": "Pending cohort version." }, { "type": "null" } ] }, "is_calculating": { "type": "boolean", "description": "Whether the cohort is being recalculated." }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "created_at": { "anyOf": [ { "type": "string", "description": "Datetime when the cohort was created." }, { "type": "null" } ] }, "last_calculation": { "anyOf": [ { "type": "string", "description": "Datetime when the cohort was last calculated." }, { "type": "null" } ] }, "last_backfill_person_properties_at": { "anyOf": [ { "type": "string", "description": "Datetime when person properties were last backfilled." }, { "type": "null" } ] }, "errors_calculating": { "type": "number", "description": "Number of calculation errors recorded for the cohort." }, "last_error_message": { "anyOf": [ { "type": "string", "description": "Most recent cohort calculation error message." }, { "type": "null" } ] }, "count": { "anyOf": [ { "type": "number", "description": "Number of persons in the cohort." }, { "type": "null" } ] }, "is_static": { "type": "boolean", "description": "Whether the cohort is static." }, "cohort_type": { "anyOf": [ { "type": "string", "description": "Cohort type classified by PostHog." }, { "type": "null" } ] }, "experiment_set": { "type": "array", "items": { "type": "number", "description": "Experiment identifier." }, "description": "Experiment IDs attached to the cohort." } }, "additionalProperties": true, "required": [ "id" ], "description": "PostHog cohort." } }, { "id": "posthog.create_dashboard", "service": "posthog", "name": "create_dashboard", "description": "Create a PostHog dashboard in a project.", "requiredScopes": [], "providerPermissions": [ "dashboard:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "name": { "anyOf": [ { "type": "string", "maxLength": 400, "description": "Dashboard name." }, { "type": "null" } ] }, "description": { "type": "string", "description": "Dashboard description." }, "pinned": { "type": "boolean", "description": "Whether the dashboard should be pinned to the top of the list." }, "deleted": { "type": "boolean", "description": "Whether the dashboard should be marked as deleted." }, "breakdown_colors": { "description": "Custom color mapping for breakdown values." }, "data_color_theme_id": { "anyOf": [ { "type": "integer", "description": "Color theme ID used for chart visualizations." }, { "type": "null" } ] }, "tags": { "type": "array", "items": { "type": "string", "description": "Dashboard tag." }, "description": "Tags attached to the dashboard." }, "restriction_level": { "type": "integer", "description": "Dashboard restriction level." }, "quick_filter_ids": { "anyOf": [ { "type": "array", "items": { "type": "string", "description": "Quick filter ID." }, "description": "Quick filter IDs associated with this dashboard." }, { "type": "null" } ] }, "use_template": { "type": "string", "description": "Template key to create the dashboard from a predefined template." }, "use_dashboard": { "anyOf": [ { "type": "integer", "description": "ID of an existing dashboard to duplicate." }, { "type": "null" } ] }, "delete_insights": { "type": "boolean", "description": "Whether PostHog should also delete insights that are only on this dashboard." }, "_create_in_folder": { "type": "string", "description": "Folder identifier where PostHog should create the dashboard." } }, "additionalProperties": false, "required": [ "project_id" ], "description": "Input for creating a PostHog dashboard." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric dashboard identifier." }, "name": { "anyOf": [ { "type": "string", "description": "Dashboard name." }, { "type": "null" } ] }, "description": { "type": "string", "description": "Dashboard description." }, "pinned": { "type": "boolean", "description": "Whether the dashboard is pinned to the top of the list." }, "created_at": { "type": "string", "description": "Datetime when the dashboard was created." }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "last_accessed_at": { "anyOf": [ { "type": "string", "description": "Datetime when the dashboard was last accessed." }, { "type": "null" } ] }, "last_viewed_at": { "anyOf": [ { "type": "string", "description": "Datetime when the dashboard was last viewed." }, { "type": "null" } ] }, "is_shared": { "type": "boolean", "description": "Whether the dashboard is shared." }, "deleted": { "type": "boolean", "description": "Whether the dashboard is marked as deleted." }, "creation_mode": { "type": "string", "description": "Dashboard creation mode returned by PostHog." }, "filters": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Dashboard filters returned by PostHog." }, { "type": "null" } ] }, "variables": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Dashboard variables returned by PostHog." }, { "type": "null" } ] }, "breakdown_colors": { "description": "Custom color mapping for breakdown values." }, "data_color_theme_id": { "anyOf": [ { "type": "number", "description": "Color theme ID used for chart visualizations." }, { "type": "null" } ] }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the dashboard." }, "restriction_level": { "type": "integer", "description": "Dashboard restriction level." }, "effective_restriction_level": { "type": "integer", "description": "Effective restriction level for the current user." }, "effective_privilege_level": { "type": "integer", "description": "Effective privilege level for the current user." }, "user_access_level": { "anyOf": [ { "type": "string", "description": "Effective user access level for the dashboard." }, { "type": "null" } ] }, "access_control_version": { "type": "string", "description": "Dashboard access control version." }, "last_refresh": { "anyOf": [ { "type": "string", "description": "Datetime when the dashboard last refreshed." }, { "type": "null" } ] }, "persisted_filters": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Persisted dashboard filters." }, { "type": "null" } ] }, "persisted_variables": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Persisted dashboard variables." }, { "type": "null" } ] }, "team_id": { "type": "integer", "description": "Project or team ID this dashboard belongs to." }, "quick_filter_ids": { "anyOf": [ { "type": "array", "items": { "type": "string", "description": "Quick filter ID." }, "description": "Quick filter IDs associated with this dashboard." }, { "type": "null" } ] }, "tiles": { "anyOf": [ { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, "description": "Dashboard tile payloads returned by PostHog." }, { "type": "null" } ] }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": true, "required": [ "id", "raw" ], "description": "PostHog dashboard with a stable top-level connector shape." } }, { "id": "posthog.create_event_definition", "service": "posthog", "name": "create_event_definition", "description": "Create an event definition for a PostHog project.", "requiredScopes": [], "providerPermissions": [ "event_definition:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "name": { "type": "string", "maxLength": 400, "description": "Event definition name." }, "owner": { "anyOf": [ { "type": "integer", "description": "Owner user ID." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "Description for the event definition." }, { "type": "null" } ] }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the event definition." }, "verified": { "type": "boolean", "description": "Whether the event definition is verified." }, "hidden": { "anyOf": [ { "type": "boolean", "description": "Whether the event definition is hidden." }, { "type": "null" } ] }, "enforcement_mode": { "type": "string", "description": "Enforcement mode for this event definition." }, "primary_property": { "anyOf": [ { "type": "string", "description": "Primary property displayed alongside this event." }, { "type": "null" } ] }, "post_to_slack": { "type": "boolean", "description": "Whether new events should post to Slack." }, "default_columns": { "type": "array", "items": { "type": "string", "description": "Default column name." }, "description": "Default columns configured for this event definition." } }, "additionalProperties": false, "required": [ "project_id", "name" ], "description": "Input for creating a PostHog event definition." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "string", "description": "Event definition UUID." }, "name": { "type": "string", "description": "Event definition name." }, "owner": { "anyOf": [ { "type": "number", "description": "Owner user ID." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "Description for the event definition." }, { "type": "null" } ] }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the event definition." }, "created_at": { "anyOf": [ { "type": "string", "description": "Creation datetime for the event definition." }, { "type": "null" } ] }, "updated_at": { "type": "string", "description": "Update datetime for the event definition." }, "updated_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "last_seen_at": { "anyOf": [ { "type": "string", "description": "Datetime when the event was last seen." }, { "type": "null" } ] }, "last_updated_at": { "type": "string", "description": "Datetime of the last upstream update." }, "verified": { "type": "boolean", "description": "Whether the event definition is verified." }, "verified_at": { "anyOf": [ { "type": "string", "description": "Datetime when the event definition was verified." }, { "type": "null" } ] }, "verified_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "hidden": { "anyOf": [ { "type": "boolean", "description": "Whether the event definition is hidden." }, { "type": "null" } ] }, "enforcement_mode": { "type": "string", "description": "Enforcement mode for this event definition." }, "primary_property": { "anyOf": [ { "type": "string", "description": "Primary property displayed alongside this event." }, { "type": "null" } ] }, "is_action": { "type": "boolean", "description": "Whether the definition represents an action." }, "action_id": { "type": "number", "description": "Action ID if this definition is an action." }, "is_calculating": { "type": "boolean", "description": "Whether PostHog is calculating related metadata." }, "last_calculated_at": { "type": "string", "description": "Last calculation datetime." }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "post_to_slack": { "type": "boolean", "description": "Whether new events post to Slack." }, "default_columns": { "type": "array", "items": { "type": "string", "description": "Default column name." }, "description": "Default columns configured for this event definition." }, "media_preview_urls": { "type": "array", "items": { "type": "string", "description": "Media preview URL." }, "description": "Media preview URLs returned by PostHog." } }, "additionalProperties": true, "required": [ "id", "name" ], "description": "PostHog event definition." } }, { "id": "posthog.create_feature_flag", "service": "posthog", "name": "create_feature_flag", "description": "Create a feature flag in a PostHog project.", "requiredScopes": [], "providerPermissions": [ "feature_flag:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "key": { "type": "string", "description": "Feature flag key." }, "name": { "type": "string", "description": "Feature flag description." }, "filters": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Feature flag filters returned by PostHog." }, { "type": "null" } ] }, "active": { "type": "boolean", "description": "Whether the feature flag is active." }, "tags": { "type": "array", "items": { "type": "string", "description": "Feature flag tag." }, "description": "Tags attached to the feature flag." }, "evaluation_contexts": { "type": "array", "items": { "type": "string", "description": "Evaluation context." }, "description": "Evaluation contexts attached to the feature flag." } }, "additionalProperties": false, "required": [ "project_id", "key", "name" ], "description": "Input for creating a PostHog feature flag." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "integer", "description": "Feature flag identifier." }, "key": { "type": "string", "description": "Feature flag key." }, "name": { "type": "string", "description": "Feature flag description." }, "active": { "type": "boolean", "description": "Whether the feature flag is active." }, "deleted": { "type": "boolean", "description": "Whether the feature flag is marked as deleted." }, "filters": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Feature flag filters returned by PostHog." }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the feature flag." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." }, "created_at": { "anyOf": [ { "type": "string", "description": "Feature flag creation datetime." }, { "type": "null" } ] }, "updated_at": { "anyOf": [ { "type": "string", "description": "Feature flag update datetime." }, { "type": "null" } ] }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "last_modified_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "version": { "anyOf": [ { "type": "number", "description": "Feature flag version." }, { "type": "null" } ] }, "ensure_experience_continuity": { "anyOf": [ { "type": "boolean", "description": "Whether experience continuity is enabled for the feature flag." }, { "type": "null" } ] }, "experiment_set": { "type": "array", "items": { "type": "integer", "description": "Experiment ID." }, "description": "Associated experiment IDs." }, "experiment_set_metadata": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, "description": "Associated experiment metadata objects." }, "surveys": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Survey metadata attached to the feature flag." }, { "type": "null" } ] }, "features": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Early access feature metadata attached to the flag." }, { "type": "null" } ] }, "rollback_conditions": { "anyOf": [ { "description": "Rollback conditions for the feature flag." }, { "type": "null" } ] }, "performed_rollback": { "anyOf": [ { "type": "boolean", "description": "Whether a rollback has been performed." }, { "type": "null" } ] }, "can_edit": { "anyOf": [ { "type": "boolean", "description": "Whether the current user can edit the feature flag." }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string", "description": "Computed feature flag status." }, { "type": "null" } ] }, "evaluation_runtime": { "anyOf": [ { "type": "string", "description": "Where the feature flag is evaluated." }, { "type": "null" } ] }, "bucketing_identifier": { "anyOf": [ { "type": "string", "description": "Identifier used for bucketing users." }, { "type": "null" } ] }, "last_called_at": { "anyOf": [ { "type": "string", "description": "Last time the feature flag was evaluated." }, { "type": "null" } ] }, "user_access_level": { "anyOf": [ { "type": "string", "description": "Effective access level for the current user." }, { "type": "null" } ] }, "rollout_percentage": { "anyOf": [ { "type": "number", "description": "Feature flag rollout percentage, when present." }, { "type": "null" } ] }, "evaluation_contexts": { "type": "array", "items": { "type": "string", "description": "Evaluation context." }, "description": "Evaluation contexts attached to the feature flag." }, "usage_dashboard": { "anyOf": [ { "type": "number", "description": "Usage dashboard identifier." }, { "type": "null" } ] }, "analytics_dashboards": { "type": "array", "items": { "type": "integer", "description": "Dashboard identifier." }, "description": "Analytics dashboard identifiers attached to the feature flag." }, "has_enriched_analytics": { "anyOf": [ { "type": "boolean", "description": "Whether analytics have been enriched." }, { "type": "null" } ] }, "is_remote_configuration": { "anyOf": [ { "type": "boolean", "description": "Whether the flag is a remote configuration." }, { "type": "null" } ] }, "has_encrypted_payloads": { "anyOf": [ { "type": "boolean", "description": "Whether the flag has encrypted payloads." }, { "type": "null" } ] }, "is_used_in_replay_settings": { "anyOf": [ { "type": "boolean", "description": "Whether the flag is used in replay settings." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "key", "name", "active", "deleted", "filters", "tags", "raw" ], "description": "PostHog feature flag with a stable top-level connector shape." } }, { "id": "posthog.create_insight", "service": "posthog", "name": "create_insight", "description": "Create a saved PostHog insight in a project.", "requiredScopes": [], "providerPermissions": [ "insight:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "name": { "anyOf": [ { "type": "string", "description": "Insight name." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "Insight description." }, { "type": "null" } ] }, "query": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, { "type": "null" } ] }, "filters": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, { "type": "null" } ] }, "dashboards": { "type": "array", "items": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." }, "description": "Dashboard IDs referencing the insight." }, "tags": { "type": "array", "items": { "type": "string", "description": "Insight tag." }, "description": "Tags attached to the insight." }, "refresh": { "anyOf": [ { "type": "string", "enum": [ "async", "async_except_on_cache_miss", "blocking", "force_async", "force_blocking", "force_cache", "lazy_async" ], "description": "Refresh mode used by the PostHog API." }, { "type": "null" } ] }, "saved": { "anyOf": [ { "type": "boolean", "description": "Whether the insight should be saved." }, { "type": "null" } ] }, "favorited": { "anyOf": [ { "type": "boolean", "description": "Whether the insight should be favorited." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "project_id" ], "description": "Input for creating a PostHog insight." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric insight identifier." }, "short_id": { "type": "string", "description": "Short insight identifier." }, "name": { "anyOf": [ { "type": "string", "description": "Insight name." }, { "type": "null" } ] }, "query": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, { "type": "null" } ] }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": true, "description": "PostHog insight with a stable connector shape." } }, { "id": "posthog.delete_annotation", "service": "posthog", "name": "delete_annotation", "description": "Mark a PostHog annotation as deleted using the official soft-delete contract.", "requiredScopes": [], "providerPermissions": [ "annotation:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." } }, "additionalProperties": false, "description": "Input for a PostHog annotation." }, "outputSchema": { "type": "object", "properties": { "deleted": { "type": "boolean", "description": "Whether the annotation was marked as deleted." }, "id": { "type": "string", "description": "Deleted annotation identifier." }, "annotation": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric annotation identifier." }, "content": { "anyOf": [ { "type": "string", "description": "Annotation text shown on charts." }, { "type": "null" } ] }, "date_marker": { "anyOf": [ { "type": "string", "description": "ISO 8601 timestamp when this annotation happened." }, { "type": "null" } ] }, "creation_type": { "type": "string", "description": "Annotation creation type returned by PostHog." }, "dashboard_item": { "anyOf": [ { "type": "number", "description": "Dashboard tile or insight identifier attached to the annotation." }, { "type": "null" } ] }, "dashboard_id": { "anyOf": [ { "type": "number", "description": "Dashboard identifier attached to the annotation." }, { "type": "null" } ] }, "dashboard_name": { "anyOf": [ { "type": "string", "description": "Dashboard name attached to the annotation." }, { "type": "null" } ] }, "insight_short_id": { "anyOf": [ { "type": "string", "description": "Insight short ID attached to the annotation." }, { "type": "null" } ] }, "insight_name": { "anyOf": [ { "type": "string", "description": "Insight name attached to the annotation." }, { "type": "null" } ] }, "insight_derived_name": { "anyOf": [ { "type": "string", "description": "Derived insight name attached to the annotation." }, { "type": "null" } ] }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "created_at": { "anyOf": [ { "type": "string", "description": "Datetime when the annotation was created." }, { "type": "null" } ] }, "updated_at": { "type": "string", "description": "Datetime when the annotation was updated." }, "deleted": { "type": "boolean", "description": "Whether the annotation is marked as deleted." }, "scope": { "type": "string", "description": "Annotation visibility scope." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": true, "required": [ "id", "raw" ], "description": "PostHog annotation." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": false, "description": "Result returned after marking a PostHog annotation as deleted." } }, { "id": "posthog.delete_cohort", "service": "posthog", "name": "delete_cohort", "description": "Mark a PostHog cohort as deleted using the official soft-delete contract.", "requiredScopes": [], "providerPermissions": [ "cohort:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." } }, "additionalProperties": false, "description": "Input for deleting a PostHog cohort." }, "outputSchema": { "type": "object", "properties": { "deleted": { "type": "boolean", "description": "Whether the cohort was marked as deleted." }, "id": { "type": "string", "description": "Deleted cohort identifier." }, "cohort": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric cohort identifier." }, "name": { "anyOf": [ { "type": "string", "description": "Cohort name." }, { "type": "null" } ] }, "description": { "type": "string", "description": "Description for the cohort." }, "groups": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Raw group configuration returned by PostHog." }, "deleted": { "type": "boolean", "description": "Whether the cohort is marked as deleted." }, "filters": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Cohort filters returned by PostHog." }, { "type": "null" } ] }, "query": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Query payload returned by PostHog for this cohort." }, { "type": "null" } ] }, "version": { "anyOf": [ { "type": "number", "description": "Current cohort version." }, { "type": "null" } ] }, "pending_version": { "anyOf": [ { "type": "number", "description": "Pending cohort version." }, { "type": "null" } ] }, "is_calculating": { "type": "boolean", "description": "Whether the cohort is being recalculated." }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "created_at": { "anyOf": [ { "type": "string", "description": "Datetime when the cohort was created." }, { "type": "null" } ] }, "last_calculation": { "anyOf": [ { "type": "string", "description": "Datetime when the cohort was last calculated." }, { "type": "null" } ] }, "last_backfill_person_properties_at": { "anyOf": [ { "type": "string", "description": "Datetime when person properties were last backfilled." }, { "type": "null" } ] }, "errors_calculating": { "type": "number", "description": "Number of calculation errors recorded for the cohort." }, "last_error_message": { "anyOf": [ { "type": "string", "description": "Most recent cohort calculation error message." }, { "type": "null" } ] }, "count": { "anyOf": [ { "type": "number", "description": "Number of persons in the cohort." }, { "type": "null" } ] }, "is_static": { "type": "boolean", "description": "Whether the cohort is static." }, "cohort_type": { "anyOf": [ { "type": "string", "description": "Cohort type classified by PostHog." }, { "type": "null" } ] }, "experiment_set": { "type": "array", "items": { "type": "number", "description": "Experiment identifier." }, "description": "Experiment IDs attached to the cohort." } }, "additionalProperties": true, "required": [ "id" ], "description": "PostHog cohort." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": false, "description": "Result returned after marking a PostHog cohort as deleted." } }, { "id": "posthog.delete_dashboard", "service": "posthog", "name": "delete_dashboard", "description": "Mark a PostHog dashboard as deleted using the official soft-delete contract.", "requiredScopes": [], "providerPermissions": [ "dashboard:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." }, "delete_insights": { "type": "boolean", "description": "Whether PostHog should also delete insights that are only on this dashboard." } }, "additionalProperties": false, "description": "Input for deleting a PostHog dashboard." }, "outputSchema": { "type": "object", "properties": { "deleted": { "type": "boolean", "description": "Whether the dashboard was marked as deleted." }, "id": { "type": "string", "description": "Deleted dashboard identifier." }, "dashboard": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric dashboard identifier." }, "name": { "anyOf": [ { "type": "string", "description": "Dashboard name." }, { "type": "null" } ] }, "description": { "type": "string", "description": "Dashboard description." }, "pinned": { "type": "boolean", "description": "Whether the dashboard is pinned to the top of the list." }, "created_at": { "type": "string", "description": "Datetime when the dashboard was created." }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "last_accessed_at": { "anyOf": [ { "type": "string", "description": "Datetime when the dashboard was last accessed." }, { "type": "null" } ] }, "last_viewed_at": { "anyOf": [ { "type": "string", "description": "Datetime when the dashboard was last viewed." }, { "type": "null" } ] }, "is_shared": { "type": "boolean", "description": "Whether the dashboard is shared." }, "deleted": { "type": "boolean", "description": "Whether the dashboard is marked as deleted." }, "creation_mode": { "type": "string", "description": "Dashboard creation mode returned by PostHog." }, "filters": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Dashboard filters returned by PostHog." }, { "type": "null" } ] }, "variables": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Dashboard variables returned by PostHog." }, { "type": "null" } ] }, "breakdown_colors": { "description": "Custom color mapping for breakdown values." }, "data_color_theme_id": { "anyOf": [ { "type": "number", "description": "Color theme ID used for chart visualizations." }, { "type": "null" } ] }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the dashboard." }, "restriction_level": { "type": "integer", "description": "Dashboard restriction level." }, "effective_restriction_level": { "type": "integer", "description": "Effective restriction level for the current user." }, "effective_privilege_level": { "type": "integer", "description": "Effective privilege level for the current user." }, "user_access_level": { "anyOf": [ { "type": "string", "description": "Effective user access level for the dashboard." }, { "type": "null" } ] }, "access_control_version": { "type": "string", "description": "Dashboard access control version." }, "last_refresh": { "anyOf": [ { "type": "string", "description": "Datetime when the dashboard last refreshed." }, { "type": "null" } ] }, "persisted_filters": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Persisted dashboard filters." }, { "type": "null" } ] }, "persisted_variables": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Persisted dashboard variables." }, { "type": "null" } ] }, "team_id": { "type": "integer", "description": "Project or team ID this dashboard belongs to." }, "quick_filter_ids": { "anyOf": [ { "type": "array", "items": { "type": "string", "description": "Quick filter ID." }, "description": "Quick filter IDs associated with this dashboard." }, { "type": "null" } ] }, "tiles": { "anyOf": [ { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, "description": "Dashboard tile payloads returned by PostHog." }, { "type": "null" } ] }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": true, "required": [ "id", "raw" ], "description": "PostHog dashboard with a stable top-level connector shape." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": false, "description": "Result returned after marking a PostHog dashboard as deleted." } }, { "id": "posthog.delete_event_definition", "service": "posthog", "name": "delete_event_definition", "description": "Delete a PostHog event definition by ID.", "requiredScopes": [], "providerPermissions": [ "event_definition:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." } }, "additionalProperties": false, "description": "Input for a PostHog event definition." }, "outputSchema": { "type": "object", "properties": { "deleted": { "type": "boolean", "description": "Whether the delete request succeeded." }, "id": { "type": "string", "description": "Deleted definition identifier." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": false, "description": "Result returned after deleting a definition." } }, { "id": "posthog.delete_feature_flag", "service": "posthog", "name": "delete_feature_flag", "description": "Soft delete a PostHog feature flag by setting deleted to true.", "requiredScopes": [], "providerPermissions": [ "feature_flag:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." } }, "additionalProperties": false, "description": "Input for deleting a PostHog feature flag." }, "outputSchema": { "type": "object", "properties": { "deleted": { "type": "boolean", "description": "Whether the feature flag was marked as deleted." }, "id": { "type": "string", "description": "Deleted feature flag identifier." }, "feature_flag": { "type": "object", "properties": { "id": { "type": "integer", "description": "Feature flag identifier." }, "key": { "type": "string", "description": "Feature flag key." }, "name": { "type": "string", "description": "Feature flag description." }, "active": { "type": "boolean", "description": "Whether the feature flag is active." }, "deleted": { "type": "boolean", "description": "Whether the feature flag is marked as deleted." }, "filters": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Feature flag filters returned by PostHog." }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the feature flag." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." }, "created_at": { "anyOf": [ { "type": "string", "description": "Feature flag creation datetime." }, { "type": "null" } ] }, "updated_at": { "anyOf": [ { "type": "string", "description": "Feature flag update datetime." }, { "type": "null" } ] }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "last_modified_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "version": { "anyOf": [ { "type": "number", "description": "Feature flag version." }, { "type": "null" } ] }, "ensure_experience_continuity": { "anyOf": [ { "type": "boolean", "description": "Whether experience continuity is enabled for the feature flag." }, { "type": "null" } ] }, "experiment_set": { "type": "array", "items": { "type": "integer", "description": "Experiment ID." }, "description": "Associated experiment IDs." }, "experiment_set_metadata": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, "description": "Associated experiment metadata objects." }, "surveys": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Survey metadata attached to the feature flag." }, { "type": "null" } ] }, "features": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Early access feature metadata attached to the flag." }, { "type": "null" } ] }, "rollback_conditions": { "anyOf": [ { "description": "Rollback conditions for the feature flag." }, { "type": "null" } ] }, "performed_rollback": { "anyOf": [ { "type": "boolean", "description": "Whether a rollback has been performed." }, { "type": "null" } ] }, "can_edit": { "anyOf": [ { "type": "boolean", "description": "Whether the current user can edit the feature flag." }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string", "description": "Computed feature flag status." }, { "type": "null" } ] }, "evaluation_runtime": { "anyOf": [ { "type": "string", "description": "Where the feature flag is evaluated." }, { "type": "null" } ] }, "bucketing_identifier": { "anyOf": [ { "type": "string", "description": "Identifier used for bucketing users." }, { "type": "null" } ] }, "last_called_at": { "anyOf": [ { "type": "string", "description": "Last time the feature flag was evaluated." }, { "type": "null" } ] }, "user_access_level": { "anyOf": [ { "type": "string", "description": "Effective access level for the current user." }, { "type": "null" } ] }, "rollout_percentage": { "anyOf": [ { "type": "number", "description": "Feature flag rollout percentage, when present." }, { "type": "null" } ] }, "evaluation_contexts": { "type": "array", "items": { "type": "string", "description": "Evaluation context." }, "description": "Evaluation contexts attached to the feature flag." }, "usage_dashboard": { "anyOf": [ { "type": "number", "description": "Usage dashboard identifier." }, { "type": "null" } ] }, "analytics_dashboards": { "type": "array", "items": { "type": "integer", "description": "Dashboard identifier." }, "description": "Analytics dashboard identifiers attached to the feature flag." }, "has_enriched_analytics": { "anyOf": [ { "type": "boolean", "description": "Whether analytics have been enriched." }, { "type": "null" } ] }, "is_remote_configuration": { "anyOf": [ { "type": "boolean", "description": "Whether the flag is a remote configuration." }, { "type": "null" } ] }, "has_encrypted_payloads": { "anyOf": [ { "type": "boolean", "description": "Whether the flag has encrypted payloads." }, { "type": "null" } ] }, "is_used_in_replay_settings": { "anyOf": [ { "type": "boolean", "description": "Whether the flag is used in replay settings." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "key", "name", "active", "deleted", "filters", "tags", "raw" ], "description": "PostHog feature flag with a stable top-level connector shape." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": false, "description": "Result returned after soft deleting a PostHog feature flag." } }, { "id": "posthog.delete_insight", "service": "posthog", "name": "delete_insight", "description": "Delete a saved PostHog insight by ID.", "requiredScopes": [], "providerPermissions": [ "insight:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." } }, "additionalProperties": false, "description": "Input for deleting a PostHog insight." }, "outputSchema": { "type": "object", "properties": { "deleted": { "type": "boolean", "description": "Whether the insight was deleted." }, "id": { "type": "string", "description": "Deleted insight identifier." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": false, "description": "Result returned after deleting a PostHog insight." } }, { "id": "posthog.delete_property_definition", "service": "posthog", "name": "delete_property_definition", "description": "Delete a PostHog property definition by ID.", "requiredScopes": [], "providerPermissions": [ "property_definition:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." } }, "additionalProperties": false, "description": "Input for a PostHog property definition." }, "outputSchema": { "type": "object", "properties": { "deleted": { "type": "boolean", "description": "Whether the delete request succeeded." }, "id": { "type": "string", "description": "Deleted definition identifier." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": false, "description": "Result returned after deleting a definition." } }, { "id": "posthog.get_annotation", "service": "posthog", "name": "get_annotation", "description": "Get a PostHog annotation by ID.", "requiredScopes": [], "providerPermissions": [ "annotation:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." } }, "additionalProperties": false, "description": "Input for a PostHog annotation." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric annotation identifier." }, "content": { "anyOf": [ { "type": "string", "description": "Annotation text shown on charts." }, { "type": "null" } ] }, "date_marker": { "anyOf": [ { "type": "string", "description": "ISO 8601 timestamp when this annotation happened." }, { "type": "null" } ] }, "creation_type": { "type": "string", "description": "Annotation creation type returned by PostHog." }, "dashboard_item": { "anyOf": [ { "type": "number", "description": "Dashboard tile or insight identifier attached to the annotation." }, { "type": "null" } ] }, "dashboard_id": { "anyOf": [ { "type": "number", "description": "Dashboard identifier attached to the annotation." }, { "type": "null" } ] }, "dashboard_name": { "anyOf": [ { "type": "string", "description": "Dashboard name attached to the annotation." }, { "type": "null" } ] }, "insight_short_id": { "anyOf": [ { "type": "string", "description": "Insight short ID attached to the annotation." }, { "type": "null" } ] }, "insight_name": { "anyOf": [ { "type": "string", "description": "Insight name attached to the annotation." }, { "type": "null" } ] }, "insight_derived_name": { "anyOf": [ { "type": "string", "description": "Derived insight name attached to the annotation." }, { "type": "null" } ] }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "created_at": { "anyOf": [ { "type": "string", "description": "Datetime when the annotation was created." }, { "type": "null" } ] }, "updated_at": { "type": "string", "description": "Datetime when the annotation was updated." }, "deleted": { "type": "boolean", "description": "Whether the annotation is marked as deleted." }, "scope": { "type": "string", "description": "Annotation visibility scope." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": true, "required": [ "id", "raw" ], "description": "PostHog annotation." } }, { "id": "posthog.get_async_query_status", "service": "posthog", "name": "get_async_query_status", "description": "Retrieve the status and available result payload for a PostHog async query.", "requiredScopes": [], "providerPermissions": [ "query:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "query_id": { "type": "string", "minLength": 1, "description": "Asynchronous query identifier returned by PostHog." } }, "additionalProperties": false, "description": "Input for retrieving or cancelling a PostHog asynchronous query." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "string", "description": "Asynchronous query identifier." }, "query_status": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, "complete": { "type": "boolean", "description": "Whether the asynchronous query has completed." }, "results": { "type": "array", "items": { "description": "Query result row." }, "description": "Rows returned by the query when available." }, "error": { "description": "Query error payload returned by PostHog." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": true, "description": "PostHog asynchronous query status with a stable connector shape." } }, { "id": "posthog.get_cohort", "service": "posthog", "name": "get_cohort", "description": "Get a PostHog cohort by ID.", "requiredScopes": [], "providerPermissions": [ "cohort:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." } }, "additionalProperties": false, "description": "Input for getting a PostHog cohort." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric cohort identifier." }, "name": { "anyOf": [ { "type": "string", "description": "Cohort name." }, { "type": "null" } ] }, "description": { "type": "string", "description": "Description for the cohort." }, "groups": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Raw group configuration returned by PostHog." }, "deleted": { "type": "boolean", "description": "Whether the cohort is marked as deleted." }, "filters": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Cohort filters returned by PostHog." }, { "type": "null" } ] }, "query": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Query payload returned by PostHog for this cohort." }, { "type": "null" } ] }, "version": { "anyOf": [ { "type": "number", "description": "Current cohort version." }, { "type": "null" } ] }, "pending_version": { "anyOf": [ { "type": "number", "description": "Pending cohort version." }, { "type": "null" } ] }, "is_calculating": { "type": "boolean", "description": "Whether the cohort is being recalculated." }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "created_at": { "anyOf": [ { "type": "string", "description": "Datetime when the cohort was created." }, { "type": "null" } ] }, "last_calculation": { "anyOf": [ { "type": "string", "description": "Datetime when the cohort was last calculated." }, { "type": "null" } ] }, "last_backfill_person_properties_at": { "anyOf": [ { "type": "string", "description": "Datetime when person properties were last backfilled." }, { "type": "null" } ] }, "errors_calculating": { "type": "number", "description": "Number of calculation errors recorded for the cohort." }, "last_error_message": { "anyOf": [ { "type": "string", "description": "Most recent cohort calculation error message." }, { "type": "null" } ] }, "count": { "anyOf": [ { "type": "number", "description": "Number of persons in the cohort." }, { "type": "null" } ] }, "is_static": { "type": "boolean", "description": "Whether the cohort is static." }, "cohort_type": { "anyOf": [ { "type": "string", "description": "Cohort type classified by PostHog." }, { "type": "null" } ] }, "experiment_set": { "type": "array", "items": { "type": "number", "description": "Experiment identifier." }, "description": "Experiment IDs attached to the cohort." } }, "additionalProperties": true, "required": [ "id" ], "description": "PostHog cohort." } }, { "id": "posthog.get_cohort_calculation_history", "service": "posthog", "name": "get_cohort_calculation_history", "description": "Get the raw calculation history payload for a PostHog cohort.", "requiredScopes": [], "providerPermissions": [ "cohort:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." } }, "additionalProperties": false, "description": "Input for getting PostHog cohort calculation history." }, "outputSchema": { "type": "object", "properties": { "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": false, "description": "Raw PostHog cohort endpoint payload." } }, { "id": "posthog.get_cohort_persons", "service": "posthog", "name": "get_cohort_persons", "description": "List persons that belong to a PostHog cohort.", "requiredScopes": [], "providerPermissions": [ "cohort:read", "person:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." }, "limit": { "type": "integer", "minimum": 1, "description": "Number of results to return per page." }, "offset": { "type": "integer", "minimum": 0, "description": "Initial index from which to return the results." }, "format": { "type": "string", "enum": [ "json" ], "description": "Response format requested from PostHog." } }, "additionalProperties": false, "required": [ "project_id", "id" ], "description": "Input for listing persons in a PostHog cohort." }, "outputSchema": { "type": "object", "properties": { "next": { "anyOf": [ { "type": "string", "description": "URL for the next page of results, or null when there is no next page." }, { "type": "null" } ] }, "previous": { "anyOf": [ { "type": "string", "description": "URL for the previous page of results, or null when there is no previous page." }, { "type": "null" } ] }, "results": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "description": "Result type returned by PostHog." }, "id": { "type": "string", "description": "Person identifier returned by PostHog." }, "uuid": { "type": "string", "description": "Person UUID returned by PostHog." }, "distinct_ids": { "type": "array", "items": { "type": "string", "description": "Person distinct ID." }, "description": "Distinct IDs associated with this person." }, "properties": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Person properties returned by PostHog." } }, "additionalProperties": true, "description": "Person row returned by PostHog for a cohort." }, "description": "Persons returned by PostHog for this cohort." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": false, "description": "Paginated PostHog cohort person list." } }, { "id": "posthog.get_current_user", "service": "posthog", "name": "get_current_user", "description": "Get the current user associated with the PostHog personal API key.", "requiredScopes": [], "providerPermissions": [ "user:read" ], "inputSchema": { "type": "object", "properties": {}, "additionalProperties": false, "description": "No input is required for the current PostHog user lookup." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "email": { "type": "string", "description": "User email address." }, "pending_email": { "anyOf": [ { "type": "string", "description": "Pending email address awaiting verification." }, { "type": "null" } ] }, "is_email_verified": { "anyOf": [ { "type": "boolean", "description": "Whether the email address is verified." }, { "type": "null" } ] }, "is_staff": { "type": "boolean", "description": "Whether the user has staff access." }, "role_at_organization": { "type": "string", "description": "Declared role for the user within the organization." }, "date_joined": { "type": "string", "description": "Datetime when the user joined PostHog." }, "team": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric team identifier." }, "uuid": { "type": "string", "description": "Team UUID." }, "organization": { "type": "string", "description": "Owning organization UUID." }, "project_id": { "type": "number", "description": "Numeric project identifier." }, "name": { "type": "string", "description": "Team or project name." }, "api_token": { "type": "string", "description": "Project API token." }, "timezone": { "type": "string", "description": "Project timezone." } }, "additionalProperties": true, "required": [ "id" ], "description": "PostHog current team summary." }, { "type": "null" } ] }, "organization": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Organization UUID." }, "name": { "type": "string", "description": "Organization name." }, "slug": { "type": "string", "description": "Organization slug." }, "membership_level": { "anyOf": [ { "type": "number", "description": "Membership level for the current user in this organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "name" ], "description": "PostHog organization summary." }, { "type": "null" } ] }, "organizations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Organization UUID." }, "name": { "type": "string", "description": "Organization name." }, "slug": { "type": "string", "description": "Organization slug." }, "membership_level": { "anyOf": [ { "type": "number", "description": "Membership level for the current user in this organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "name" ], "description": "PostHog organization summary." }, "description": "Organizations accessible to the user." }, "hedgehog_config": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "User hedgehog configuration returned by PostHog." }, { "type": "null" } ] }, "notification_settings": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Notification settings for the user." } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "PostHog current user." }, "followUpActions": [ "posthog.list_projects" ] }, { "id": "posthog.get_dashboard", "service": "posthog", "name": "get_dashboard", "description": "Get a PostHog dashboard by ID with a stable top-level connector shape.", "requiredScopes": [], "providerPermissions": [ "dashboard:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." }, "filters_override": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, { "type": "null" } ] }, "variables_override": { "anyOf": [ { "type": "object", "additionalProperties": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, "description": "Dashboard variable overrides keyed by variable ID." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "project_id", "id" ], "description": "Input for getting a PostHog dashboard." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric dashboard identifier." }, "name": { "anyOf": [ { "type": "string", "description": "Dashboard name." }, { "type": "null" } ] }, "description": { "type": "string", "description": "Dashboard description." }, "pinned": { "type": "boolean", "description": "Whether the dashboard is pinned to the top of the list." }, "created_at": { "type": "string", "description": "Datetime when the dashboard was created." }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "last_accessed_at": { "anyOf": [ { "type": "string", "description": "Datetime when the dashboard was last accessed." }, { "type": "null" } ] }, "last_viewed_at": { "anyOf": [ { "type": "string", "description": "Datetime when the dashboard was last viewed." }, { "type": "null" } ] }, "is_shared": { "type": "boolean", "description": "Whether the dashboard is shared." }, "deleted": { "type": "boolean", "description": "Whether the dashboard is marked as deleted." }, "creation_mode": { "type": "string", "description": "Dashboard creation mode returned by PostHog." }, "filters": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Dashboard filters returned by PostHog." }, { "type": "null" } ] }, "variables": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Dashboard variables returned by PostHog." }, { "type": "null" } ] }, "breakdown_colors": { "description": "Custom color mapping for breakdown values." }, "data_color_theme_id": { "anyOf": [ { "type": "number", "description": "Color theme ID used for chart visualizations." }, { "type": "null" } ] }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the dashboard." }, "restriction_level": { "type": "integer", "description": "Dashboard restriction level." }, "effective_restriction_level": { "type": "integer", "description": "Effective restriction level for the current user." }, "effective_privilege_level": { "type": "integer", "description": "Effective privilege level for the current user." }, "user_access_level": { "anyOf": [ { "type": "string", "description": "Effective user access level for the dashboard." }, { "type": "null" } ] }, "access_control_version": { "type": "string", "description": "Dashboard access control version." }, "last_refresh": { "anyOf": [ { "type": "string", "description": "Datetime when the dashboard last refreshed." }, { "type": "null" } ] }, "persisted_filters": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Persisted dashboard filters." }, { "type": "null" } ] }, "persisted_variables": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Persisted dashboard variables." }, { "type": "null" } ] }, "team_id": { "type": "integer", "description": "Project or team ID this dashboard belongs to." }, "quick_filter_ids": { "anyOf": [ { "type": "array", "items": { "type": "string", "description": "Quick filter ID." }, "description": "Quick filter IDs associated with this dashboard." }, { "type": "null" } ] }, "tiles": { "anyOf": [ { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, "description": "Dashboard tile payloads returned by PostHog." }, { "type": "null" } ] }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": true, "required": [ "id", "raw" ], "description": "PostHog dashboard with a stable top-level connector shape." } }, { "id": "posthog.get_event_definition", "service": "posthog", "name": "get_event_definition", "description": "Get a PostHog event definition by ID.", "requiredScopes": [], "providerPermissions": [ "event_definition:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." } }, "additionalProperties": false, "description": "Input for a PostHog event definition." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "string", "description": "Event definition UUID." }, "name": { "type": "string", "description": "Event definition name." }, "owner": { "anyOf": [ { "type": "number", "description": "Owner user ID." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "Description for the event definition." }, { "type": "null" } ] }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the event definition." }, "created_at": { "anyOf": [ { "type": "string", "description": "Creation datetime for the event definition." }, { "type": "null" } ] }, "updated_at": { "type": "string", "description": "Update datetime for the event definition." }, "updated_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "last_seen_at": { "anyOf": [ { "type": "string", "description": "Datetime when the event was last seen." }, { "type": "null" } ] }, "last_updated_at": { "type": "string", "description": "Datetime of the last upstream update." }, "verified": { "type": "boolean", "description": "Whether the event definition is verified." }, "verified_at": { "anyOf": [ { "type": "string", "description": "Datetime when the event definition was verified." }, { "type": "null" } ] }, "verified_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "hidden": { "anyOf": [ { "type": "boolean", "description": "Whether the event definition is hidden." }, { "type": "null" } ] }, "enforcement_mode": { "type": "string", "description": "Enforcement mode for this event definition." }, "primary_property": { "anyOf": [ { "type": "string", "description": "Primary property displayed alongside this event." }, { "type": "null" } ] }, "is_action": { "type": "boolean", "description": "Whether the definition represents an action." }, "action_id": { "type": "number", "description": "Action ID if this definition is an action." }, "is_calculating": { "type": "boolean", "description": "Whether PostHog is calculating related metadata." }, "last_calculated_at": { "type": "string", "description": "Last calculation datetime." }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "post_to_slack": { "type": "boolean", "description": "Whether new events post to Slack." }, "default_columns": { "type": "array", "items": { "type": "string", "description": "Default column name." }, "description": "Default columns configured for this event definition." }, "media_preview_urls": { "type": "array", "items": { "type": "string", "description": "Media preview URL." }, "description": "Media preview URLs returned by PostHog." } }, "additionalProperties": true, "required": [ "id", "name" ], "description": "PostHog event definition." } }, { "id": "posthog.get_event_definition_by_name", "service": "posthog", "name": "get_event_definition_by_name", "description": "Get a PostHog event definition by exact event name.", "requiredScopes": [], "providerPermissions": [ "event_definition:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "name": { "type": "string", "minLength": 1, "description": "Exact event name to look up." } }, "additionalProperties": false, "description": "Input for getting a PostHog event definition by exact name." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "string", "description": "Event definition UUID." }, "name": { "type": "string", "description": "Event definition name." }, "owner": { "anyOf": [ { "type": "number", "description": "Owner user ID." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "Description for the event definition." }, { "type": "null" } ] }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the event definition." }, "created_at": { "anyOf": [ { "type": "string", "description": "Creation datetime for the event definition." }, { "type": "null" } ] }, "updated_at": { "type": "string", "description": "Update datetime for the event definition." }, "updated_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "last_seen_at": { "anyOf": [ { "type": "string", "description": "Datetime when the event was last seen." }, { "type": "null" } ] }, "last_updated_at": { "type": "string", "description": "Datetime of the last upstream update." }, "verified": { "type": "boolean", "description": "Whether the event definition is verified." }, "verified_at": { "anyOf": [ { "type": "string", "description": "Datetime when the event definition was verified." }, { "type": "null" } ] }, "verified_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "hidden": { "anyOf": [ { "type": "boolean", "description": "Whether the event definition is hidden." }, { "type": "null" } ] }, "enforcement_mode": { "type": "string", "description": "Enforcement mode for this event definition." }, "primary_property": { "anyOf": [ { "type": "string", "description": "Primary property displayed alongside this event." }, { "type": "null" } ] }, "is_action": { "type": "boolean", "description": "Whether the definition represents an action." }, "action_id": { "type": "number", "description": "Action ID if this definition is an action." }, "is_calculating": { "type": "boolean", "description": "Whether PostHog is calculating related metadata." }, "last_calculated_at": { "type": "string", "description": "Last calculation datetime." }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "post_to_slack": { "type": "boolean", "description": "Whether new events post to Slack." }, "default_columns": { "type": "array", "items": { "type": "string", "description": "Default column name." }, "description": "Default columns configured for this event definition." }, "media_preview_urls": { "type": "array", "items": { "type": "string", "description": "Media preview URL." }, "description": "Media preview URLs returned by PostHog." } }, "additionalProperties": true, "required": [ "id", "name" ], "description": "PostHog event definition." } }, { "id": "posthog.get_event_definition_primary_properties", "service": "posthog", "name": "get_event_definition_primary_properties", "description": "Get primary properties configured for PostHog event definitions.", "requiredScopes": [], "providerPermissions": [ "event_definition:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "names": { "type": "array", "items": { "type": "string", "description": "Event name." }, "description": "Event names to restrict the response to.", "minItems": 1 } }, "additionalProperties": false, "required": [ "project_id" ], "description": "Input for getting PostHog event definition primary properties." }, "outputSchema": { "type": "object", "properties": { "results": { "type": "object", "additionalProperties": { "description": "Primary property value returned by PostHog." }, "description": "Primary properties keyed by event name." }, "raw": { "description": "Full raw primary properties payload returned by PostHog." } }, "additionalProperties": false, "description": "Primary properties configured for PostHog event definitions." } }, { "id": "posthog.get_feature_flag", "service": "posthog", "name": "get_feature_flag", "description": "Get a PostHog feature flag by ID.", "requiredScopes": [], "providerPermissions": [ "feature_flag:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." } }, "additionalProperties": false, "description": "Input for getting a PostHog feature flag." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "integer", "description": "Feature flag identifier." }, "key": { "type": "string", "description": "Feature flag key." }, "name": { "type": "string", "description": "Feature flag description." }, "active": { "type": "boolean", "description": "Whether the feature flag is active." }, "deleted": { "type": "boolean", "description": "Whether the feature flag is marked as deleted." }, "filters": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Feature flag filters returned by PostHog." }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the feature flag." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." }, "created_at": { "anyOf": [ { "type": "string", "description": "Feature flag creation datetime." }, { "type": "null" } ] }, "updated_at": { "anyOf": [ { "type": "string", "description": "Feature flag update datetime." }, { "type": "null" } ] }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "last_modified_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "version": { "anyOf": [ { "type": "number", "description": "Feature flag version." }, { "type": "null" } ] }, "ensure_experience_continuity": { "anyOf": [ { "type": "boolean", "description": "Whether experience continuity is enabled for the feature flag." }, { "type": "null" } ] }, "experiment_set": { "type": "array", "items": { "type": "integer", "description": "Experiment ID." }, "description": "Associated experiment IDs." }, "experiment_set_metadata": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, "description": "Associated experiment metadata objects." }, "surveys": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Survey metadata attached to the feature flag." }, { "type": "null" } ] }, "features": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Early access feature metadata attached to the flag." }, { "type": "null" } ] }, "rollback_conditions": { "anyOf": [ { "description": "Rollback conditions for the feature flag." }, { "type": "null" } ] }, "performed_rollback": { "anyOf": [ { "type": "boolean", "description": "Whether a rollback has been performed." }, { "type": "null" } ] }, "can_edit": { "anyOf": [ { "type": "boolean", "description": "Whether the current user can edit the feature flag." }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string", "description": "Computed feature flag status." }, { "type": "null" } ] }, "evaluation_runtime": { "anyOf": [ { "type": "string", "description": "Where the feature flag is evaluated." }, { "type": "null" } ] }, "bucketing_identifier": { "anyOf": [ { "type": "string", "description": "Identifier used for bucketing users." }, { "type": "null" } ] }, "last_called_at": { "anyOf": [ { "type": "string", "description": "Last time the feature flag was evaluated." }, { "type": "null" } ] }, "user_access_level": { "anyOf": [ { "type": "string", "description": "Effective access level for the current user." }, { "type": "null" } ] }, "rollout_percentage": { "anyOf": [ { "type": "number", "description": "Feature flag rollout percentage, when present." }, { "type": "null" } ] }, "evaluation_contexts": { "type": "array", "items": { "type": "string", "description": "Evaluation context." }, "description": "Evaluation contexts attached to the feature flag." }, "usage_dashboard": { "anyOf": [ { "type": "number", "description": "Usage dashboard identifier." }, { "type": "null" } ] }, "analytics_dashboards": { "type": "array", "items": { "type": "integer", "description": "Dashboard identifier." }, "description": "Analytics dashboard identifiers attached to the feature flag." }, "has_enriched_analytics": { "anyOf": [ { "type": "boolean", "description": "Whether analytics have been enriched." }, { "type": "null" } ] }, "is_remote_configuration": { "anyOf": [ { "type": "boolean", "description": "Whether the flag is a remote configuration." }, { "type": "null" } ] }, "has_encrypted_payloads": { "anyOf": [ { "type": "boolean", "description": "Whether the flag has encrypted payloads." }, { "type": "null" } ] }, "is_used_in_replay_settings": { "anyOf": [ { "type": "boolean", "description": "Whether the flag is used in replay settings." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "key", "name", "active", "deleted", "filters", "tags", "raw" ], "description": "PostHog feature flag with a stable top-level connector shape." } }, { "id": "posthog.get_feature_flag_dependent_flags", "service": "posthog", "name": "get_feature_flag_dependent_flags", "description": "List the feature flags that depend on a PostHog feature flag.", "requiredScopes": [], "providerPermissions": [ "feature_flag:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." } }, "additionalProperties": false, "description": "Input for deleting a PostHog feature flag." }, "outputSchema": { "type": "object", "properties": { "results": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "Feature flag identifier." }, "key": { "type": "string", "description": "Feature flag key." }, "name": { "type": "string", "description": "Feature flag name." } }, "additionalProperties": true, "description": "PostHog dependent feature flag summary." }, "description": "Dependent feature flags returned by PostHog." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": false, "description": "Dependent feature flags returned by PostHog." } }, { "id": "posthog.get_feature_flag_status", "service": "posthog", "name": "get_feature_flag_status", "description": "Get the computed status for a PostHog feature flag.", "requiredScopes": [], "providerPermissions": [ "feature_flag:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." } }, "additionalProperties": false, "description": "Input for deleting a PostHog feature flag." }, "outputSchema": { "type": "object", "properties": { "status": { "type": "string", "description": "Computed feature flag status." }, "reason": { "type": "string", "description": "Human-readable explanation of the feature flag status." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." }, "active": { "anyOf": [ { "type": "boolean", "description": "Whether the feature flag is active." }, { "type": "null" } ] }, "deleted": { "anyOf": [ { "type": "boolean", "description": "Whether the feature flag is deleted." }, { "type": "null" } ] }, "last_called_at": { "anyOf": [ { "type": "string", "description": "Last time the feature flag was evaluated." }, { "type": "null" } ] }, "status_code": { "anyOf": [ { "type": "number", "description": "HTTP status code returned by the status endpoint." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "status", "reason", "raw" ], "description": "PostHog feature flag status response." } }, { "id": "posthog.get_feature_flags_local_evaluation", "service": "posthog", "name": "get_feature_flags_local_evaluation", "description": "Get the local evaluation payload for PostHog feature flags.", "requiredScopes": [], "providerPermissions": [ "feature_flag:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "send_cohorts": { "anyOf": [ { "type": "boolean", "description": "Whether to include cohorts in the response." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "project_id" ], "description": "Input for getting the local evaluation payload for PostHog feature flags." }, "outputSchema": { "type": "object", "properties": { "flags": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "Feature flag identifier." }, "team_id": { "type": "integer", "description": "Owning team identifier." }, "name": { "type": "string", "description": "Feature flag description." }, "key": { "type": "string", "description": "Feature flag key." }, "filters": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Feature flag filters returned by PostHog." }, "deleted": { "type": "boolean", "description": "Whether the feature flag is marked as deleted." }, "active": { "type": "boolean", "description": "Whether the feature flag is active." }, "evaluation_contexts": { "type": "array", "items": { "type": "string", "description": "Evaluation context." }, "description": "Evaluation contexts attached to the feature flag." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." }, "ensure_experience_continuity": { "anyOf": [ { "type": "boolean", "description": "Whether experience continuity is enabled for the feature flag." }, { "type": "null" } ] }, "version": { "anyOf": [ { "type": "number", "description": "Feature flag version." }, { "type": "null" } ] }, "evaluation_runtime": { "anyOf": [ { "type": "string", "description": "Where the feature flag is evaluated." }, { "type": "null" } ] }, "bucketing_identifier": { "anyOf": [ { "type": "string", "description": "Identifier used for bucketing users." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "team_id", "name", "key", "filters", "deleted", "active", "evaluation_contexts", "raw" ], "description": "Minimal PostHog feature flag used by local evaluation." }, "description": "Feature flags returned by the local evaluation endpoint." }, "group_type_mapping": { "type": "object", "additionalProperties": { "type": "string", "description": "Group type mapping value." }, "description": "Group type mappings returned by PostHog." }, "cohorts": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Cohorts returned by PostHog for local evaluation." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": false, "description": "PostHog feature flag local evaluation response." } }, { "id": "posthog.get_insight", "service": "posthog", "name": "get_insight", "description": "Get a PostHog insight by ID with a stable top-level connector shape.", "requiredScopes": [], "providerPermissions": [ "insight:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." }, "from_dashboard": { "type": "integer", "description": "Dashboard ID whose filters should override the insight context." }, "refresh": { "type": "string", "enum": [ "async", "async_except_on_cache_miss", "blocking", "force_async", "force_blocking", "force_cache", "lazy_async" ], "description": "Refresh mode used by the PostHog API." } }, "additionalProperties": false, "required": [ "project_id", "id" ], "description": "Input for getting a PostHog insight." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric insight identifier." }, "short_id": { "type": "string", "description": "Short insight identifier." }, "name": { "anyOf": [ { "type": "string", "description": "Insight name." }, { "type": "null" } ] }, "derived_name": { "anyOf": [ { "type": "string", "description": "Derived insight name." }, { "type": "null" } ] }, "query": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Insight query definition returned by PostHog." }, { "type": "null" } ] }, "order": { "anyOf": [ { "type": "number", "description": "Display order for the insight." }, { "type": "null" } ] }, "deleted": { "type": "boolean", "description": "Whether the insight is marked as deleted." }, "dashboards": { "type": "array", "items": { "type": "number", "description": "Dashboard ID." }, "description": "Dashboard IDs referencing the insight." }, "dashboard_tiles": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Dashboard tile summary returned by PostHog." }, "description": "Dashboard tile summaries referencing the insight." }, "last_refresh": { "anyOf": [ { "type": "string", "description": "Datetime when the insight results were last refreshed." }, { "type": "null" } ] }, "cache_target_age": { "anyOf": [ { "type": "string", "description": "Target age timestamp for cached insight results." }, { "type": "null" } ] }, "next_allowed_client_refresh": { "anyOf": [ { "type": "string", "description": "Earliest datetime when a client may refresh the insight." }, { "type": "null" } ] }, "result": { "description": "Insight result payload returned by PostHog." }, "hasMore": { "anyOf": [ { "type": "boolean", "description": "Whether the insight has more result rows." }, { "type": "null" } ] }, "columns": { "anyOf": [ { "type": "array", "items": { "type": "string", "description": "Column name." }, "description": "Column names for the result." }, { "type": "null" } ] }, "created_at": { "anyOf": [ { "type": "string", "description": "Datetime when the insight was created." }, { "type": "null" } ] }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "Insight description." }, { "type": "null" } ] }, "updated_at": { "type": "string", "description": "Datetime when the insight was updated." }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the insight." }, "favorited": { "type": "boolean", "description": "Whether the insight is favorited." }, "last_modified_at": { "type": "string", "description": "Datetime when the insight was last modified." }, "last_modified_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "is_sample": { "type": "boolean", "description": "Whether the insight is a sample insight." }, "effective_restriction_level": { "type": "number", "description": "Effective restriction level for the current user." }, "effective_privilege_level": { "type": "number", "description": "Effective privilege level for the current user." }, "user_access_level": { "anyOf": [ { "type": "string", "description": "Effective user access level for the insight." }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string", "description": "Timezone used to display the insight." }, { "type": "null" } ] }, "is_cached": { "type": "boolean", "description": "Whether the returned insight result is cached." }, "query_status": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Query status returned with the insight." }, { "type": "null" } ] }, "hogql": { "anyOf": [ { "type": "string", "description": "Generated HogQL query for the insight." }, { "type": "null" } ] }, "types": { "anyOf": [ { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Types returned for the insight." }, { "type": "null" } ] }, "resolved_date_range": { "anyOf": [ { "type": "object", "properties": { "date_from": { "type": "string", "description": "Resolved start datetime for the date range." }, "date_to": { "type": "string", "description": "Resolved end datetime for the date range." } }, "additionalProperties": true, "description": "Resolved date range returned by PostHog." }, { "type": "null" } ] }, "alerts": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Alerts attached to the insight." }, "last_viewed_at": { "anyOf": [ { "type": "string", "description": "Datetime when the insight was last viewed." }, { "type": "null" } ] }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw insight payload returned by PostHog." } }, "additionalProperties": true, "required": [ "id", "raw" ], "description": "PostHog insight with a stable top-level connector shape." } }, { "id": "posthog.get_project", "service": "posthog", "name": "get_project", "description": "Get a PostHog project from the current or specified organization.", "requiredScopes": [], "providerPermissions": [ "organization:read", "project:read" ], "inputSchema": { "type": "object", "properties": { "organization_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String organization ID accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric organization ID accepted by the official PostHog API path." } ], "description": "Organization ID. When omitted, the provider falls back to the current organization from the connected user." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." } }, "additionalProperties": false, "required": [ "id" ], "description": "Input for getting a PostHog project." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric project identifier." }, "organization": { "type": "string", "description": "Owning organization UUID." }, "uuid": { "type": "string", "description": "Project UUID." }, "name": { "type": "string", "description": "Project name." }, "api_token": { "type": "string", "description": "Project API token." }, "created_at": { "type": "string", "description": "Project creation datetime." }, "updated_at": { "type": "string", "description": "Project update datetime." }, "product_description": { "anyOf": [ { "type": "string", "description": "Description configured for the product." }, { "type": "null" } ] }, "timezone": { "type": "string", "description": "Project timezone." }, "is_demo": { "type": "boolean", "description": "Whether the project is a demo project." }, "ingested_event": { "type": "boolean", "description": "Whether the project has ingested at least one event." }, "access_control": { "type": "boolean", "description": "Whether access control is enabled." }, "app_urls": { "type": "array", "items": { "anyOf": [ { "type": "string", "description": "Configured application URL." }, { "type": "null" } ] }, "description": "Configured application URLs." }, "group_types": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Configured group type returned by PostHog." }, "description": "Configured group types." }, "product_intents": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Product intent summary returned by PostHog." }, "description": "Product intent summaries for the project." }, "secret_api_token": { "anyOf": [ { "type": "string", "description": "Project secret API token when available." }, { "type": "null" } ] }, "secret_api_token_backup": { "anyOf": [ { "type": "string", "description": "Project secret API token backup when available." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "organization", "uuid", "name" ], "description": "PostHog project." } }, { "id": "posthog.get_property_definition", "service": "posthog", "name": "get_property_definition", "description": "Get a PostHog property definition by ID.", "requiredScopes": [], "providerPermissions": [ "property_definition:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." } }, "additionalProperties": false, "description": "Input for a PostHog property definition." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "string", "description": "Property definition UUID." }, "name": { "type": "string", "description": "Property name." }, "description": { "anyOf": [ { "type": "string", "description": "Description for the property definition." }, { "type": "null" } ] }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the property definition." }, "is_numerical": { "type": "boolean", "description": "Whether the property is numerical." }, "updated_at": { "type": "string", "description": "Datetime when the property definition was updated." }, "updated_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "is_seen_on_filtered_events": { "anyOf": [ { "type": "boolean", "description": "Whether the property was seen on the filtered events." }, { "type": "null" } ] }, "property_type": { "anyOf": [ { "type": "string", "description": "Property type inferred by PostHog." }, { "type": "null" } ] }, "verified": { "type": "boolean", "description": "Whether the property definition is verified." }, "verified_at": { "anyOf": [ { "type": "string", "description": "Datetime when the property definition was verified." }, { "type": "null" } ] }, "verified_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "hidden": { "anyOf": [ { "type": "boolean", "description": "Whether the property definition is hidden." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "name", "is_numerical", "updated_at" ], "description": "PostHog property definition." } }, { "id": "posthog.list_annotations", "service": "posthog", "name": "list_annotations", "description": "List annotations for a PostHog project.", "requiredScopes": [], "providerPermissions": [ "annotation:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "limit": { "type": "integer", "minimum": 1, "description": "Number of results to return per page." }, "offset": { "type": "integer", "minimum": 0, "description": "Initial index from which to return the results." }, "search": { "type": "string", "description": "Search term used to match annotations." } }, "additionalProperties": false, "required": [ "project_id" ], "description": "Input for listing PostHog annotations." }, "outputSchema": { "type": "object", "properties": { "count": { "type": "integer", "description": "Total number of results available." }, "next": { "anyOf": [ { "type": "string", "description": "URL for the next page of results, or null when there is no next page." }, { "type": "null" } ] }, "previous": { "anyOf": [ { "type": "string", "description": "URL for the previous page of results, or null when there is no previous page." }, { "type": "null" } ] }, "results": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric annotation identifier." }, "content": { "anyOf": [ { "type": "string", "description": "Annotation text shown on charts." }, { "type": "null" } ] }, "date_marker": { "anyOf": [ { "type": "string", "description": "ISO 8601 timestamp when this annotation happened." }, { "type": "null" } ] }, "creation_type": { "type": "string", "description": "Annotation creation type returned by PostHog." }, "dashboard_item": { "anyOf": [ { "type": "number", "description": "Dashboard tile or insight identifier attached to the annotation." }, { "type": "null" } ] }, "dashboard_id": { "anyOf": [ { "type": "number", "description": "Dashboard identifier attached to the annotation." }, { "type": "null" } ] }, "dashboard_name": { "anyOf": [ { "type": "string", "description": "Dashboard name attached to the annotation." }, { "type": "null" } ] }, "insight_short_id": { "anyOf": [ { "type": "string", "description": "Insight short ID attached to the annotation." }, { "type": "null" } ] }, "insight_name": { "anyOf": [ { "type": "string", "description": "Insight name attached to the annotation." }, { "type": "null" } ] }, "insight_derived_name": { "anyOf": [ { "type": "string", "description": "Derived insight name attached to the annotation." }, { "type": "null" } ] }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "created_at": { "anyOf": [ { "type": "string", "description": "Datetime when the annotation was created." }, { "type": "null" } ] }, "updated_at": { "type": "string", "description": "Datetime when the annotation was updated." }, "deleted": { "type": "boolean", "description": "Whether the annotation is marked as deleted." }, "scope": { "type": "string", "description": "Annotation visibility scope." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": true, "required": [ "id", "raw" ], "description": "PostHog annotation." }, "description": "Annotations returned by PostHog." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": false, "description": "Paginated PostHog annotation list." } }, { "id": "posthog.list_cohorts", "service": "posthog", "name": "list_cohorts", "description": "List cohorts for a PostHog project.", "requiredScopes": [], "providerPermissions": [ "cohort:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "limit": { "type": "integer", "minimum": 1, "description": "Number of results to return per page." }, "offset": { "type": "integer", "minimum": 0, "description": "Initial index from which to return the results." } }, "additionalProperties": false, "required": [ "project_id" ], "description": "Input for listing PostHog cohorts." }, "outputSchema": { "type": "object", "properties": { "count": { "type": "integer", "description": "Total number of results available." }, "next": { "anyOf": [ { "type": "string", "description": "URL for the next page of results, or null when there is no next page." }, { "type": "null" } ] }, "previous": { "anyOf": [ { "type": "string", "description": "URL for the previous page of results, or null when there is no previous page." }, { "type": "null" } ] }, "results": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric cohort identifier." }, "name": { "anyOf": [ { "type": "string", "description": "Cohort name." }, { "type": "null" } ] }, "description": { "type": "string", "description": "Description for the cohort." }, "groups": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Raw group configuration returned by PostHog." }, "deleted": { "type": "boolean", "description": "Whether the cohort is marked as deleted." }, "filters": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Cohort filters returned by PostHog." }, { "type": "null" } ] }, "query": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Query payload returned by PostHog for this cohort." }, { "type": "null" } ] }, "version": { "anyOf": [ { "type": "number", "description": "Current cohort version." }, { "type": "null" } ] }, "pending_version": { "anyOf": [ { "type": "number", "description": "Pending cohort version." }, { "type": "null" } ] }, "is_calculating": { "type": "boolean", "description": "Whether the cohort is being recalculated." }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "created_at": { "anyOf": [ { "type": "string", "description": "Datetime when the cohort was created." }, { "type": "null" } ] }, "last_calculation": { "anyOf": [ { "type": "string", "description": "Datetime when the cohort was last calculated." }, { "type": "null" } ] }, "last_backfill_person_properties_at": { "anyOf": [ { "type": "string", "description": "Datetime when person properties were last backfilled." }, { "type": "null" } ] }, "errors_calculating": { "type": "number", "description": "Number of calculation errors recorded for the cohort." }, "last_error_message": { "anyOf": [ { "type": "string", "description": "Most recent cohort calculation error message." }, { "type": "null" } ] }, "count": { "anyOf": [ { "type": "number", "description": "Number of persons in the cohort." }, { "type": "null" } ] }, "is_static": { "type": "boolean", "description": "Whether the cohort is static." }, "cohort_type": { "anyOf": [ { "type": "string", "description": "Cohort type classified by PostHog." }, { "type": "null" } ] }, "experiment_set": { "type": "array", "items": { "type": "number", "description": "Experiment identifier." }, "description": "Experiment IDs attached to the cohort." } }, "additionalProperties": true, "required": [ "id" ], "description": "PostHog cohort." }, "description": "Cohorts returned by PostHog." } }, "additionalProperties": false, "description": "Paginated PostHog cohort list." } }, { "id": "posthog.list_dashboard_collaborators", "service": "posthog", "name": "list_dashboard_collaborators", "description": "List collaborators for a PostHog dashboard.", "requiredScopes": [], "providerPermissions": [ "dashboard:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "dashboard_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." } }, "additionalProperties": false, "description": "Input for listing PostHog dashboard collaborators." }, "outputSchema": { "type": "object", "properties": { "results": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Dashboard collaborator UUID." }, "dashboard_id": { "type": "integer", "description": "Dashboard identifier." }, "user": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, "level": { "type": "integer", "description": "Restriction level granted to the collaborator." }, "added_at": { "type": "string", "description": "Datetime when the collaborator was added." }, "updated_at": { "type": "string", "description": "Datetime when the collaborator was updated." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": true, "required": [ "raw" ], "description": "PostHog dashboard collaborator." }, "description": "Dashboard collaborators returned by PostHog." }, "raw": { "description": "Full raw collaborators payload returned by PostHog." } }, "additionalProperties": false, "description": "PostHog dashboard collaborators." } }, { "id": "posthog.list_dashboards", "service": "posthog", "name": "list_dashboards", "description": "List dashboards for a PostHog project.", "requiredScopes": [], "providerPermissions": [ "dashboard:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "limit": { "type": "integer", "minimum": 1, "description": "Number of results to return per page." }, "offset": { "type": "integer", "minimum": 0, "description": "Initial index from which to return the results." }, "search": { "type": "string", "maxLength": 200, "description": "Search term used to match dashboard names and descriptions." } }, "additionalProperties": false, "required": [ "project_id" ], "description": "Input for listing PostHog dashboards." }, "outputSchema": { "type": "object", "properties": { "count": { "type": "integer", "description": "Total number of results available." }, "next": { "anyOf": [ { "type": "string", "description": "URL for the next page of results, or null when there is no next page." }, { "type": "null" } ] }, "previous": { "anyOf": [ { "type": "string", "description": "URL for the previous page of results, or null when there is no previous page." }, { "type": "null" } ] }, "results": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric dashboard identifier." }, "name": { "anyOf": [ { "type": "string", "description": "Dashboard name." }, { "type": "null" } ] }, "description": { "type": "string", "description": "Dashboard description." }, "pinned": { "type": "boolean", "description": "Whether the dashboard is pinned to the top of the list." }, "created_at": { "type": "string", "description": "Datetime when the dashboard was created." }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "last_accessed_at": { "anyOf": [ { "type": "string", "description": "Datetime when the dashboard was last accessed." }, { "type": "null" } ] }, "last_viewed_at": { "anyOf": [ { "type": "string", "description": "Datetime when the dashboard was last viewed." }, { "type": "null" } ] }, "is_shared": { "type": "boolean", "description": "Whether the dashboard is shared." }, "deleted": { "type": "boolean", "description": "Whether the dashboard is marked as deleted." }, "creation_mode": { "type": "string", "description": "Dashboard creation mode returned by PostHog." }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the dashboard." }, "restriction_level": { "type": "integer", "description": "Dashboard restriction level." }, "effective_restriction_level": { "type": "integer", "description": "Effective restriction level for the current user." }, "effective_privilege_level": { "type": "integer", "description": "Effective privilege level for the current user." }, "user_access_level": { "anyOf": [ { "type": "string", "description": "Effective user access level for the dashboard." }, { "type": "null" } ] }, "access_control_version": { "type": "string", "description": "Dashboard access control version." }, "last_refresh": { "anyOf": [ { "type": "string", "description": "Datetime when the dashboard last refreshed." }, { "type": "null" } ] }, "team_id": { "type": "integer", "description": "Project or team ID this dashboard belongs to." } }, "additionalProperties": true, "required": [ "id" ], "description": "PostHog dashboard summary." }, "description": "Dashboards returned by PostHog." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": false, "description": "Paginated PostHog dashboard list." } }, { "id": "posthog.list_event_definitions", "service": "posthog", "name": "list_event_definitions", "description": "List event definitions for a PostHog project.", "requiredScopes": [], "providerPermissions": [ "event_definition:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "limit": { "type": "integer", "minimum": 1, "description": "Number of results to return per page." }, "offset": { "type": "integer", "minimum": 0, "description": "Initial index from which to return the results." } }, "additionalProperties": false, "required": [ "project_id" ], "description": "Input for listing PostHog event definitions." }, "outputSchema": { "type": "object", "properties": { "count": { "type": "integer", "description": "Total number of results available." }, "next": { "anyOf": [ { "type": "string", "description": "URL for the next page of results, or null when there is no next page." }, { "type": "null" } ] }, "previous": { "anyOf": [ { "type": "string", "description": "URL for the previous page of results, or null when there is no previous page." }, { "type": "null" } ] }, "results": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Event definition UUID." }, "name": { "type": "string", "description": "Event definition name." }, "owner": { "anyOf": [ { "type": "number", "description": "Owner user ID." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "Description for the event definition." }, { "type": "null" } ] }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the event definition." }, "created_at": { "anyOf": [ { "type": "string", "description": "Creation datetime for the event definition." }, { "type": "null" } ] }, "updated_at": { "type": "string", "description": "Update datetime for the event definition." }, "updated_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "last_seen_at": { "anyOf": [ { "type": "string", "description": "Datetime when the event was last seen." }, { "type": "null" } ] }, "last_updated_at": { "type": "string", "description": "Datetime of the last upstream update." }, "verified": { "type": "boolean", "description": "Whether the event definition is verified." }, "verified_at": { "anyOf": [ { "type": "string", "description": "Datetime when the event definition was verified." }, { "type": "null" } ] }, "verified_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "hidden": { "anyOf": [ { "type": "boolean", "description": "Whether the event definition is hidden." }, { "type": "null" } ] }, "enforcement_mode": { "type": "string", "description": "Enforcement mode for this event definition." }, "primary_property": { "anyOf": [ { "type": "string", "description": "Primary property displayed alongside this event." }, { "type": "null" } ] }, "is_action": { "type": "boolean", "description": "Whether the definition represents an action." }, "action_id": { "type": "number", "description": "Action ID if this definition is an action." }, "is_calculating": { "type": "boolean", "description": "Whether PostHog is calculating related metadata." }, "last_calculated_at": { "type": "string", "description": "Last calculation datetime." }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "post_to_slack": { "type": "boolean", "description": "Whether new events post to Slack." }, "default_columns": { "type": "array", "items": { "type": "string", "description": "Default column name." }, "description": "Default columns configured for this event definition." }, "media_preview_urls": { "type": "array", "items": { "type": "string", "description": "Media preview URL." }, "description": "Media preview URLs returned by PostHog." } }, "additionalProperties": true, "required": [ "id", "name" ], "description": "PostHog event definition." }, "description": "Event definitions returned by PostHog." } }, "additionalProperties": false, "description": "Paginated PostHog event definition list." } }, { "id": "posthog.list_feature_flags", "service": "posthog", "name": "list_feature_flags", "description": "List feature flags for a PostHog project.", "requiredScopes": [], "providerPermissions": [ "feature_flag:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "active": { "type": "string", "enum": [ "STALE", "false", "true" ], "description": "Filter feature flags by active state." }, "created_by_id": { "type": "string", "description": "User ID that initially created the feature flag." }, "evaluation_runtime": { "type": "string", "enum": [ "both", "client", "server" ], "description": "Filter feature flags by evaluation runtime." }, "excluded_properties": { "type": "string", "description": "JSON-encoded list of feature flag keys to exclude." }, "has_evaluation_contexts": { "type": "string", "enum": [ "false", "true" ], "description": "Filter feature flags by whether they have evaluation contexts." }, "limit": { "type": "integer", "minimum": 1, "description": "Number of results to return per page." }, "offset": { "type": "integer", "minimum": 0, "description": "Initial index from which to return the results." }, "search": { "type": "string", "description": "Search term used to match feature flag keys or names." }, "tags": { "type": "string", "description": "JSON-encoded list of feature flag tags to filter by." }, "type": { "type": "string", "enum": [ "boolean", "experiment", "multivariant", "remote_config" ], "description": "Filter feature flags by type." } }, "additionalProperties": false, "required": [ "project_id" ], "description": "Input for listing PostHog feature flags." }, "outputSchema": { "type": "object", "properties": { "count": { "type": "integer", "description": "Total number of results available." }, "next": { "anyOf": [ { "type": "string", "description": "URL for the next page of results, or null when there is no next page." }, { "type": "null" } ] }, "previous": { "anyOf": [ { "type": "string", "description": "URL for the previous page of results, or null when there is no previous page." }, { "type": "null" } ] }, "results": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "Feature flag identifier." }, "key": { "type": "string", "description": "Feature flag key." }, "name": { "type": "string", "description": "Feature flag description." }, "active": { "type": "boolean", "description": "Whether the feature flag is active." }, "deleted": { "type": "boolean", "description": "Whether the feature flag is marked as deleted." }, "filters": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Feature flag filters returned by PostHog." }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the feature flag." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." }, "created_at": { "anyOf": [ { "type": "string", "description": "Feature flag creation datetime." }, { "type": "null" } ] }, "updated_at": { "anyOf": [ { "type": "string", "description": "Feature flag update datetime." }, { "type": "null" } ] }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "last_modified_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "version": { "anyOf": [ { "type": "number", "description": "Feature flag version." }, { "type": "null" } ] }, "ensure_experience_continuity": { "anyOf": [ { "type": "boolean", "description": "Whether experience continuity is enabled for the feature flag." }, { "type": "null" } ] }, "experiment_set": { "type": "array", "items": { "type": "integer", "description": "Experiment ID." }, "description": "Associated experiment IDs." }, "experiment_set_metadata": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, "description": "Associated experiment metadata objects." }, "surveys": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Survey metadata attached to the feature flag." }, { "type": "null" } ] }, "features": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Early access feature metadata attached to the flag." }, { "type": "null" } ] }, "rollback_conditions": { "anyOf": [ { "description": "Rollback conditions for the feature flag." }, { "type": "null" } ] }, "performed_rollback": { "anyOf": [ { "type": "boolean", "description": "Whether a rollback has been performed." }, { "type": "null" } ] }, "can_edit": { "anyOf": [ { "type": "boolean", "description": "Whether the current user can edit the feature flag." }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string", "description": "Computed feature flag status." }, { "type": "null" } ] }, "evaluation_runtime": { "anyOf": [ { "type": "string", "description": "Where the feature flag is evaluated." }, { "type": "null" } ] }, "bucketing_identifier": { "anyOf": [ { "type": "string", "description": "Identifier used for bucketing users." }, { "type": "null" } ] }, "last_called_at": { "anyOf": [ { "type": "string", "description": "Last time the feature flag was evaluated." }, { "type": "null" } ] }, "user_access_level": { "anyOf": [ { "type": "string", "description": "Effective access level for the current user." }, { "type": "null" } ] }, "rollout_percentage": { "anyOf": [ { "type": "number", "description": "Feature flag rollout percentage, when present." }, { "type": "null" } ] }, "evaluation_contexts": { "type": "array", "items": { "type": "string", "description": "Evaluation context." }, "description": "Evaluation contexts attached to the feature flag." }, "usage_dashboard": { "anyOf": [ { "type": "number", "description": "Usage dashboard identifier." }, { "type": "null" } ] }, "analytics_dashboards": { "type": "array", "items": { "type": "integer", "description": "Dashboard identifier." }, "description": "Analytics dashboard identifiers attached to the feature flag." }, "has_enriched_analytics": { "anyOf": [ { "type": "boolean", "description": "Whether analytics have been enriched." }, { "type": "null" } ] }, "is_remote_configuration": { "anyOf": [ { "type": "boolean", "description": "Whether the flag is a remote configuration." }, { "type": "null" } ] }, "has_encrypted_payloads": { "anyOf": [ { "type": "boolean", "description": "Whether the flag has encrypted payloads." }, { "type": "null" } ] }, "is_used_in_replay_settings": { "anyOf": [ { "type": "boolean", "description": "Whether the flag is used in replay settings." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "key", "name", "active", "deleted", "filters", "tags", "raw" ], "description": "PostHog feature flag with a stable top-level connector shape." }, "description": "Feature flags returned by PostHog." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": false, "description": "Paginated PostHog feature flag list." } }, { "id": "posthog.list_insights", "service": "posthog", "name": "list_insights", "description": "List insights for a PostHog project.", "requiredScopes": [], "providerPermissions": [ "insight:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "basic": { "type": "boolean", "description": "Whether to return basic insight metadata without results." }, "limit": { "type": "integer", "minimum": 1, "description": "Number of results to return per page." }, "offset": { "type": "integer", "minimum": 0, "description": "Initial index from which to return the results." }, "refresh": { "type": "string", "enum": [ "async", "async_except_on_cache_miss", "blocking", "force_async", "force_blocking", "force_cache", "lazy_async" ], "description": "Refresh mode used by the PostHog API." }, "short_id": { "type": "string", "description": "Short insight identifier to filter by." } }, "additionalProperties": false, "required": [ "project_id" ], "description": "Input for listing PostHog insights." }, "outputSchema": { "type": "object", "properties": { "count": { "type": "integer", "description": "Total number of results available." }, "next": { "anyOf": [ { "type": "string", "description": "URL for the next page of results, or null when there is no next page." }, { "type": "null" } ] }, "previous": { "anyOf": [ { "type": "string", "description": "URL for the previous page of results, or null when there is no previous page." }, { "type": "null" } ] }, "results": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric insight identifier." }, "short_id": { "type": "string", "description": "Short insight identifier." }, "name": { "anyOf": [ { "type": "string", "description": "Insight name." }, { "type": "null" } ] }, "derived_name": { "anyOf": [ { "type": "string", "description": "Derived insight name." }, { "type": "null" } ] }, "query": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Insight query definition returned by PostHog." }, { "type": "null" } ] }, "order": { "anyOf": [ { "type": "number", "description": "Display order for the insight." }, { "type": "null" } ] }, "deleted": { "type": "boolean", "description": "Whether the insight is marked as deleted." }, "dashboards": { "type": "array", "items": { "type": "number", "description": "Dashboard ID." }, "description": "Dashboard IDs referencing the insight." }, "dashboard_tiles": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Dashboard tile summary returned by PostHog." }, "description": "Dashboard tile summaries referencing the insight." }, "last_refresh": { "anyOf": [ { "type": "string", "description": "Datetime when the insight results were last refreshed." }, { "type": "null" } ] }, "cache_target_age": { "anyOf": [ { "type": "string", "description": "Target age timestamp for cached insight results." }, { "type": "null" } ] }, "next_allowed_client_refresh": { "anyOf": [ { "type": "string", "description": "Earliest datetime when a client may refresh the insight." }, { "type": "null" } ] }, "result": { "description": "Insight result payload returned by PostHog." }, "hasMore": { "anyOf": [ { "type": "boolean", "description": "Whether the insight has more result rows." }, { "type": "null" } ] }, "columns": { "anyOf": [ { "type": "array", "items": { "type": "string", "description": "Column name." }, "description": "Column names for the result." }, { "type": "null" } ] }, "created_at": { "anyOf": [ { "type": "string", "description": "Datetime when the insight was created." }, { "type": "null" } ] }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "Insight description." }, { "type": "null" } ] }, "updated_at": { "type": "string", "description": "Datetime when the insight was updated." }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the insight." }, "favorited": { "type": "boolean", "description": "Whether the insight is favorited." }, "last_modified_at": { "type": "string", "description": "Datetime when the insight was last modified." }, "last_modified_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "is_sample": { "type": "boolean", "description": "Whether the insight is a sample insight." }, "effective_restriction_level": { "type": "number", "description": "Effective restriction level for the current user." }, "effective_privilege_level": { "type": "number", "description": "Effective privilege level for the current user." }, "user_access_level": { "anyOf": [ { "type": "string", "description": "Effective user access level for the insight." }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string", "description": "Timezone used to display the insight." }, { "type": "null" } ] }, "is_cached": { "type": "boolean", "description": "Whether the returned insight result is cached." }, "query_status": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Query status returned with the insight." }, { "type": "null" } ] }, "hogql": { "anyOf": [ { "type": "string", "description": "Generated HogQL query for the insight." }, { "type": "null" } ] }, "types": { "anyOf": [ { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Types returned for the insight." }, { "type": "null" } ] }, "resolved_date_range": { "anyOf": [ { "type": "object", "properties": { "date_from": { "type": "string", "description": "Resolved start datetime for the date range." }, "date_to": { "type": "string", "description": "Resolved end datetime for the date range." } }, "additionalProperties": true, "description": "Resolved date range returned by PostHog." }, { "type": "null" } ] }, "alerts": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Alerts attached to the insight." }, "last_viewed_at": { "anyOf": [ { "type": "string", "description": "Datetime when the insight was last viewed." }, { "type": "null" } ] }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw insight payload returned by PostHog." } }, "additionalProperties": true, "required": [ "id", "raw" ], "description": "PostHog insight with a stable top-level connector shape." }, "description": "Insights returned by PostHog." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw insight list payload returned by PostHog." } }, "additionalProperties": false, "description": "Paginated PostHog insight list with a stable top-level connector shape." } }, { "id": "posthog.list_projects", "service": "posthog", "name": "list_projects", "description": "List PostHog projects for the current or specified organization.", "requiredScopes": [], "providerPermissions": [ "organization:read", "project:read" ], "inputSchema": { "type": "object", "properties": { "organization_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String organization ID accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric organization ID accepted by the official PostHog API path." } ], "description": "Organization ID. When omitted, the provider falls back to the current organization from the connected user." }, "limit": { "type": "integer", "minimum": 1, "description": "Number of results to return per page." }, "offset": { "type": "integer", "minimum": 0, "description": "Initial index from which to return the results." }, "search": { "type": "string", "description": "A search term used to filter projects." } }, "additionalProperties": false, "description": "Input for listing PostHog projects." }, "outputSchema": { "type": "object", "properties": { "count": { "type": "integer", "description": "Total number of results available." }, "next": { "anyOf": [ { "type": "string", "description": "URL for the next page of results, or null when there is no next page." }, { "type": "null" } ] }, "previous": { "anyOf": [ { "type": "string", "description": "URL for the previous page of results, or null when there is no previous page." }, { "type": "null" } ] }, "results": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric project identifier." }, "organization": { "type": "string", "description": "Owning organization UUID." }, "uuid": { "type": "string", "description": "Project UUID." }, "name": { "type": "string", "description": "Project name." }, "api_token": { "type": "string", "description": "Project API token." }, "created_at": { "type": "string", "description": "Project creation datetime." }, "updated_at": { "type": "string", "description": "Project update datetime." }, "product_description": { "anyOf": [ { "type": "string", "description": "Description configured for the product." }, { "type": "null" } ] }, "timezone": { "type": "string", "description": "Project timezone." }, "is_demo": { "type": "boolean", "description": "Whether the project is a demo project." }, "ingested_event": { "type": "boolean", "description": "Whether the project has ingested at least one event." }, "access_control": { "type": "boolean", "description": "Whether access control is enabled." }, "app_urls": { "type": "array", "items": { "anyOf": [ { "type": "string", "description": "Configured application URL." }, { "type": "null" } ] }, "description": "Configured application URLs." }, "group_types": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Configured group type returned by PostHog." }, "description": "Configured group types." }, "product_intents": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Product intent summary returned by PostHog." }, "description": "Product intent summaries for the project." }, "secret_api_token": { "anyOf": [ { "type": "string", "description": "Project secret API token when available." }, { "type": "null" } ] }, "secret_api_token_backup": { "anyOf": [ { "type": "string", "description": "Project secret API token backup when available." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "organization", "uuid", "name" ], "description": "PostHog project." }, "description": "Projects returned by PostHog." } }, "additionalProperties": false, "description": "Paginated PostHog project list." } }, { "id": "posthog.list_property_definitions", "service": "posthog", "name": "list_property_definitions", "description": "List property definitions for a PostHog project.", "requiredScopes": [], "providerPermissions": [ "property_definition:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "event_names": { "type": "string", "description": "JSON-encoded event names used by PostHog to populate filtered event visibility." }, "exclude_core_properties": { "type": "boolean", "description": "Whether to exclude core properties." }, "exclude_hidden": { "type": "boolean", "description": "Whether to exclude hidden properties." }, "excluded_properties": { "type": "string", "description": "JSON-encoded list of excluded properties." }, "filter_by_event_names": { "anyOf": [ { "type": "boolean", "description": "Whether to return only properties seen on the supplied event names." }, { "type": "null" } ] }, "group_type_index": { "type": "integer", "description": "Group type index to use when type is group." }, "is_feature_flag": { "anyOf": [ { "type": "boolean", "description": "Whether to include only or exclude feature flag properties." }, { "type": "null" } ] }, "is_numerical": { "anyOf": [ { "type": "boolean", "description": "Whether to include only or exclude numerical properties." }, { "type": "null" } ] }, "limit": { "type": "integer", "minimum": 1, "description": "Number of results to return per page." }, "offset": { "type": "integer", "minimum": 0, "description": "Initial index from which to return the results." }, "properties": { "type": "string", "description": "Comma-separated list of properties to filter." }, "search": { "type": "string", "description": "Search term used to match property names." }, "type": { "type": "string", "enum": [ "event", "person", "group", "session" ], "description": "Property definition type to return." }, "verified": { "anyOf": [ { "type": "boolean", "description": "Whether to filter by verified state." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "project_id" ], "description": "Input for listing PostHog property definitions." }, "outputSchema": { "type": "object", "properties": { "count": { "type": "integer", "description": "Total number of results available." }, "next": { "anyOf": [ { "type": "string", "description": "URL for the next page of results, or null when there is no next page." }, { "type": "null" } ] }, "previous": { "anyOf": [ { "type": "string", "description": "URL for the previous page of results, or null when there is no previous page." }, { "type": "null" } ] }, "results": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Property definition UUID." }, "name": { "type": "string", "description": "Property name." }, "description": { "anyOf": [ { "type": "string", "description": "Description for the property definition." }, { "type": "null" } ] }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the property definition." }, "is_numerical": { "type": "boolean", "description": "Whether the property is numerical." }, "updated_at": { "type": "string", "description": "Datetime when the property definition was updated." }, "updated_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "is_seen_on_filtered_events": { "anyOf": [ { "type": "boolean", "description": "Whether the property was seen on the filtered events." }, { "type": "null" } ] }, "property_type": { "anyOf": [ { "type": "string", "description": "Property type inferred by PostHog." }, { "type": "null" } ] }, "verified": { "type": "boolean", "description": "Whether the property definition is verified." }, "verified_at": { "anyOf": [ { "type": "string", "description": "Datetime when the property definition was verified." }, { "type": "null" } ] }, "verified_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "hidden": { "anyOf": [ { "type": "boolean", "description": "Whether the property definition is hidden." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "name", "is_numerical", "updated_at" ], "description": "PostHog property definition." }, "description": "Property definitions returned by PostHog." } }, "additionalProperties": false, "description": "Paginated PostHog property definition list." } }, { "id": "posthog.move_dashboard_tile", "service": "posthog", "name": "move_dashboard_tile", "description": "Move a PostHog dashboard tile to another dashboard.", "requiredScopes": [], "providerPermissions": [ "dashboard:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." }, "tile": { "type": "object", "properties": { "id": { "type": "integer", "description": "Dashboard tile ID to move." } }, "additionalProperties": false, "description": "Dashboard tile to move." }, "toDashboard": { "type": "integer", "description": "Dashboard ID to move the tile to." } }, "additionalProperties": false, "description": "Input for moving a PostHog dashboard tile." }, "outputSchema": { "type": "object", "properties": { "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": false, "description": "Raw PostHog cohort endpoint payload." } }, { "id": "posthog.remove_dashboard_collaborator", "service": "posthog", "name": "remove_dashboard_collaborator", "description": "Remove a collaborator from a PostHog dashboard.", "requiredScopes": [], "providerPermissions": [ "dashboard:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "dashboard_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." }, "user_uuid": { "type": "string", "minLength": 1, "description": "User UUID to remove from the dashboard collaborators." } }, "additionalProperties": false, "description": "Input for removing a PostHog dashboard collaborator." }, "outputSchema": { "type": "object", "properties": { "deleted": { "type": "boolean", "description": "Whether the collaborator was removed." }, "dashboard_id": { "type": "string", "description": "Dashboard identifier." }, "user_uuid": { "type": "string", "description": "Removed user UUID." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": false, "description": "Result returned after removing a PostHog dashboard collaborator." } }, { "id": "posthog.reorder_dashboard_tiles", "service": "posthog", "name": "reorder_dashboard_tiles", "description": "Reorder tiles on a PostHog dashboard.", "requiredScopes": [], "providerPermissions": [ "dashboard:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." }, "tile_order": { "type": "array", "items": { "type": "integer", "description": "Dashboard tile ID." }, "description": "Dashboard tile IDs in the desired display order.", "minItems": 1 } }, "additionalProperties": false, "description": "Input for reordering PostHog dashboard tiles." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric dashboard identifier." }, "name": { "anyOf": [ { "type": "string", "description": "Dashboard name." }, { "type": "null" } ] }, "description": { "type": "string", "description": "Dashboard description." }, "pinned": { "type": "boolean", "description": "Whether the dashboard is pinned to the top of the list." }, "created_at": { "type": "string", "description": "Datetime when the dashboard was created." }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "last_accessed_at": { "anyOf": [ { "type": "string", "description": "Datetime when the dashboard was last accessed." }, { "type": "null" } ] }, "last_viewed_at": { "anyOf": [ { "type": "string", "description": "Datetime when the dashboard was last viewed." }, { "type": "null" } ] }, "is_shared": { "type": "boolean", "description": "Whether the dashboard is shared." }, "deleted": { "type": "boolean", "description": "Whether the dashboard is marked as deleted." }, "creation_mode": { "type": "string", "description": "Dashboard creation mode returned by PostHog." }, "filters": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Dashboard filters returned by PostHog." }, { "type": "null" } ] }, "variables": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Dashboard variables returned by PostHog." }, { "type": "null" } ] }, "breakdown_colors": { "description": "Custom color mapping for breakdown values." }, "data_color_theme_id": { "anyOf": [ { "type": "number", "description": "Color theme ID used for chart visualizations." }, { "type": "null" } ] }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the dashboard." }, "restriction_level": { "type": "integer", "description": "Dashboard restriction level." }, "effective_restriction_level": { "type": "integer", "description": "Effective restriction level for the current user." }, "effective_privilege_level": { "type": "integer", "description": "Effective privilege level for the current user." }, "user_access_level": { "anyOf": [ { "type": "string", "description": "Effective user access level for the dashboard." }, { "type": "null" } ] }, "access_control_version": { "type": "string", "description": "Dashboard access control version." }, "last_refresh": { "anyOf": [ { "type": "string", "description": "Datetime when the dashboard last refreshed." }, { "type": "null" } ] }, "persisted_filters": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Persisted dashboard filters." }, { "type": "null" } ] }, "persisted_variables": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Persisted dashboard variables." }, { "type": "null" } ] }, "team_id": { "type": "integer", "description": "Project or team ID this dashboard belongs to." }, "quick_filter_ids": { "anyOf": [ { "type": "array", "items": { "type": "string", "description": "Quick filter ID." }, "description": "Quick filter IDs associated with this dashboard." }, { "type": "null" } ] }, "tiles": { "anyOf": [ { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, "description": "Dashboard tile payloads returned by PostHog." }, { "type": "null" } ] }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": true, "required": [ "id", "raw" ], "description": "PostHog dashboard with a stable top-level connector shape." } }, { "id": "posthog.run_dashboard_insights", "service": "posthog", "name": "run_dashboard_insights", "description": "Run all insights on a PostHog dashboard and return their results.", "requiredScopes": [], "providerPermissions": [ "query:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." }, "filters_override": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, { "type": "null" } ] }, "variables_override": { "anyOf": [ { "type": "object", "additionalProperties": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, "description": "Dashboard variable overrides keyed by variable ID." }, { "type": "null" } ] }, "output_format": { "type": "string", "enum": [ "json", "optimized" ], "description": "Output format returned by PostHog." }, "refresh": { "type": "string", "enum": [ "blocking", "force_blocking", "force_cache" ], "description": "Cache behavior for dashboard insight execution." } }, "additionalProperties": false, "required": [ "project_id", "id" ], "description": "Input for running all insights on a PostHog dashboard." }, "outputSchema": { "type": "object", "properties": { "results": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Dashboard tile results returned by PostHog." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": false, "description": "Results returned after running all insights on a PostHog dashboard." } }, { "id": "posthog.run_query", "service": "posthog", "name": "run_query", "description": "Run a PostHog query and return a stable top-level query result shape.", "requiredScopes": [], "providerPermissions": [ "query:read" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "query": { "type": "object", "properties": { "kind": { "type": "string", "minLength": 1, "description": "Query kind accepted by the PostHog query API." } }, "additionalProperties": true, "description": "Query object submitted to the PostHog query API." }, "async": { "anyOf": [ { "type": "boolean", "description": "Whether PostHog should execute the query asynchronously." }, { "type": "null" } ] }, "client_query_id": { "anyOf": [ { "type": "string", "description": "Client-provided query identifier." }, { "type": "null" } ] }, "filters_override": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, { "type": "null" } ] }, "limit_context": { "anyOf": [ { "type": "string", "description": "Limit context forwarded to the query API." }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "maxLength": 128, "description": "Descriptive query name for PostHog query logs." }, { "type": "null" } ] }, "refresh": { "anyOf": [ { "type": "string", "enum": [ "async", "async_except_on_cache_miss", "blocking", "force_async", "force_blocking", "force_cache", "lazy_async" ], "description": "Refresh mode used by the PostHog API." }, { "type": "null" } ] }, "variables_override": { "anyOf": [ { "type": "object", "additionalProperties": { "description": "Variable value." }, "description": "Variable overrides for the supplied query." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "project_id", "query" ], "description": "Input for running a PostHog query in a project." }, "outputSchema": { "type": "object", "properties": { "results": { "type": "array", "items": { "description": "Query result row." }, "description": "Rows returned by the PostHog query." }, "columns": { "type": "array", "items": { "type": "string", "description": "Column name." }, "description": "Column names for the result." }, "types": { "type": "array", "items": { "description": "Column type metadata." }, "description": "Column type metadata returned by PostHog." }, "hasMore": { "anyOf": [ { "type": "boolean", "description": "Whether the query has more result rows." }, { "type": "null" } ] }, "limit": { "type": "integer", "description": "Limit returned by PostHog for the query." }, "offset": { "type": "integer", "description": "Offset returned by PostHog for the query." }, "query": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, { "type": "null" } ] }, "error": { "description": "Query error payload returned by PostHog." }, "is_cached": { "anyOf": [ { "type": "boolean", "description": "Whether the query result came from cache." }, { "type": "null" } ] }, "timings": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, "description": "Timing metrics collected while processing the query." }, "query_status": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, { "type": "null" } ] }, "hogql": { "anyOf": [ { "type": "string", "description": "Generated HogQL query." }, { "type": "null" } ] }, "cache_target_age": { "anyOf": [ { "type": "string", "description": "Target age timestamp for the cached query result." }, { "type": "null" } ] }, "last_refresh": { "anyOf": [ { "type": "string", "description": "Datetime when the query result was last refreshed." }, { "type": "null" } ] }, "next_allowed_client_refresh": { "anyOf": [ { "type": "string", "description": "Earliest datetime when the client can request a fresh result." }, { "type": "null" } ] }, "resolved_date_range": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, { "type": "null" } ] }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": true, "description": "PostHog query result with a stable connector shape." } }, { "id": "posthog.update_annotation", "service": "posthog", "name": "update_annotation", "description": "Partially update a PostHog annotation by ID.", "requiredScopes": [], "providerPermissions": [ "annotation:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "content": { "anyOf": [ { "type": "string", "description": "Annotation text shown on charts." }, { "type": "null" } ] }, "date_marker": { "anyOf": [ { "type": "string", "description": "ISO 8601 timestamp when this annotation happened." }, { "type": "null" } ] }, "creation_type": { "type": "string", "enum": [ "USR", "GIT" ], "description": "Annotation creation type." }, "dashboard_item": { "anyOf": [ { "type": "number", "description": "Dashboard tile or insight identifier attached to the annotation." }, { "type": "null" } ] }, "dashboard_id": { "anyOf": [ { "type": "number", "description": "Dashboard identifier attached to the annotation." }, { "type": "null" } ] }, "deleted": { "type": "boolean", "description": "Whether the annotation should be marked as deleted." }, "scope": { "type": "string", "enum": [ "dashboard_item", "dashboard", "project", "organization" ], "description": "Annotation visibility scope." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." } }, "additionalProperties": false, "required": [ "project_id", "id" ], "description": "Input for updating a PostHog annotation." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric annotation identifier." }, "content": { "anyOf": [ { "type": "string", "description": "Annotation text shown on charts." }, { "type": "null" } ] }, "date_marker": { "anyOf": [ { "type": "string", "description": "ISO 8601 timestamp when this annotation happened." }, { "type": "null" } ] }, "creation_type": { "type": "string", "description": "Annotation creation type returned by PostHog." }, "dashboard_item": { "anyOf": [ { "type": "number", "description": "Dashboard tile or insight identifier attached to the annotation." }, { "type": "null" } ] }, "dashboard_id": { "anyOf": [ { "type": "number", "description": "Dashboard identifier attached to the annotation." }, { "type": "null" } ] }, "dashboard_name": { "anyOf": [ { "type": "string", "description": "Dashboard name attached to the annotation." }, { "type": "null" } ] }, "insight_short_id": { "anyOf": [ { "type": "string", "description": "Insight short ID attached to the annotation." }, { "type": "null" } ] }, "insight_name": { "anyOf": [ { "type": "string", "description": "Insight name attached to the annotation." }, { "type": "null" } ] }, "insight_derived_name": { "anyOf": [ { "type": "string", "description": "Derived insight name attached to the annotation." }, { "type": "null" } ] }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "created_at": { "anyOf": [ { "type": "string", "description": "Datetime when the annotation was created." }, { "type": "null" } ] }, "updated_at": { "type": "string", "description": "Datetime when the annotation was updated." }, "deleted": { "type": "boolean", "description": "Whether the annotation is marked as deleted." }, "scope": { "type": "string", "description": "Annotation visibility scope." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": true, "required": [ "id", "raw" ], "description": "PostHog annotation." } }, { "id": "posthog.update_cohort", "service": "posthog", "name": "update_cohort", "description": "Partially update a PostHog cohort by ID.", "requiredScopes": [], "providerPermissions": [ "cohort:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "name": { "anyOf": [ { "type": "string", "maxLength": 400, "description": "Cohort name." }, { "type": "null" } ] }, "description": { "type": "string", "maxLength": 1000, "description": "Description for the cohort." }, "groups": { "description": "Group configuration defining cohort criteria." }, "deleted": { "type": "boolean", "description": "Whether the cohort should be marked as deleted." }, "filters": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, { "type": "null" } ] }, "query": { "anyOf": [ { "description": "Query payload defining this cohort." }, { "type": "null" } ] }, "is_static": { "type": "boolean", "description": "Whether the cohort is static." }, "_create_in_folder": { "type": "string", "description": "Folder identifier where PostHog should create the cohort." }, "_create_static_person_ids": { "type": "array", "items": { "type": "string", "description": "Person UUID." }, "description": "Person UUIDs to seed when creating a static cohort.", "minItems": 1 }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." } }, "additionalProperties": false, "required": [ "project_id", "id" ], "description": "Input for updating a PostHog cohort." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric cohort identifier." }, "name": { "anyOf": [ { "type": "string", "description": "Cohort name." }, { "type": "null" } ] }, "description": { "type": "string", "description": "Description for the cohort." }, "groups": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Raw group configuration returned by PostHog." }, "deleted": { "type": "boolean", "description": "Whether the cohort is marked as deleted." }, "filters": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Cohort filters returned by PostHog." }, { "type": "null" } ] }, "query": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Query payload returned by PostHog for this cohort." }, { "type": "null" } ] }, "version": { "anyOf": [ { "type": "number", "description": "Current cohort version." }, { "type": "null" } ] }, "pending_version": { "anyOf": [ { "type": "number", "description": "Pending cohort version." }, { "type": "null" } ] }, "is_calculating": { "type": "boolean", "description": "Whether the cohort is being recalculated." }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "created_at": { "anyOf": [ { "type": "string", "description": "Datetime when the cohort was created." }, { "type": "null" } ] }, "last_calculation": { "anyOf": [ { "type": "string", "description": "Datetime when the cohort was last calculated." }, { "type": "null" } ] }, "last_backfill_person_properties_at": { "anyOf": [ { "type": "string", "description": "Datetime when person properties were last backfilled." }, { "type": "null" } ] }, "errors_calculating": { "type": "number", "description": "Number of calculation errors recorded for the cohort." }, "last_error_message": { "anyOf": [ { "type": "string", "description": "Most recent cohort calculation error message." }, { "type": "null" } ] }, "count": { "anyOf": [ { "type": "number", "description": "Number of persons in the cohort." }, { "type": "null" } ] }, "is_static": { "type": "boolean", "description": "Whether the cohort is static." }, "cohort_type": { "anyOf": [ { "type": "string", "description": "Cohort type classified by PostHog." }, { "type": "null" } ] }, "experiment_set": { "type": "array", "items": { "type": "number", "description": "Experiment identifier." }, "description": "Experiment IDs attached to the cohort." } }, "additionalProperties": true, "required": [ "id" ], "description": "PostHog cohort." } }, { "id": "posthog.update_dashboard", "service": "posthog", "name": "update_dashboard", "description": "Partially update a PostHog dashboard by ID.", "requiredScopes": [], "providerPermissions": [ "dashboard:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "name": { "anyOf": [ { "type": "string", "maxLength": 400, "description": "Dashboard name." }, { "type": "null" } ] }, "description": { "type": "string", "description": "Dashboard description." }, "pinned": { "type": "boolean", "description": "Whether the dashboard should be pinned to the top of the list." }, "deleted": { "type": "boolean", "description": "Whether the dashboard should be marked as deleted." }, "breakdown_colors": { "description": "Custom color mapping for breakdown values." }, "data_color_theme_id": { "anyOf": [ { "type": "integer", "description": "Color theme ID used for chart visualizations." }, { "type": "null" } ] }, "tags": { "type": "array", "items": { "type": "string", "description": "Dashboard tag." }, "description": "Tags attached to the dashboard." }, "restriction_level": { "type": "integer", "description": "Dashboard restriction level." }, "quick_filter_ids": { "anyOf": [ { "type": "array", "items": { "type": "string", "description": "Quick filter ID." }, "description": "Quick filter IDs associated with this dashboard." }, { "type": "null" } ] }, "use_template": { "type": "string", "description": "Template key to create the dashboard from a predefined template." }, "use_dashboard": { "anyOf": [ { "type": "integer", "description": "ID of an existing dashboard to duplicate." }, { "type": "null" } ] }, "delete_insights": { "type": "boolean", "description": "Whether PostHog should also delete insights that are only on this dashboard." }, "_create_in_folder": { "type": "string", "description": "Folder identifier where PostHog should create the dashboard." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." } }, "additionalProperties": false, "required": [ "project_id", "id" ], "description": "Input for updating a PostHog dashboard." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric dashboard identifier." }, "name": { "anyOf": [ { "type": "string", "description": "Dashboard name." }, { "type": "null" } ] }, "description": { "type": "string", "description": "Dashboard description." }, "pinned": { "type": "boolean", "description": "Whether the dashboard is pinned to the top of the list." }, "created_at": { "type": "string", "description": "Datetime when the dashboard was created." }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "last_accessed_at": { "anyOf": [ { "type": "string", "description": "Datetime when the dashboard was last accessed." }, { "type": "null" } ] }, "last_viewed_at": { "anyOf": [ { "type": "string", "description": "Datetime when the dashboard was last viewed." }, { "type": "null" } ] }, "is_shared": { "type": "boolean", "description": "Whether the dashboard is shared." }, "deleted": { "type": "boolean", "description": "Whether the dashboard is marked as deleted." }, "creation_mode": { "type": "string", "description": "Dashboard creation mode returned by PostHog." }, "filters": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Dashboard filters returned by PostHog." }, { "type": "null" } ] }, "variables": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Dashboard variables returned by PostHog." }, { "type": "null" } ] }, "breakdown_colors": { "description": "Custom color mapping for breakdown values." }, "data_color_theme_id": { "anyOf": [ { "type": "number", "description": "Color theme ID used for chart visualizations." }, { "type": "null" } ] }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the dashboard." }, "restriction_level": { "type": "integer", "description": "Dashboard restriction level." }, "effective_restriction_level": { "type": "integer", "description": "Effective restriction level for the current user." }, "effective_privilege_level": { "type": "integer", "description": "Effective privilege level for the current user." }, "user_access_level": { "anyOf": [ { "type": "string", "description": "Effective user access level for the dashboard." }, { "type": "null" } ] }, "access_control_version": { "type": "string", "description": "Dashboard access control version." }, "last_refresh": { "anyOf": [ { "type": "string", "description": "Datetime when the dashboard last refreshed." }, { "type": "null" } ] }, "persisted_filters": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Persisted dashboard filters." }, { "type": "null" } ] }, "persisted_variables": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Persisted dashboard variables." }, { "type": "null" } ] }, "team_id": { "type": "integer", "description": "Project or team ID this dashboard belongs to." }, "quick_filter_ids": { "anyOf": [ { "type": "array", "items": { "type": "string", "description": "Quick filter ID." }, "description": "Quick filter IDs associated with this dashboard." }, { "type": "null" } ] }, "tiles": { "anyOf": [ { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, "description": "Dashboard tile payloads returned by PostHog." }, { "type": "null" } ] }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": true, "required": [ "id", "raw" ], "description": "PostHog dashboard with a stable top-level connector shape." } }, { "id": "posthog.update_event_definition", "service": "posthog", "name": "update_event_definition", "description": "Partially update a PostHog event definition by ID.", "requiredScopes": [], "providerPermissions": [ "event_definition:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "name": { "type": "string", "maxLength": 400, "description": "Event definition name." }, "owner": { "anyOf": [ { "type": "integer", "description": "Owner user ID." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "Description for the event definition." }, { "type": "null" } ] }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the event definition." }, "verified": { "type": "boolean", "description": "Whether the event definition is verified." }, "hidden": { "anyOf": [ { "type": "boolean", "description": "Whether the event definition is hidden." }, { "type": "null" } ] }, "enforcement_mode": { "type": "string", "description": "Enforcement mode for this event definition." }, "primary_property": { "anyOf": [ { "type": "string", "description": "Primary property displayed alongside this event." }, { "type": "null" } ] }, "post_to_slack": { "type": "boolean", "description": "Whether new events should post to Slack." }, "default_columns": { "type": "array", "items": { "type": "string", "description": "Default column name." }, "description": "Default columns configured for this event definition." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." } }, "additionalProperties": false, "required": [ "project_id", "id" ], "description": "Input for updating a PostHog event definition." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "string", "description": "Event definition UUID." }, "name": { "type": "string", "description": "Event definition name." }, "owner": { "anyOf": [ { "type": "number", "description": "Owner user ID." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "Description for the event definition." }, { "type": "null" } ] }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the event definition." }, "created_at": { "anyOf": [ { "type": "string", "description": "Creation datetime for the event definition." }, { "type": "null" } ] }, "updated_at": { "type": "string", "description": "Update datetime for the event definition." }, "updated_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "last_seen_at": { "anyOf": [ { "type": "string", "description": "Datetime when the event was last seen." }, { "type": "null" } ] }, "last_updated_at": { "type": "string", "description": "Datetime of the last upstream update." }, "verified": { "type": "boolean", "description": "Whether the event definition is verified." }, "verified_at": { "anyOf": [ { "type": "string", "description": "Datetime when the event definition was verified." }, { "type": "null" } ] }, "verified_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "hidden": { "anyOf": [ { "type": "boolean", "description": "Whether the event definition is hidden." }, { "type": "null" } ] }, "enforcement_mode": { "type": "string", "description": "Enforcement mode for this event definition." }, "primary_property": { "anyOf": [ { "type": "string", "description": "Primary property displayed alongside this event." }, { "type": "null" } ] }, "is_action": { "type": "boolean", "description": "Whether the definition represents an action." }, "action_id": { "type": "number", "description": "Action ID if this definition is an action." }, "is_calculating": { "type": "boolean", "description": "Whether PostHog is calculating related metadata." }, "last_calculated_at": { "type": "string", "description": "Last calculation datetime." }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "post_to_slack": { "type": "boolean", "description": "Whether new events post to Slack." }, "default_columns": { "type": "array", "items": { "type": "string", "description": "Default column name." }, "description": "Default columns configured for this event definition." }, "media_preview_urls": { "type": "array", "items": { "type": "string", "description": "Media preview URL." }, "description": "Media preview URLs returned by PostHog." } }, "additionalProperties": true, "required": [ "id", "name" ], "description": "PostHog event definition." } }, { "id": "posthog.update_feature_flag", "service": "posthog", "name": "update_feature_flag", "description": "Partially update a PostHog feature flag by ID.", "requiredScopes": [], "providerPermissions": [ "feature_flag:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." }, "key": { "type": "string", "description": "Feature flag key." }, "name": { "type": "string", "description": "Feature flag description." }, "filters": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Feature flag filters returned by PostHog." }, { "type": "null" } ] }, "active": { "type": "boolean", "description": "Whether the feature flag is active." }, "tags": { "type": "array", "items": { "type": "string", "description": "Feature flag tag." }, "description": "Tags attached to the feature flag." }, "evaluation_contexts": { "type": "array", "items": { "type": "string", "description": "Evaluation context." }, "description": "Evaluation contexts attached to the feature flag." } }, "additionalProperties": false, "required": [ "project_id", "id" ], "description": "Input for updating a PostHog feature flag." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "integer", "description": "Feature flag identifier." }, "key": { "type": "string", "description": "Feature flag key." }, "name": { "type": "string", "description": "Feature flag description." }, "active": { "type": "boolean", "description": "Whether the feature flag is active." }, "deleted": { "type": "boolean", "description": "Whether the feature flag is marked as deleted." }, "filters": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Feature flag filters returned by PostHog." }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the feature flag." }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." }, "created_at": { "anyOf": [ { "type": "string", "description": "Feature flag creation datetime." }, { "type": "null" } ] }, "updated_at": { "anyOf": [ { "type": "string", "description": "Feature flag update datetime." }, { "type": "null" } ] }, "created_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "last_modified_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "version": { "anyOf": [ { "type": "number", "description": "Feature flag version." }, { "type": "null" } ] }, "ensure_experience_continuity": { "anyOf": [ { "type": "boolean", "description": "Whether experience continuity is enabled for the feature flag." }, { "type": "null" } ] }, "experiment_set": { "type": "array", "items": { "type": "integer", "description": "Experiment ID." }, "description": "Associated experiment IDs." }, "experiment_set_metadata": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, "description": "Associated experiment metadata objects." }, "surveys": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Survey metadata attached to the feature flag." }, { "type": "null" } ] }, "features": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Early access feature metadata attached to the flag." }, { "type": "null" } ] }, "rollback_conditions": { "anyOf": [ { "description": "Rollback conditions for the feature flag." }, { "type": "null" } ] }, "performed_rollback": { "anyOf": [ { "type": "boolean", "description": "Whether a rollback has been performed." }, { "type": "null" } ] }, "can_edit": { "anyOf": [ { "type": "boolean", "description": "Whether the current user can edit the feature flag." }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string", "description": "Computed feature flag status." }, { "type": "null" } ] }, "evaluation_runtime": { "anyOf": [ { "type": "string", "description": "Where the feature flag is evaluated." }, { "type": "null" } ] }, "bucketing_identifier": { "anyOf": [ { "type": "string", "description": "Identifier used for bucketing users." }, { "type": "null" } ] }, "last_called_at": { "anyOf": [ { "type": "string", "description": "Last time the feature flag was evaluated." }, { "type": "null" } ] }, "user_access_level": { "anyOf": [ { "type": "string", "description": "Effective access level for the current user." }, { "type": "null" } ] }, "rollout_percentage": { "anyOf": [ { "type": "number", "description": "Feature flag rollout percentage, when present." }, { "type": "null" } ] }, "evaluation_contexts": { "type": "array", "items": { "type": "string", "description": "Evaluation context." }, "description": "Evaluation contexts attached to the feature flag." }, "usage_dashboard": { "anyOf": [ { "type": "number", "description": "Usage dashboard identifier." }, { "type": "null" } ] }, "analytics_dashboards": { "type": "array", "items": { "type": "integer", "description": "Dashboard identifier." }, "description": "Analytics dashboard identifiers attached to the feature flag." }, "has_enriched_analytics": { "anyOf": [ { "type": "boolean", "description": "Whether analytics have been enriched." }, { "type": "null" } ] }, "is_remote_configuration": { "anyOf": [ { "type": "boolean", "description": "Whether the flag is a remote configuration." }, { "type": "null" } ] }, "has_encrypted_payloads": { "anyOf": [ { "type": "boolean", "description": "Whether the flag has encrypted payloads." }, { "type": "null" } ] }, "is_used_in_replay_settings": { "anyOf": [ { "type": "boolean", "description": "Whether the flag is used in replay settings." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "key", "name", "active", "deleted", "filters", "tags", "raw" ], "description": "PostHog feature flag with a stable top-level connector shape." } }, { "id": "posthog.update_insight", "service": "posthog", "name": "update_insight", "description": "Update a saved PostHog insight by ID.", "requiredScopes": [], "providerPermissions": [ "insight:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "name": { "anyOf": [ { "type": "string", "description": "Insight name." }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string", "description": "Insight description." }, { "type": "null" } ] }, "query": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, { "type": "null" } ] }, "filters": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, { "type": "null" } ] }, "dashboards": { "type": "array", "items": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." }, "description": "Dashboard IDs referencing the insight." }, "tags": { "type": "array", "items": { "type": "string", "description": "Insight tag." }, "description": "Tags attached to the insight." }, "refresh": { "anyOf": [ { "type": "string", "enum": [ "async", "async_except_on_cache_miss", "blocking", "force_async", "force_blocking", "force_cache", "lazy_async" ], "description": "Refresh mode used by the PostHog API." }, { "type": "null" } ] }, "saved": { "anyOf": [ { "type": "boolean", "description": "Whether the insight should be saved." }, { "type": "null" } ] }, "favorited": { "anyOf": [ { "type": "boolean", "description": "Whether the insight should be favorited." }, { "type": "null" } ] }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." } }, "additionalProperties": false, "required": [ "project_id", "id" ], "description": "Input for updating a PostHog insight." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric insight identifier." }, "short_id": { "type": "string", "description": "Short insight identifier." }, "name": { "anyOf": [ { "type": "string", "description": "Insight name." }, { "type": "null" } ] }, "query": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": true, "description": "Object payload accepted or returned by PostHog." }, { "type": "null" } ] }, "raw": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Full raw payload returned by PostHog." } }, "additionalProperties": true, "description": "PostHog insight with a stable connector shape." } }, { "id": "posthog.update_property_definition", "service": "posthog", "name": "update_property_definition", "description": "Partially update a PostHog property definition by ID.", "requiredScopes": [], "providerPermissions": [ "property_definition:write" ], "inputSchema": { "type": "object", "properties": { "project_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String project ID of the project to access." }, { "type": "integer", "description": "Numeric project ID of the project to access." } ], "description": "Project ID of the project to access." }, "description": { "anyOf": [ { "type": "string", "description": "Description for the property definition." }, { "type": "null" } ] }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the property definition." }, "verified": { "type": "boolean", "description": "Whether the property definition is verified." }, "hidden": { "anyOf": [ { "type": "boolean", "description": "Whether the property definition is hidden." }, { "type": "null" } ] }, "property_type": { "anyOf": [ { "type": "string", "description": "Property type classified by PostHog." }, { "type": "null" } ] }, "id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier accepted by the official PostHog API path." }, { "type": "integer", "description": "Numeric identifier accepted by the official PostHog API path." } ], "description": "Identifier accepted by the official PostHog API path." } }, "additionalProperties": false, "required": [ "project_id", "id" ], "description": "Input for updating a PostHog property definition." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "string", "description": "Property definition UUID." }, "name": { "type": "string", "description": "Property name." }, "description": { "anyOf": [ { "type": "string", "description": "Description for the property definition." }, { "type": "null" } ] }, "tags": { "type": "array", "items": { "description": "Array item returned by PostHog." }, "description": "Tags attached to the property definition." }, "is_numerical": { "type": "boolean", "description": "Whether the property is numerical." }, "updated_at": { "type": "string", "description": "Datetime when the property definition was updated." }, "updated_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "is_seen_on_filtered_events": { "anyOf": [ { "type": "boolean", "description": "Whether the property was seen on the filtered events." }, { "type": "null" } ] }, "property_type": { "anyOf": [ { "type": "string", "description": "Property type inferred by PostHog." }, { "type": "null" } ] }, "verified": { "type": "boolean", "description": "Whether the property definition is verified." }, "verified_at": { "anyOf": [ { "type": "string", "description": "Datetime when the property definition was verified." }, { "type": "null" } ] }, "verified_by": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric user identifier." }, "uuid": { "type": "string", "description": "User UUID." }, "email": { "type": "string", "description": "User email address." }, "first_name": { "type": "string", "description": "User first name." }, "last_name": { "type": "string", "description": "User last name." }, "distinct_id": { "anyOf": [ { "type": "string", "description": "Current distinct ID for the user." }, { "type": "null" } ] }, "role_at_organization": { "anyOf": [ { "type": "string", "description": "Role declared for the user within the organization." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "uuid", "email" ], "description": "Basic PostHog user." }, { "type": "null" } ] }, "hidden": { "anyOf": [ { "type": "boolean", "description": "Whether the property definition is hidden." }, { "type": "null" } ] } }, "additionalProperties": true, "required": [ "id", "name", "is_numerical", "updated_at" ], "description": "PostHog property definition." } } ] }