diff --git a/src/generated/api.d.ts b/src/generated/api.d.ts index a99ab6c..ea711cf 100644 --- a/src/generated/api.d.ts +++ b/src/generated/api.d.ts @@ -779,9 +779,8 @@ export interface components { /** Id */ id: number; /** - * Kind - * @default ActionsNode - * @constant + * @description discriminator enum property added by openapi-typescript + * @enum {string} */ kind: "ActionsNode"; /** @@ -979,6 +978,12 @@ export interface components { * @default null */ types: string[] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** * AggregationAxisFormat @@ -986,10 +991,10 @@ export interface components { */ AggregationAxisFormat: "numeric" | "duration" | "duration_ms" | "percentage" | "percentage_scaled" | "currency" | "short"; /** - * AggregationPropertyType1 + * AggregationPropertyType * @enum {string} */ - AggregationPropertyType1: "event" | "person" | "data_warehouse"; + AggregationPropertyType: "event" | "person" | "data_warehouse"; /** * AggregationType * @enum {string} @@ -1517,6 +1522,15 @@ export interface components { * @enum {string} */ BusinessModelEnum: "b2b" | "b2c" | "other"; + /** CalendarHeatmapFilter */ + CalendarHeatmapFilter: { + /** + * Bucketbysessionstart + * @description When true and the series math is `dau`/`unique_users`, each user contributes to the (day-of-week, hour) bucket of their session's first event only — matching the web overview session-start attribution. When false (default), the user contributes to every bucket they have any event in. No effect on `total` math (event counts are unchanged either way). + * @default false + */ + bucketBySessionStart: boolean | null; + }; /** * CalendarHeatmapMathType * @enum {string} @@ -1545,6 +1559,14 @@ export interface components { heatmap: components["schemas"]["HeatmapSettings"] | null; /** @default null */ leftYAxisSettings: components["schemas"]["YAxisSettings"] | null; + /** + * Resultcustomizations + * @description Per-breakdown-value color customizations. Keyed by the raw breakdown column value. + * @default null + */ + resultCustomizations: { + [key: string]: components["schemas"]["ResultCustomizationByValue"]; + } | null; /** @default null */ rightYAxisSettings: components["schemas"]["YAxisSettings"] | null; /** @@ -2394,7 +2416,7 @@ export interface components { */ response: { [key: string]: unknown; - } | components["schemas"]["Response"] | components["schemas"]["Response1"] | components["schemas"]["Response2"] | components["schemas"]["Response3"] | components["schemas"]["Response4"] | components["schemas"]["Response5"] | components["schemas"]["Response6"] | components["schemas"]["Response8"] | components["schemas"]["Response9"] | components["schemas"]["Response10"] | components["schemas"]["Response11"] | components["schemas"]["Response12"] | components["schemas"]["Response13"] | components["schemas"]["Response14"] | components["schemas"]["Response15"] | components["schemas"]["Response16"] | components["schemas"]["Response18"] | components["schemas"]["Response19"] | components["schemas"]["Response20"] | components["schemas"]["Response21"] | components["schemas"]["Response22"] | components["schemas"]["Response23"] | components["schemas"]["Response24"] | components["schemas"]["Response25"] | components["schemas"]["Response26"] | null; + } | components["schemas"]["Response"] | components["schemas"]["Response1"] | components["schemas"]["Response2"] | components["schemas"]["Response3"] | components["schemas"]["Response4"] | components["schemas"]["Response5"] | components["schemas"]["Response6"] | components["schemas"]["Response7"] | components["schemas"]["Response8"] | components["schemas"]["Response9"] | components["schemas"]["Response10"] | components["schemas"]["Response11"] | components["schemas"]["Response12"] | components["schemas"]["Response13"] | components["schemas"]["Response14"] | components["schemas"]["Response15"] | components["schemas"]["Response16"] | components["schemas"]["Response18"] | components["schemas"]["Response19"] | components["schemas"]["Response20"] | components["schemas"]["Response21"] | components["schemas"]["Response22"] | components["schemas"]["Response23"] | components["schemas"]["Response24"] | components["schemas"]["Response25"] | components["schemas"]["Response26"] | null; /** * Showabsolutetime * @description Render date-time columns (timestamp, created_at, last_seen, last_seen_at, session_start, session_end) as absolute date+time instead of relative ("X ago"). The toggle is exposed in the column header menu only on EventsQuery / ActorsQuery sources. @@ -2730,6 +2752,34 @@ export interface components { */ value: (string | number | boolean)[] | string | number | boolean | null; }; + /** DataWarehouseSyncWarning */ + DataWarehouseSyncWarning: { + /** + * Message + * @description Human-readable warning shown to the user + */ + message: string; + /** + * Schema Name + * @description Name of the ExternalDataSchema responsible for syncing the table + */ + schema_name: string; + /** + * Source Type + * @description Source type, e.g. "Stripe", "Hubspot" + */ + source_type: string; + /** + * Status + * @description Sync status that triggered the warning, e.g. "Failed", "Paused", "BillingLimitReached" + */ + status: string; + /** + * Table Name + * @description Name of the warehouse table the warning refers to + */ + table_name: string; + }; /** * @description * `is_date_exact` - is_date_exact * * `is_date_before` - is_date_before @@ -2922,6 +2972,8 @@ export interface components { } | null; /** @description Set to true to soft-delete this endpoint. */ deleted?: boolean | null; + /** @description List of tag names to associate with this endpoint. Replaces any existing tags. */ + tags?: string[] | null; }; /** @description Full endpoint representation returned by list/retrieve/create/update. */ EndpointResponse: { @@ -2984,6 +3036,8 @@ export interface components { } | null; /** @description Column names and types from the query's SELECT clause. */ columns: components["schemas"]["EndpointColumn"][]; + /** @description Tag names associated with this endpoint. */ + tags: string[]; }; /** @description Extended endpoint representation when viewing a specific version. */ EndpointVersionResponse: { @@ -3046,6 +3100,8 @@ export interface components { } | null; /** @description Column names and types from the query's SELECT clause. */ columns: components["schemas"]["EndpointColumn"][]; + /** @description Tag names associated with this endpoint. */ + tags: string[]; /** @description Version number. */ version: number; /** @@ -3192,6 +3248,12 @@ export interface components { * @default null */ types: unknown[] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** * @description * `allow` - Allow @@ -3474,6 +3536,12 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** ErrorTrackingIssueFilter */ ErrorTrackingIssueFilter: { @@ -3726,6 +3794,12 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** * @description * `server` - Server @@ -3856,9 +3930,8 @@ export interface components { */ fixedProperties: (components["schemas"]["EventPropertyFilter"] | components["schemas"]["PersonPropertyFilter"] | components["schemas"]["ElementPropertyFilter"] | components["schemas"]["EventMetadataPropertyFilter"] | components["schemas"]["SessionPropertyFilter"] | components["schemas"]["CohortPropertyFilter"] | components["schemas"]["RecordingPropertyFilter"] | components["schemas"]["LogEntryPropertyFilter"] | components["schemas"]["GroupPropertyFilter"] | components["schemas"]["FeaturePropertyFilter"] | components["schemas"]["FlagPropertyFilter"] | components["schemas"]["HogQLPropertyFilter"] | components["schemas"]["EmptyPropertyFilter"] | components["schemas"]["DataWarehousePropertyFilter"] | components["schemas"]["DataWarehousePersonPropertyFilter"] | components["schemas"]["ErrorTrackingIssueFilter"] | components["schemas"]["LogPropertyFilter"] | components["schemas"]["SpanPropertyFilter"] | components["schemas"]["RevenueAnalyticsPropertyFilter"] | components["schemas"]["WorkflowVariablePropertyFilter"])[] | null; /** - * Kind - * @default EventsNode - * @constant + * @description discriminator enum property added by openapi-typescript + * @enum {string} */ kind: "EventsNode"; /** @@ -4154,6 +4227,12 @@ export interface components { timings: components["schemas"]["QueryTiming"][] | null; /** Types */ types: string[]; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** * @description * `is_set` - is_set @@ -4359,6 +4438,28 @@ export interface components { */ id: number | null; kind: components["schemas"]["Kind"]; + /** + * @description How to aggregate this source. Defaults to 'total' (event count). Use 'sum' together with math_property to aggregate a numeric property — e.g. a ratio numerator of revenue per order. Other options: 'avg', 'min', 'max', 'unique_session', 'dau', 'unique_group', 'hogql'. + * @default null + */ + math: components["schemas"]["ExperimentMetricMathType"] | null; + /** + * @description Group type index to aggregate over. Required when math is 'unique_group'. + * @default null + */ + math_group_type_index: components["schemas"]["MathGroupTypeIndex"] | null; + /** + * Math Hogql + * @description HogQL aggregation expression. Required when math is 'hogql' — without it the metric silently falls back to a plain count/sum. + * @default null + */ + math_hogql: string | null; + /** + * Math Property + * @description Numeric event property to aggregate when math is 'sum', 'avg', 'min', or 'max' (e.g. 'revenue'). + * @default null + */ + math_property: string | null; /** * Properties * @description Event property filters to narrow which events are counted. @@ -4413,17 +4514,34 @@ export interface components { * @default null */ denominator: components["schemas"]["ExperimentApiEventSource"] | null; + /** + * @description For ratio metrics: winsorization applied to the denominator aggregate. Leave unset for a binomial-style denominator, which is never clamped. + * @default null + */ + denominator_outlier_handling: components["schemas"]["ExperimentMetricOutlierHandling"] | null; /** * @description Whether higher or lower values indicate success. * @default null */ goal: components["schemas"]["ExperimentMetricGoal"] | null; + /** + * Ignore Zeros + * @description For mean metrics: exclude zero values when computing the winsorization percentile thresholds. + * @default null + */ + ignore_zeros: boolean | null; /** * Kind * @default ExperimentMetric * @constant */ kind: "ExperimentMetric"; + /** + * Lower Bound Percentile + * @description For mean metrics: winsorization lower percentile bound, as a fraction in [0, 1] (e.g. 0.01 for the 1st percentile). Per-user values below this percentile are clamped to it before aggregation. + * @default null + */ + lower_bound_percentile: number | null; metric_type: components["schemas"]["ExperimentMetricType"]; /** * Name @@ -4436,6 +4554,11 @@ export interface components { * @default null */ numerator: components["schemas"]["ExperimentApiEventSource"] | null; + /** + * @description For ratio metrics: winsorization applied to the numerator aggregate, independently of the denominator and each with its own percentile thresholds. + * @default null + */ + numerator_outlier_handling: components["schemas"]["ExperimentMetricOutlierHandling"] | null; /** * Retention Window End * @default null @@ -4466,6 +4589,12 @@ export interface components { start_event: components["schemas"]["ExperimentApiEventSource"] | null; /** @default null */ start_handling: components["schemas"]["StartHandling"] | null; + /** + * Upper Bound Percentile + * @description For mean metrics: winsorization upper percentile bound, as a fraction in [0, 1] (e.g. 0.99 for the 99th percentile). Per-user values above this percentile are clamped to it before aggregation. + * @default null + */ + upper_bound_percentile: number | null; /** * Uuid * @description Unique identifier. Auto-generated if omitted. @@ -4506,9 +4635,8 @@ export interface components { */ fixedProperties: (components["schemas"]["EventPropertyFilter"] | components["schemas"]["PersonPropertyFilter"] | components["schemas"]["ElementPropertyFilter"] | components["schemas"]["EventMetadataPropertyFilter"] | components["schemas"]["SessionPropertyFilter"] | components["schemas"]["CohortPropertyFilter"] | components["schemas"]["RecordingPropertyFilter"] | components["schemas"]["LogEntryPropertyFilter"] | components["schemas"]["GroupPropertyFilter"] | components["schemas"]["FeaturePropertyFilter"] | components["schemas"]["FlagPropertyFilter"] | components["schemas"]["HogQLPropertyFilter"] | components["schemas"]["EmptyPropertyFilter"] | components["schemas"]["DataWarehousePropertyFilter"] | components["schemas"]["DataWarehousePersonPropertyFilter"] | components["schemas"]["ErrorTrackingIssueFilter"] | components["schemas"]["LogPropertyFilter"] | components["schemas"]["SpanPropertyFilter"] | components["schemas"]["RevenueAnalyticsPropertyFilter"] | components["schemas"]["WorkflowVariablePropertyFilter"])[] | null; /** - * Kind - * @default ExperimentDataWarehouseNode - * @constant + * @description discriminator enum property added by openapi-typescript + * @enum {string} */ kind: "ExperimentDataWarehouseNode"; /** @@ -4746,6 +4874,12 @@ export interface components { stats_version: number | null; /** Variants */ variants: components["schemas"]["ExperimentVariantFunnelsBaseStats"][]; + /** + * Warnings + * @description Data warehouse sync warnings — see AnalyticsQueryResponseBase.warnings for semantics. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; ExperimentHoldout: { readonly id: number; @@ -4793,6 +4927,7 @@ export interface components { kind: "ExperimentMetric"; /** * Lower Bound Percentile + * @description Winsorization lower percentile bound, as a fraction in [0, 1] (e.g. 0.01 for the 1st percentile). * @default null */ lower_bound_percentile: number | null; @@ -4822,6 +4957,7 @@ export interface components { source: components["schemas"]["EventsNode"] | components["schemas"]["ActionsNode"] | components["schemas"]["ExperimentDataWarehouseNode"]; /** * Upper Bound Percentile + * @description Winsorization upper percentile bound, as a fraction in [0, 1] (e.g. 0.99 for the 99th percentile). * @default null */ upper_bound_percentile: number | null; @@ -4847,6 +4983,26 @@ export interface components { * @enum {string} */ ExperimentMetricMathType: "total" | "sum" | "unique_session" | "min" | "max" | "avg" | "dau" | "unique_group" | "hogql"; + /** ExperimentMetricOutlierHandling */ + ExperimentMetricOutlierHandling: { + /** + * Ignore Zeros + * @default null + */ + ignore_zeros: boolean | null; + /** + * Lower Bound Percentile + * @description Winsorization lower percentile bound, as a fraction in [0, 1] (e.g. 0.01 for the 1st percentile). + * @default null + */ + lower_bound_percentile: number | null; + /** + * Upper Bound Percentile + * @description Winsorization upper percentile bound, as a fraction in [0, 1] (e.g. 0.99 for the 99th percentile). + * @default null + */ + upper_bound_percentile: number | null; + }; /** * ExperimentMetricType * @enum {string} @@ -4996,6 +5152,12 @@ export interface components { * @default null */ variants: components["schemas"]["ExperimentVariantTrendsBaseStats"][] | components["schemas"]["ExperimentVariantFunnelsBaseStats"][] | null; + /** + * Warnings + * @description Data warehouse sync warnings — see AnalyticsQueryResponseBase.warnings for semantics. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** ExperimentRatioMetric */ ExperimentRatioMetric: { @@ -5010,6 +5172,8 @@ export interface components { conversion_window_unit: components["schemas"]["FunnelConversionWindowTimeUnit"] | null; /** Denominator */ denominator: components["schemas"]["EventsNode"] | components["schemas"]["ActionsNode"] | components["schemas"]["ExperimentDataWarehouseNode"]; + /** @default null */ + denominator_outlier_handling: components["schemas"]["ExperimentMetricOutlierHandling"] | null; /** * Fingerprint * @default null @@ -5040,6 +5204,8 @@ export interface components { name: string | null; /** Numerator */ numerator: components["schemas"]["EventsNode"] | components["schemas"]["ActionsNode"] | components["schemas"]["ExperimentDataWarehouseNode"]; + /** @default null */ + numerator_outlier_handling: components["schemas"]["ExperimentMetricOutlierHandling"] | null; /** * Response * @default null @@ -5140,8 +5306,12 @@ export interface components { /** @description Mixin for serializers to add user access control fields */ ExperimentSavedMetric: { readonly id: number; + /** @description Name of the shared metric. Must be unique within the project (case-insensitive). */ name: string; + /** @description Short description of what the metric measures. */ description?: string | null; + /** @description ExperimentMetric JSON. Must have kind='ExperimentMetric' and a metric_type: 'mean' (set source to an EventsNode with an event name), 'funnel' (set series to an array of EventsNode steps), 'ratio' (set numerator and denominator EventsNode entries), or 'retention' (set start_event and completion_event). Legacy kinds (ExperimentTrendsQuery, ExperimentFunnelsQuery) are rejected for new shared metrics. */ + query: unknown; readonly created_by: components["schemas"]["UserBasic"]; /** Format: date-time */ readonly created_at: string; @@ -5311,6 +5481,12 @@ export interface components { stats_version: number | null; /** Variants */ variants: components["schemas"]["ExperimentVariantTrendsBaseStats"][]; + /** + * Warnings + * @description Data warehouse sync warnings — see AnalyticsQueryResponseBase.warnings for semantics. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** * @description * `web` - web @@ -6147,6 +6323,12 @@ export interface components { * @default null */ types: unknown[] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** FunnelCorrelationResult */ FunnelCorrelationResult: { @@ -6741,6 +6923,12 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** GoalLine */ GoalLine: { @@ -7012,6 +7200,12 @@ export interface components { timings: components["schemas"]["QueryTiming"][] | null; /** Types */ types: string[]; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** HeatmapGradientStop */ HeatmapGradientStop: { @@ -7309,6 +7503,11 @@ export interface components { * @default null */ optimizeProjections: boolean | null; + /** + * @description HogQL parser backend; absent → `cpp_with_rust_py_shadow` (cpp is primary, rust-py runs as a sampled shadow). `*_shadow` modes return the primary result and sample-compare against the other parser, reporting divergences without failing the request. The `rust_py_*` modes drive the same hand-rolled Rust parser as `rust_*` but build `posthog.hogql.ast` dataclass instances directly via PyO3, skipping the JSON round-trip. + * @default null + */ + parserMode: components["schemas"]["ParserMode"] | null; /** @default null */ personsArgMaxVersion: components["schemas"]["PersonsArgMaxVersion"] | null; /** @default null */ @@ -7452,6 +7651,12 @@ export interface components { * @default null */ types: unknown[] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** HogQLVariable */ HogQLVariable: { @@ -8130,6 +8335,12 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** * LifecycleToggle @@ -8323,6 +8534,12 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** * MarketingAnalyticsDrillDownLevel @@ -8553,6 +8770,12 @@ export interface components { * @default null */ types: unknown[] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** * MaterializationMode @@ -8767,6 +8990,12 @@ export interface components { * @default null */ types: unknown[] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; NullEnum: null; /** @description Matches numeric values with comparison operators. */ @@ -9019,6 +9248,11 @@ export interface components { previous?: string | null; results: components["schemas"]["SchemaPropertyGroup"][]; }; + /** + * ParserMode + * @enum {string} + */ + ParserMode: "cpp_only" | "cpp_with_rust_shadow" | "cpp_with_rust_py_shadow" | "rust_with_cpp_shadow" | "rust_only" | "rust_py_only" | "rust_py_with_cpp_shadow"; /** @description Serializer mixin that handles tags for objects. */ PatchedAction: { readonly id?: number; @@ -9177,6 +9411,8 @@ export interface components { } | null; /** @description Set to true to soft-delete this endpoint. */ deleted?: boolean | null; + /** @description List of tag names to associate with this endpoint. Replaces any existing tags. */ + tags?: string[] | null; }; /** @description Serializer mixin that handles tags for objects. */ PatchedEnterpriseEventDefinition: { @@ -9306,8 +9542,12 @@ export interface components { /** @description Mixin for serializers to add user access control fields */ PatchedExperimentSavedMetric: { readonly id?: number; + /** @description Name of the shared metric. Must be unique within the project (case-insensitive). */ name?: string; + /** @description Short description of what the metric measures. */ description?: string | null; + /** @description ExperimentMetric JSON. Must have kind='ExperimentMetric' and a metric_type: 'mean' (set source to an EventsNode with an event name), 'funnel' (set series to an array of EventsNode steps), 'ratio' (set numerator and denominator EventsNode entries), or 'retention' (set start_event and completion_event). Legacy kinds (ExperimentTrendsQuery, ExperimentFunnelsQuery) are rejected for new shared metrics. */ + query?: unknown; readonly created_by?: components["schemas"]["UserBasic"]; /** Format: date-time */ readonly created_at?: string; @@ -9443,6 +9683,28 @@ export interface components { app_urls?: (string | null)[]; anonymize_ips?: boolean; completed_snippet_onboarding?: boolean; + /** + * @description Filters used to identify internal/test users. Each entry is a property filter. + * + * Supported entry types and the exact shape each accepts: + * + * # Person property — match (or exclude) by a person property + * {"key": "email", "type": "person", "value": "@example.com", "operator": "icontains"} + * + * # Event property — match by an event property + * {"key": "$host", "type": "event", "value": "localhost", "operator": "icontains"} + * + * # Cohort membership — match (or exclude) members of a cohort. + * # Use operator "in" for inclusion and "not_in" for exclusion. Do NOT use a + * # `negation` field here — `negation` is specific to cohort *definitions* + * # (the inner sub-filters that build a cohort) and is rejected by the + * # property-filter schema. + * {"key": "id", "type": "cohort", "value": 8814, "operator": "not_in"} + * + * Common operators: "exact", "is_not", "icontains", "not_icontains", "regex", + * "not_regex", "gt", "lt", "gte", "lte", "is_set", "is_not_set", "in", "not_in". + */ + test_account_filters?: unknown; test_account_filters_default_checked?: boolean | null; is_demo?: boolean; timezone?: components["schemas"]["TimezoneEnum"]; @@ -9737,6 +9999,12 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** PersonFilter */ PersonFilter: { @@ -10204,6 +10472,12 @@ export interface components { timings: components["schemas"]["QueryTiming"][] | null; /** Types */ types: string[]; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** Response1 */ Response1: { @@ -10262,6 +10536,12 @@ export interface components { * @default null */ types: string[] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** Response10 */ Response10: { @@ -10318,6 +10598,12 @@ export interface components { timings: components["schemas"]["QueryTiming"][] | null; /** Types */ types: string[]; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** Response11 */ Response11: { @@ -10361,6 +10647,12 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** Response12 */ Response12: { @@ -10404,6 +10696,12 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** Response13 */ Response13: { @@ -10447,6 +10745,12 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** Response14 */ Response14: { @@ -10485,6 +10789,12 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** Response15 */ Response15: { @@ -10528,6 +10838,12 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** Response16 */ Response16: { @@ -10591,6 +10907,12 @@ export interface components { * @default null */ types: unknown[] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** Response18 */ Response18: { @@ -10656,6 +10978,12 @@ export interface components { * @default null */ types: unknown[] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** Response19 */ Response19: { @@ -10698,6 +11026,12 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** Response2 */ Response2: { @@ -10754,6 +11088,12 @@ export interface components { timings: components["schemas"]["QueryTiming"][] | null; /** Types */ types: string[]; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** Response20 */ Response20: { @@ -10819,6 +11159,12 @@ export interface components { * @default null */ types: unknown[] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** Response21 */ Response21: { @@ -10877,6 +11223,12 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** Response22 */ Response22: { @@ -10935,6 +11287,12 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** Response23 */ Response23: { @@ -10970,6 +11328,12 @@ export interface components { stats_version: number | null; /** Variants */ variants: components["schemas"]["ExperimentVariantFunnelsBaseStats"][]; + /** + * Warnings + * @description Data warehouse sync warnings — see AnalyticsQueryResponseBase.warnings for semantics. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** Response24 */ Response24: { @@ -11007,6 +11371,12 @@ export interface components { stats_version: number | null; /** Variants */ variants: components["schemas"]["ExperimentVariantTrendsBaseStats"][]; + /** + * Warnings + * @description Data warehouse sync warnings — see AnalyticsQueryResponseBase.warnings for semantics. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** Response25 */ Response25: { @@ -11065,6 +11435,12 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** Response26 */ Response26: { @@ -11128,6 +11504,12 @@ export interface components { * @default null */ types: unknown[] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** Response3 */ Response3: { @@ -11216,6 +11598,12 @@ export interface components { * @default null */ types: unknown[] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** Response4 */ Response4: { @@ -11266,11 +11654,22 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Usedlazyprecompute + * @default null + */ + usedLazyPrecompute: boolean | null; /** * Usedpreaggregatedtables * @default null */ usedPreAggregatedTables: boolean | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** Response5 */ Response5: { @@ -11336,11 +11735,22 @@ export interface components { * @default null */ types: unknown[] | null; + /** + * Usedlazyprecompute + * @default null + */ + usedLazyPrecompute: boolean | null; /** * Usedpreaggregatedtables * @default null */ usedPreAggregatedTables: boolean | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** Response6 */ Response6: { @@ -11406,6 +11816,95 @@ export interface components { * @default null */ types: unknown[] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; + }; + /** Response7 */ + Response7: { + /** + * Columns + * @default null + */ + columns: unknown[] | null; + /** + * Error + * @description Query error. Returned only if 'explain' or `modifiers.debug` is true. Throws an error otherwise. + * @default null + */ + error: string | null; + /** + * Hasmore + * @default null + */ + hasMore: boolean | null; + /** + * Hogql + * @description Generated HogQL query. + * @default null + */ + hogql: string | null; + /** + * Limit + * @default null + */ + limit: number | null; + /** + * @description Modifiers used when performing the query + * @default null + */ + modifiers: components["schemas"]["HogQLQueryModifiers"] | null; + /** + * Offset + * @default null + */ + offset: number | null; + /** + * @description Query status indicates whether next to the provided data, a query is still running. + * @default null + */ + query_status: components["schemas"]["QueryStatus"] | null; + /** + * @description The date range used for the query + * @default null + */ + resolved_date_range: components["schemas"]["ResolvedDateRangeResponse"] | null; + /** Results */ + results: unknown[]; + /** @default null */ + samplingRate: components["schemas"]["SamplingRate"] | null; + /** + * Timings + * @description Measured timings for different parts of the query generation process + * @default null + */ + timings: components["schemas"]["QueryTiming"][] | null; + /** + * Types + * @default null + */ + types: unknown[] | null; + /** + * Usedlazyprecompute + * @description Whether the response was served from the lazy precompute path. + * @default null + */ + usedLazyPrecompute: boolean | null; + /** + * Usedpreaggregatedtables + * @description Whether the response was served from a precomputed table. + * @default null + */ + usedPreAggregatedTables: boolean | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** Response8 */ Response8: { @@ -11444,6 +11943,17 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Usedlazyprecompute + * @default null + */ + usedLazyPrecompute: boolean | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** Response9 */ Response9: { @@ -11507,6 +12017,12 @@ export interface components { * @default null */ types: unknown[] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** * @description * `21` - Everyone in the project can edit @@ -11629,12 +12145,18 @@ export interface components { * @description The type of property to aggregate on (event, person or data_warehouse). Defaults to event. * @default event */ - aggregationPropertyType: components["schemas"]["AggregationPropertyType1"] | null; + aggregationPropertyType: components["schemas"]["AggregationPropertyType"] | null; /** * @description The aggregation type to use for retention * @default count */ aggregationType: components["schemas"]["AggregationType"] | null; + /** + * Cohortlabelstartindex + * @description Starting index used when labeling cohort columns (e.g. 0 for D0/D1/D2, 1 for D1/D2/D3). Display-only — does not affect retention calculations. + * @default 0 + */ + cohortLabelStartIndex: number | null; /** * Cumulative * @default null @@ -11816,6 +12338,12 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** * RetentionReference @@ -11944,6 +12472,12 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** RevenueAnalyticsMRRQuery */ RevenueAnalyticsMRRQuery: { @@ -12018,6 +12552,12 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** RevenueAnalyticsMRRQueryResultItem */ RevenueAnalyticsMRRQueryResultItem: { @@ -12105,6 +12645,12 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** RevenueAnalyticsOverviewItem */ RevenueAnalyticsOverviewItem: { @@ -12182,6 +12728,12 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** RevenueAnalyticsPropertyFilter */ RevenueAnalyticsPropertyFilter: { @@ -12281,6 +12833,12 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** RevenueCurrencyPropertyConfig */ RevenueCurrencyPropertyConfig: { @@ -12388,6 +12946,12 @@ export interface components { * @default null */ types: unknown[] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** RevenueExampleEventsQuery */ RevenueExampleEventsQuery: { @@ -12485,6 +13049,12 @@ export interface components { * @default null */ types: unknown[] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** * @description * `engineering` - Engineering @@ -12648,6 +13218,12 @@ export interface components { * @default null */ types: unknown[] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** * SessionAttributionGroupBy @@ -12862,6 +13438,12 @@ export interface components { timings: components["schemas"]["QueryTiming"][] | null; /** Types */ types: string[]; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** * SessionsV2JoinMode @@ -13136,6 +13718,12 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** * @description * `exact` - exact @@ -13259,6 +13847,28 @@ export interface components { app_urls?: (string | null)[]; anonymize_ips?: boolean; completed_snippet_onboarding?: boolean; + /** + * @description Filters used to identify internal/test users. Each entry is a property filter. + * + * Supported entry types and the exact shape each accepts: + * + * # Person property — match (or exclude) by a person property + * {"key": "email", "type": "person", "value": "@example.com", "operator": "icontains"} + * + * # Event property — match by an event property + * {"key": "$host", "type": "event", "value": "localhost", "operator": "icontains"} + * + * # Cohort membership — match (or exclude) members of a cohort. + * # Use operator "in" for inclusion and "not_in" for exclusion. Do NOT use a + * # `negation` field here — `negation` is specific to cohort *definitions* + * # (the inner sub-filters that build a cohort) and is rejected by the + * # property-filter schema. + * {"key": "id", "type": "cohort", "value": 8814, "operator": "not_in"} + * + * Common operators: "exact", "is_not", "icontains", "not_icontains", "regex", + * "not_regex", "gt", "lt", "gte", "lte", "is_set", "is_not_set", "in", "not_in". + */ + test_account_filters?: unknown; test_account_filters_default_checked?: boolean | null; is_demo?: boolean; timezone?: components["schemas"]["TimezoneEnum"]; @@ -13328,7 +13938,20 @@ export interface components { }; readonly available_setup_task_ids: components["schemas"]["AvailableSetupTaskIdsEnum"][]; }; - TeamCustomerAnalyticsConfig: Record; + TeamCustomerAnalyticsConfig: { + /** @description Event used as the activity signal (DAU/WAU/MAU). */ + activity_event?: unknown; + /** @description Event used to count signup pageviews on dashboards. */ + signup_pageview_event?: unknown; + /** @description Event used to count signups on dashboards. */ + signup_event?: unknown; + /** @description Event used to count subscriptions on dashboards. */ + subscription_event?: unknown; + /** @description Event used to count payments on dashboards. */ + payment_event?: unknown; + /** @description Index of the group type to treat as an Account in customer analytics. Must reference an existing group type configured for the project. */ + account_group_type_index?: number | null; + }; TeamMarketingAnalyticsConfig: { attribution_window_days?: number; attribution_mode?: components["schemas"]["AttributionModeEnum"]; @@ -14038,6 +14661,12 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** TracesQuery */ TracesQuery: { @@ -14175,18 +14804,37 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** TrendsFilter */ TrendsFilter: { - /** @default numeric */ + /** + * @description Y-axis value formatter. Picks a human-friendly unit per value at render time without changing the underlying series values. + * + * - `numeric` (default): raw numbers, e.g. `1,234`. + * - `duration`: values are in seconds; rendered as friendly units per value (`45s`, `2m 12s`, `1h 4m`). Use this whenever the series is in seconds (latency, session length, time-to-event) instead of dividing in `formula` to force minutes or hours. + * - `duration_ms`: values are in milliseconds; rendered as friendly units (`850ms`, `1.5s`, `1m 4s`). + * - `percentage`: values are already in the 0-100 range; appends `%`. + * - `percentage_scaled`: values are a 0-1 ratio; multiplied and rendered as `%`. + * - `currency`: values are in the project's base currency (set in project settings, defaults to USD); rendered with that currency symbol. For values pinned to a specific currency regardless of project base (e.g. `$ai_total_cost_usd` is always USD), use `aggregationAxisPrefix` instead. + * - `short`: compact notation for large counts (`1.2K`, `3.4M`). + * @default numeric + */ aggregationAxisFormat: components["schemas"]["AggregationAxisFormat"] | null; /** * Aggregationaxispostfix + * @description Literal suffix applied to every value (e.g. ` req`). Reserve for units that `aggregationAxisFormat` cannot express. Do not use ` mins`, ` s`, ` ms`, `%` etc. — pick the matching `aggregationAxisFormat` instead so the underlying values stay numerically correct for breakdowns, formulas, and alerts. Include any leading space yourself. * @default null */ aggregationAxisPostfix: string | null; /** * Aggregationaxisprefix + * @description Literal prefix applied to every value (e.g. `$`). Use to pin a unit or currency symbol that does not depend on `aggregationAxisFormat` — for example, when values are denominated in a fixed currency regardless of the project's base currency. Include any trailing space yourself. * @default null */ aggregationAxisPrefix: string | null; @@ -14202,6 +14850,7 @@ export interface components { confidenceLevel: number | null; /** * Decimalplaces + * @description Maximum number of decimal places shown. 1 or 2 is usually right for percentages and currency. * @default null */ decimalPlaces: number | null; @@ -14324,6 +14973,18 @@ export interface components { * @default 1 */ smoothingIntervals: number | null; + /** + * Xaxislabel + * @description Custom label rendered under the X axis. + * @default null + */ + xAxisLabel: string | null; + /** + * Yaxislabel + * @description Custom label rendered alongside the Y axis. + * @default null + */ + yAxisLabel: string | null; /** @default linear */ yAxisScaleType: components["schemas"]["YAxisScaleType"] | null; }; @@ -14351,6 +15012,11 @@ export interface components { * @default null */ breakdownFilter: components["schemas"]["BreakdownFilter"] | null; + /** + * @description Properties specific to the calendar heatmap display variant. Only consulted when `trendsFilter.display === ChartDisplayType.CalendarHeatmap`; ignored otherwise. + * @default null + */ + calendarHeatmapFilter: components["schemas"]["CalendarHeatmapFilter"] | null; /** * @description Compare to date range * @default null @@ -14480,6 +15146,12 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** * UrlMatching @@ -14702,6 +15374,12 @@ export interface components { * @default null */ types: unknown[] | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** WebGoalsQuery */ WebGoalsQuery: { @@ -14786,6 +15464,12 @@ export interface components { * @default null */ useSessionsTable: boolean | null; + /** + * Usewebanalyticsprecompute + * @description Opt this specific query into the web_goals_query precompute path. Requires the `web-analytics-precompute-toggle` PostHog feature flag to be on for the team's organization for the gate to pass. * + * @default null + */ + useWebAnalyticsPrecompute: boolean | null; /** * Version * @description version of the node, used for schema migrations @@ -14857,6 +15541,24 @@ export interface components { * @default null */ types: unknown[] | null; + /** + * Usedlazyprecompute + * @description Whether the response was served from the lazy precompute path. + * @default null + */ + usedLazyPrecompute: boolean | null; + /** + * Usedpreaggregatedtables + * @description Whether the response was served from a precomputed table. + * @default null + */ + usedPreAggregatedTables: boolean | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** WebOverviewItem */ WebOverviewItem: { @@ -14966,6 +15668,12 @@ export interface components { * @default null */ useSessionsTable: boolean | null; + /** + * Usewebanalyticsprecompute + * @description Opt this specific query into the web_overview_query precompute path. Requires the `web-analytics-precompute-toggle` PostHog feature flag to be on for the team's organization for the gate to pass. * + * @default null + */ + useWebAnalyticsPrecompute: boolean | null; /** * Version * @description version of the node, used for schema migrations @@ -15022,11 +15730,22 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Usedlazyprecompute + * @default null + */ + usedLazyPrecompute: boolean | null; /** * Usedpreaggregatedtables * @default null */ usedPreAggregatedTables: boolean | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** * WebStatsBreakdown @@ -15141,6 +15860,12 @@ export interface components { * @default null */ useSessionsTable: boolean | null; + /** + * Usewebanalyticsprecompute + * @description Opt this specific query into the web stats table precompute path. Requires the `web-analytics-precompute-toggle` PostHog feature flag to be on for the team's organization for the gate to pass. * + * @default null + */ + useWebAnalyticsPrecompute: boolean | null; /** * Version * @description version of the node, used for schema migrations @@ -15212,11 +15937,22 @@ export interface components { * @default null */ types: unknown[] | null; + /** + * Usedlazyprecompute + * @default null + */ + usedLazyPrecompute: boolean | null; /** * Usedpreaggregatedtables * @default null */ usedPreAggregatedTables: boolean | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** * WebVitalsMetric @@ -15305,6 +16041,12 @@ export interface components { * @default null */ useSessionsTable: boolean | null; + /** + * Usewebanalyticsprecompute + * @description Opt this specific query into the web vitals path breakdown precompute path. Requires the `web-analytics-precompute-toggle` PostHog feature flag to be on for the team's organization for the gate to pass. * + * @default null + */ + useWebAnalyticsPrecompute: boolean | null; /** * Version * @description version of the node, used for schema migrations @@ -15349,6 +16091,17 @@ export interface components { * @default null */ timings: components["schemas"]["QueryTiming"][] | null; + /** + * Usedlazyprecompute + * @default null + */ + usedLazyPrecompute: boolean | null; + /** + * Warnings + * @description Warnings about data warehouse sources referenced by the query whose latest sync failed, is paused, hit a billing limit, or is otherwise stale. Results may not reflect current source data. Accumulated across every HogQL execution that contributes to this response — so insights backed by warehouse tables (Trends, Funnels, etc.) receive the same warnings as raw HogQL queries. + * @default null + */ + warnings: components["schemas"]["DataWarehouseSyncWarning"][] | null; }; /** WebVitalsPathBreakdownResult */ WebVitalsPathBreakdownResult: { @@ -16261,6 +17014,10 @@ export interface operations { event_definitions_list: { parameters: { query?: { + /** @description When true, omit events that have been explicitly hidden by a team admin (Enterprise only). */ + exclude_hidden?: boolean; + /** @description When true, omit events whose last ingested occurrence is older than 30 days. Events that have never been seen (`last_seen_at` is null) are kept so newly-defined events remain discoverable. Default false. If a search returns zero results with this filter on, retry with `exclude_stale=false` and tell the user the matches are stale. */ + exclude_stale?: boolean; /** @description Number of results to return per page. */ limit?: number; /** @description The initial index from which to return the results. */ @@ -16747,6 +17504,8 @@ export interface operations { offset?: number; /** @description Field to order by. Prefix with '-' for descending. Allowlisted fields include name, created_at, updated_at, start_date, end_date, duration, and status. */ order?: string; + /** @description Filter to experiments created from an LLM prompt with this name. Matches experiments whose parameters.prompt_metadata.name equals the given value. */ + prompt_name?: string; /** @description Free-text search applied to the experiment name (case-insensitive). */ search?: string; /** @description Filter by experiment status. "running" and "paused" are mutually exclusive: "running" returns launched experiments with an active feature flag, "paused" returns launched experiments whose feature flag is deactivated. "complete" is an alias for "stopped". "all" disables status filtering. */