@atribu/node 0.1.0

package/dist/api.d-BXINTQo6.d.cts

@@ -0,0 +1,3547 @@
+/**
+ * HTTP request layer.
+ *
+ * Single entry point for every API call: handles auth headers, timeout via
+ * AbortController, idempotency-key generation, error envelope parsing, and
+ * RetryHint derivation. Resources call `request()` and parse `data` from the
+ * envelope.
+ */
+
+interface RequestOptions {
+    method: "GET" | "POST" | "PATCH" | "DELETE" | "PUT";
+    path: string;
+    query?: Record<string, string | number | boolean | undefined | null>;
+    body?: unknown;
+    /** Form-urlencoded body (used by /oauth/token, /oauth/revoke). */
+    form?: Record<string, string>;
+    /** Override the Authorization header (used by /oauth/* with client-credentials). */
+    authOverride?: string;
+    idempotencyKey?: string;
+    signal?: AbortSignal;
+    /** When true, parse 200-body as RFC 6749/7009 OAuth response shape. */
+    oauthErrorShape?: boolean;
+    /** When true, return raw Response without JSON parse (used by 204 / RFC 7009 empty 200). */
+    expectEmpty?: boolean;
+    /** Extra headers to merge. */
+    headers?: Record<string, string>;
+}
+/**
+ * Minimum surface a transport needs to be usable by resources. Lets us
+ * stack RetryingHttpClient on top of HttpClient without inheritance.
+ */
+interface HttpClientLike {
+    request<T>(opts: RequestOptions): Promise<T>;
+}
+
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+
+interface paths {
+    "/api/v1/overview": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get dashboard overview
+         * @description Returns KPIs (spend, revenue, ROAS, CAC), visitor metrics, and comparison with the previous period of equal length.
+         */
+        get: {
+            parameters: {
+                query: {
+                    date_from: string;
+                    date_to: string;
+                    model?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Overview data */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["OverviewResponse"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Rate limited */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/timeseries": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get daily timeseries data
+         * @description Returns daily visitors, pageviews, bounces, revenue, and spend.
+         */
+        get: {
+            parameters: {
+                query: {
+                    date_from: string;
+                    date_to: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Timeseries data */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                date: string;
+                                visitors: number;
+                                pageviews: number;
+                                bounces: number;
+                                cash_revenue: number;
+                                spend: number;
+                            }[];
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/realtime": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get live visitor count
+         * @description Returns the number of visitors currently online (active in last 5 minutes).
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Realtime data */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                visitors_online: number;
+                            };
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/channels": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get traffic source breakdown
+         * @description Returns channel breakdown with visitors, sessions, pageviews, bounce rate, conversions, and revenue.
+         */
+        get: {
+            parameters: {
+                query: {
+                    date_from: string;
+                    date_to: string;
+                    limit?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Breakdown data */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                value: string;
+                                visitors: number;
+                                visits: number;
+                                pageviews: number;
+                                bounce_rate: number;
+                                conversions: number;
+                                conversion_rate: number;
+                                revenue: number;
+                            }[];
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/pages": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get page performance breakdown
+         * @description Returns page breakdown with visitors, sessions, pageviews, bounce rate, conversions, and revenue.
+         */
+        get: {
+            parameters: {
+                query: {
+                    date_from: string;
+                    date_to: string;
+                    limit?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Breakdown data */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                value: string;
+                                visitors: number;
+                                visits: number;
+                                pageviews: number;
+                                bounce_rate: number;
+                                conversions: number;
+                                conversion_rate: number;
+                                revenue: number;
+                            }[];
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/countries": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get country breakdown
+         * @description Returns country breakdown with visitors, sessions, pageviews, bounce rate, conversions, and revenue.
+         */
+        get: {
+            parameters: {
+                query: {
+                    date_from: string;
+                    date_to: string;
+                    limit?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Breakdown data */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                value: string;
+                                visitors: number;
+                                visits: number;
+                                pageviews: number;
+                                bounce_rate: number;
+                                conversions: number;
+                                conversion_rate: number;
+                                revenue: number;
+                            }[];
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/devices": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get device type breakdown
+         * @description Returns device breakdown with visitors, sessions, pageviews, bounce rate, conversions, and revenue.
+         */
+        get: {
+            parameters: {
+                query: {
+                    date_from: string;
+                    date_to: string;
+                    limit?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Breakdown data */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                value: string;
+                                visitors: number;
+                                visits: number;
+                                pageviews: number;
+                                bounce_rate: number;
+                                conversions: number;
+                                conversion_rate: number;
+                                revenue: number;
+                            }[];
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/browsers": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get browser breakdown
+         * @description Returns browser breakdown with visitors, sessions, pageviews, bounce rate, conversions, and revenue.
+         */
+        get: {
+            parameters: {
+                query: {
+                    date_from: string;
+                    date_to: string;
+                    limit?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Breakdown data */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                value: string;
+                                visitors: number;
+                                visits: number;
+                                pageviews: number;
+                                bounce_rate: number;
+                                conversions: number;
+                                conversion_rate: number;
+                                revenue: number;
+                            }[];
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/os": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get operating system breakdown
+         * @description Returns os breakdown with visitors, sessions, pageviews, bounce rate, conversions, and revenue.
+         */
+        get: {
+            parameters: {
+                query: {
+                    date_from: string;
+                    date_to: string;
+                    limit?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Breakdown data */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                value: string;
+                                visitors: number;
+                                visits: number;
+                                pageviews: number;
+                                bounce_rate: number;
+                                conversions: number;
+                                conversion_rate: number;
+                                revenue: number;
+                            }[];
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/referrers": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get referrer breakdown
+         * @description Returns referrer breakdown with visitors, sessions, pageviews, bounce rate, conversions, and revenue.
+         */
+        get: {
+            parameters: {
+                query: {
+                    date_from: string;
+                    date_to: string;
+                    limit?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Breakdown data */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                value: string;
+                                visitors: number;
+                                visits: number;
+                                pageviews: number;
+                                bounce_rate: number;
+                                conversions: number;
+                                conversion_rate: number;
+                                revenue: number;
+                            }[];
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/campaigns": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get campaign performance
+         * @description Returns top campaigns with ROAS and attribution data. Add `level=ad_set` or `level=ad` for granular breakdowns.
+         */
+        get: {
+            parameters: {
+                query: {
+                    date_from: string;
+                    date_to: string;
+                    model?: string;
+                    limit?: string;
+                    level?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Campaign data */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                campaign_id: string;
+                                campaign_name: string;
+                                spend: number;
+                                outcome_count: number;
+                                outcome_value: number;
+                                roas: number;
+                            }[];
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/campaigns/trend": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get daily campaign trend
+         * @description Returns daily spend, impressions, and clicks for specific campaigns/ad sets/ads.
+         */
+        get: {
+            parameters: {
+                query: {
+                    date_from: string;
+                    date_to: string;
+                    entity_ids: string;
+                    level?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Trend data */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                entity_id: string;
+                                date: string;
+                                spend: number;
+                                impressions: number;
+                                clicks: number;
+                            }[];
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/top-performers": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get the profile's top-performing ads (cohort-normalized creative scoring)
+         * @description Best ads scored against *comparable* creative (a cohort = channel × format × objective × audience warmth × geo × placement): cohort-normalized, empirical-Bayes-smoothed (small-sample ads shrink toward the cohort mean), and maturity-staged. Each ad carries THREE distinct measures — present them separately, never merge: `composite_score` (0–100, a transparent rule blend), `top_performer_likelihood` (0–1, a probability — a *likelihood, not a guarantee*; the calibrated ML-ranker output when `score_source='model'` with `model_version` set, else a monotone function of `composite_score`; never ROAS), and `attributed_revenue`/`roas` (real cash attribution, present when `truth_grade='attributed'`). `maturity_stage` (cold→early→mature→calibrated) says how settled the score is; `reason_codes` explain which funnel layer is strong/weak with a sample-confidence band. Scores refresh on a daily cadence. `window` is a rolling lookback (`7d`/`14d`/`28d`/`lifetime`), not a custom date range. The workspace-wide cross-profile view is exposed via the Atribu MCP server's `top_workspace_performers` tool.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    window?: "7d" | "14d" | "28d" | "lifetime";
+                    limit?: string;
+                    min_spend?: string;
+                    objectives?: string;
+                    truth_grades?: string;
+                    formats?: string;
+                    has_video?: "true" | "false";
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Top performers */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                ad_external_id: string;
+                                ad_name: string | null;
+                                campaign_name: string | null;
+                                ad_set_name: string | null;
+                                creative_thumbnail_url: string | null;
+                                video_id: string | null;
+                                score_window: string;
+                                composite_score: number | null;
+                                top_performer_likelihood: number | null;
+                                model_version: number | null;
+                                /** @enum {string} */
+                                score_source: "model" | "rules";
+                                maturity_stage: string;
+                                truth_grade: string;
+                                primary_outcome_kind: string;
+                                cohort_key: string | null;
+                                cohort_objective: string | null;
+                                cohort_format: string | null;
+                                cohort_audience_warmth: string | null;
+                                cohort_n_ads: number;
+                                hook_type: string | null;
+                                creative_format: string | null;
+                                cta_type: string | null;
+                                primary_angle: string | null;
+                                offers: string[];
+                                spend: number;
+                                impressions: number;
+                                ctr: number;
+                                cpc: number | null;
+                                attributed_cash_outcomes: number;
+                                attributed_revenue: number;
+                                roas: number | null;
+                                cac: number | null;
+                                attributed_outcomes_total: number;
+                                attributed_pipeline_outcomes: number;
+                                attributed_pipeline_value: number;
+                                meta_reported_conversions: number;
+                                meta_reported_conversion_value: number;
+                                cost_per_conversation: number | null;
+                                messaging_conversations_started: number;
+                                first_reply_rate: number | null;
+                                avg_engagement_score: number | null;
+                                reason_codes: {
+                                    layer: string;
+                                    /** @enum {string} */
+                                    polarity: "strength" | "weakness" | "forecast" | "fatigue";
+                                    percentile: number | null;
+                                    /** @enum {string} */
+                                    sample_confidence: "low" | "medium" | "high";
+                                    code?: string;
+                                    metric_value?: number | null;
+                                }[];
+                                forecast_outcomes_7d: number | null;
+                                forecast_outcomes_7d_low: number | null;
+                                forecast_outcomes_7d_high: number | null;
+                                /** @enum {string|null} */
+                                forecast_confidence: "low" | "medium" | "high" | null;
+                                hazard_30d_pause: number | null;
+                                hazard_30d_degradation: number | null;
+                                /** @enum {string|null} */
+                                fatigue_state: "active" | "paused" | "degraded" | null;
+                                /** @enum {string|null} */
+                                fatigue_risk_tier: "low" | "medium" | "high" | "critical" | null;
+                                expected_lifespan_days: number | null;
+                            }[];
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/creative-patterns": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Workspace creative pattern miner (Phase 2.7)
+         * @description Which structural creative patterns (archetype cluster, narrative arc, dominant-third role combo, role presence signature, social-proof duration bucket, hook×claim×cta) win MORE than the workspace baseline. One row per (pattern_dim, pattern_value) with sample_n, winner_n, win_rate, workspace_baseline_win_rate, lift_vs_workspace, Wilson 95% CI bounds, and the top-5 exemplar ads embodying the pattern. Filtered to the API key's profile via the workspace RPC's profile_ids filter. Pair with /top-performers for cash impact per ad.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    window?: "7d" | "14d" | "28d" | "lifetime";
+                    min_cluster_size?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Creative patterns */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                patterns: {
+                                    pattern_dim: string;
+                                    pattern_value: string | null;
+                                    pattern_label: string | null;
+                                    pattern_description: string | null;
+                                    pattern_winning_signal: string | null;
+                                    sample_n: number;
+                                    winner_n: number;
+                                    win_rate: number | null;
+                                    workspace_baseline_win_rate: number | null;
+                                    lift_vs_workspace: number | null;
+                                    confidence_interval_low: number | null;
+                                    confidence_interval_high: number | null;
+                                    exemplar_ad_external_ids: string[];
+                                }[];
+                                score_window: string;
+                                min_cluster_size: number;
+                            };
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/archetypes": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Workspace creative archetype summary (Phase 2.7)
+         * @description Workspace-level archetype headline: 'these are your creative clusters, named and ranked by lift.' One row per archetype_cluster with LLM-generated label/description/winning_signal, win-rate vs workspace baseline, Wilson 95% CI bounds, and top-5 exemplars. Archetypes are workspace-grain (cross-profile cohort percentiles); the response is NOT profile-scoped.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    window?: "7d" | "14d" | "28d" | "lifetime";
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Archetype summary */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                archetypes: {
+                                    archetype_cluster: number;
+                                    label: string | null;
+                                    description: string | null;
+                                    winning_signal: string | null;
+                                    n_ads: number;
+                                    n_winners: number;
+                                    win_rate: number | null;
+                                    workspace_baseline_win_rate: number | null;
+                                    lift_vs_workspace: number | null;
+                                    confidence_interval_low: number | null;
+                                    confidence_interval_high: number | null;
+                                    exemplar_ad_external_ids: string[];
+                                }[];
+                                score_window: string;
+                            };
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/ads/funnel-diagnosis": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Per-ad funnel diagnosis (Phase 2.8)
+         * @description Per-ad funnel-layer percentile breakdown — delivery, attention, retention, click_intent, postclick_messaging, attributed_revenue, platform_diagnostics. Each layer carries the ad's percentile within its cohort, the smoothed metric, sample_n, weakest-layer flag, diagnostic codes (e.g. retention_below_p25_at_mature_stage), and a recommended_priority — one of: fix_offer_or_audience, fix_landing_or_offer, fix_hook, improve_creative_clarity, increase_spend, rework_offer_or_landing, maintain. Cold-maturity ads with spend < $50 return 'increase_spend' (the 'spend_below_learning_phase' code). When the ad has no per-layer percentiles yet but at least one diagnostic_code applies, the response contains a single layer='no_data' row carrying the codes + recommended_priority. Scope: campaigns:read.
+         */
+        get: {
+            parameters: {
+                query: {
+                    ad_external_id: string;
+                    window?: "7d" | "14d" | "28d" | "lifetime";
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Funnel diagnosis */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                ad_external_id: string;
+                                score_window: string;
+                                weakest_layer: string | null;
+                                recommended_priority: string;
+                                layers: {
+                                    layer: string;
+                                    percentile: number | null;
+                                    smoothed_metric: number | null;
+                                    sample_n: number | null;
+                                    is_weakest_layer: boolean;
+                                    diagnostic_codes: string[];
+                                    recommended_priority: string;
+                                    maturity_stage: string | null;
+                                    truth_grade: string | null;
+                                }[];
+                            };
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/ads/compare": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Compare two ads by feature contributions (Phase 2.8)
+         * @description Returns the top-N features most responsible for the gap between two ads' rankings, sorted by |model_contribution_a − model_contribution_b|. Each row has the feature name, raw values for A and B, the numeric delta, and per-ad model contributions sourced from `model_feature_contributions`.
+         */
+        get: {
+            parameters: {
+                query: {
+                    ad_a: string;
+                    ad_b: string;
+                    window?: "7d" | "14d" | "28d" | "lifetime";
+                    top_n?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Feature comparison */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                ad_external_id_a: string;
+                                ad_external_id_b: string;
+                                score_window: string;
+                                features: {
+                                    feature_name: string;
+                                    value_a: string | null;
+                                    value_b: string | null;
+                                    delta: number | null;
+                                    model_contribution_a: number | null;
+                                    model_contribution_b: number | null;
+                                    contribution_delta_abs: number | null;
+                                }[];
+                            };
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/ads/trajectory": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Per-ad daily history trajectory (Phase 2.8)
+         * @description Daily snapshot rows for one ad from `creative_feature_store_history`. Each snapshot carries spend, smoothed funnel-layer percentiles, composite_score, maturity_stage, truth_grade, and delta_composite_vs_prev. Backs charts of how an ad's performance evolves over time. Default 60 days back, max 365.
+         */
+        get: {
+            parameters: {
+                query: {
+                    ad_external_id: string;
+                    window?: "7d" | "14d" | "28d" | "lifetime";
+                    days_back?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Ad trajectory */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                ad_external_id: string;
+                                score_window: string;
+                                days_back: number;
+                                points: {
+                                    snapshot_date: string;
+                                    spend: number | null;
+                                    impressions: number | null;
+                                    clicks: number | null;
+                                    ctr: number | null;
+                                    smoothed_hook_rate: number | null;
+                                    smoothed_retention_rate: number | null;
+                                    smoothed_ctr: number | null;
+                                    smoothed_roas: number | null;
+                                    pct_delivery: number | null;
+                                    pct_attention: number | null;
+                                    pct_retention: number | null;
+                                    pct_click_intent: number | null;
+                                    pct_attributed_revenue: number | null;
+                                    attributed_revenue: number | null;
+                                    attributed_outcomes_total: number | null;
+                                    messaging_conversations_started: number | null;
+                                    refund_rate: number | null;
+                                    composite_score: number | null;
+                                    maturity_stage: string | null;
+                                    truth_grade: string | null;
+                                    primary_outcome_kind: string | null;
+                                    delta_composite_vs_prev: number | null;
+                                }[];
+                            };
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/ads/fatigue-risk": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Workspace fatigue risk ranking (Phase 4)
+         * @description Returns ads at predicted fatigue risk (high/critical tier only, fatigue_state='active') ranked by `hazard_30d_pause × spend` — the projected budget at risk if each ad pauses within 30 days. The Cox cause-specific 30-day pause probability is a *likelihood, not a guarantee*. Excludes already paused/degraded ads (those are observed states surfaced separately). Each row carries `fatigue_risk_tier`, `hazard_30d_pause`, `hazard_30d_degradation` (when the degradation cause has trained, else null), `expected_lifespan_days` (trapezoidal E[T] from the survival curve), and `risk_rank_score`. Models retrain weekly.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Default '28d' */
+                    score_window?: "7d" | "14d" | "28d" | "lifetime";
+                    /** @description Top N ads (default 20, max 50) */
+                    top?: string;
+                    /** @description Minimum spend filter (default 100; pass 0 to include all) */
+                    min_spend?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Workspace fatigue risk ranking */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                score_window: string;
+                                top_n: number;
+                                min_spend: number;
+                                ads: {
+                                    [key: string]: unknown;
+                                }[];
+                            };
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/forecast-outlook": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Workspace portfolio forecast outlook (Phase 4)
+         * @description Portfolio-grain forecast for the next 7 days. Returns one document with: projected total impressions + attributed outcomes (with 80% prediction-interval bands from split-conformal calibration — calibrated coverage bands, not Gaussian σ), projected average cost-per-outcome, the counts of `n_emerging_top_performers` (climbing ads with strong forecasts) and `n_at_risk_top_performers` (currently top-tier ads in high/critical fatigue), per-tier fatigue histograms, and `projected_budget_at_risk` (total spend across high+critical fatigue ads). Use as the first 'what's the week ahead' lookup.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Default '28d' */
+                    score_window?: "7d" | "14d" | "28d" | "lifetime";
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Portfolio outlook (single document) */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                [key: string]: unknown;
+                            };
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/ads/forecast": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Per-ad forecast + fatigue + 14d trajectory (Phase 4 / F-3)
+         * @description Returns one creative_feature_store row for the (workspace, profile, ad_external_id) tuple plus the last 14 days of daily delivery and any lifecycle events. The `cfs` object carries the Phase-4 forecast cols (forecast_outcomes_7d/_low/_high, forecast_confidence) and the fatigue cols (hazard_30d_pause, hazard_30d_degradation, expected_lifespan_days, fatigue_state, fatigue_risk_tier). All Phase-4 cols are NULL when the prediction-pass cron hasn't scored the ad (cold-start, paused, ML_FORECAST_AND_FATIGUE_ENABLED off). Query-param convention (audit B-7).
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description The ad's external id (Meta ad id / Google ads id) */
+                    ad_external_id: string;
+                    /** @description Default '28d' */
+                    score_window?: "7d" | "14d" | "28d" | "lifetime";
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Ad forecast detail */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                ad_external_id: string;
+                                score_window: string;
+                                cfs: {
+                                    [key: string]: unknown;
+                                } | null;
+                                trajectory_last_14d: {
+                                    day: string;
+                                    spend: number;
+                                    impressions: number;
+                                    clicks: number;
+                                }[];
+                                lifecycle_history: {
+                                    event_date: string;
+                                    event_type: string;
+                                    lifecycle_seq: number;
+                                }[];
+                            };
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/ads/forecast/scenarios": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Per-ad what-if forecast scenarios (Phase 4 / F-3)
+         * @description Feeds modified spend / frequency overrides back through the active outcomes-head forecaster and returns the projected 7-day outcomes count per scenario, with 80% conformal PI bands. The `out_of_range` flag goes true when a scenario's spend is > 2x or < 0.5x the ad's current trailing-7d spend — the model is extrapolating beyond its training distribution; treat the result as directional only. Up to 5 scenarios per call. Returns base=null + per-scenario `gated_reason` when the ad is cold-start / paused / has no active forecaster model.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        ad_external_id: string;
+                        /** @enum {string} */
+                        score_window?: "7d" | "14d" | "28d" | "lifetime";
+                        scenarios: {
+                            name: string;
+                            spend_7d_override?: number;
+                            frequency_override?: number;
+                        }[];
+                    };
+                };
+            };
+            responses: {
+                /** @description Per-scenario projection */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                ad_external_id: string;
+                                score_window: string | null;
+                                cohort_variant?: string;
+                                base_trailing_7d_spend?: number;
+                                base: {
+                                    point: number;
+                                    low: number;
+                                    high: number;
+                                    /** @enum {string} */
+                                    confidence: "low" | "medium" | "high";
+                                } | null;
+                                scenarios: {
+                                    name: string;
+                                    point: number | null;
+                                    low: number | null;
+                                    high: number | null;
+                                    /** @enum {string} */
+                                    confidence: "low" | "medium" | "high";
+                                    delta_from_base: number;
+                                    out_of_range: boolean;
+                                    gated_reason?: string;
+                                }[];
+                            };
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/conversions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get conversion counts by type
+         * @description Returns counts of each conversion type (lead_created, payment_received, etc.).
+         */
+        get: {
+            parameters: {
+                query: {
+                    date_from: string;
+                    date_to: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Conversion data */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                event_type: string;
+                                count: number;
+                            }[];
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/conversions/timeseries": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get daily conversion counts
+         * @description Returns daily conversion counts broken down by event type.
+         */
+        get: {
+            parameters: {
+                query: {
+                    date_from: string;
+                    date_to: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Conversion timeseries */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                date: string;
+                                event_type: string;
+                                count: number;
+                            }[];
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/revenue": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get daily revenue and spend
+         * @description Returns attributed revenue (cash only) and ad spend per day.
+         */
+        get: {
+            parameters: {
+                query: {
+                    date_from: string;
+                    date_to: string;
+                    model?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Revenue data */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                date: string;
+                                revenue: number;
+                                spend: number;
+                            }[];
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/revenue/cash": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get cash collected by source
+         * @description Returns total cash payments grouped by payment source (Stripe, MercadoPago) and currency.
+         */
+        get: {
+            parameters: {
+                query: {
+                    date_from: string;
+                    date_to: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Cash data */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                source: string;
+                                currency: string;
+                                total: number;
+                                count: number;
+                            }[];
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/quality": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get attribution data quality
+         * @description Returns metrics on UTM tracking coverage and attribution quality.
+         */
+        get: {
+            parameters: {
+                query: {
+                    date_from: string;
+                    date_to: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Quality data */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                total_events: number;
+                                with_full_utms: number;
+                                with_fbclid_only: number;
+                                with_no_tracking: number;
+                                coverage_percent: number;
+                            };
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/customers": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get customer conversions
+         * @description Paginated list of customers who achieved a goal. Requires `customers:read` scope. Returns PII (name, email).
+         */
+        get: {
+            parameters: {
+                query: {
+                    date_from: string;
+                    date_to: string;
+                    goal: string;
+                    search?: string;
+                    limit?: string;
+                    cursor_time?: string;
+                    cursor_id?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Customer list */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                conversion_id: string;
+                                customer_profile_id: string | null;
+                                name: string | null;
+                                email: string | null;
+                                country: string | null;
+                                device: string | null;
+                                channel: string | null;
+                                source: string | null;
+                                revenue: number;
+                                revenue_type: string;
+                                conversion_time: string;
+                                time_to_complete_seconds: number;
+                                touch_count: number;
+                                touch_channels: string[];
+                                conversion_count: number;
+                                total_revenue: number;
+                            }[];
+                            pagination: components["schemas"]["Pagination"];
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/customers/{id}/journey": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get customer journey timeline
+         * @description Full event timeline for a single customer (page views, form fills, payments, etc.). Returns empty data if the customer does not belong to this profile. Requires `customers:read` scope.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    cursor?: string;
+                    limit?: string;
+                };
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Journey data */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                event_type: string;
+                                event_name: string;
+                                event_time: string;
+                                url: string | null;
+                                path: string | null;
+                                channel: string | null;
+                                source: string | null;
+                                medium: string | null;
+                                campaign: string | null;
+                                value_amount: number | null;
+                                currency: string | null;
+                                device: string | null;
+                                browser: string | null;
+                                os: string | null;
+                                country: string | null;
+                                city: string | null;
+                                is_synthetic: boolean;
+                            }[];
+                            pagination: components["schemas"]["Pagination"];
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/visitors": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get visitor list
+         * @description Paginated list of all visitors (identified and anonymous). Requires `visitors:read` scope.
+         */
+        get: {
+            parameters: {
+                query: {
+                    date_from: string;
+                    date_to: string;
+                    search?: string;
+                    limit?: string;
+                    cursor_time?: string;
+                    cursor_id?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Visitor list */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                visitor_id: string;
+                                customer_profile_id: string | null;
+                                name: string | null;
+                                email: string | null;
+                                country: string | null;
+                                device: string | null;
+                                browser: string | null;
+                                os: string | null;
+                                channel: string | null;
+                                source: string | null;
+                                total_revenue: number;
+                                last_seen_at: string;
+                                session_count: number;
+                                total_pageviews: number;
+                                touch_channels: string[];
+                            }[];
+                            pagination: components["schemas"]["Pagination"];
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/keywords": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get search keywords
+         * @description Returns Google Search Console keyword data (impressions, clicks, CTR, position).
+         */
+        get: {
+            parameters: {
+                query: {
+                    date_from: string;
+                    date_to: string;
+                    limit?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Keyword data */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                keyword: string;
+                                impressions: number;
+                                clicks: number;
+                                ctr: number;
+                                avg_position: number;
+                            }[];
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Ingest a custom event
+         * @description Submit a custom event for tracking. Use the `Idempotency-Key` header or `idempotency_key` field to prevent duplicates. Returns 202 Accepted.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        /** @example custom_signup */
+                        event_name: string;
+                        anonymous_id?: string;
+                        session_id?: string;
+                        /** @example 2026-03-25T10:00:00Z */
+                        timestamp?: string;
+                        properties?: {
+                            [key: string]: unknown;
+                        };
+                        user_traits?: {
+                            email?: string;
+                            phone?: string;
+                            first_name?: string;
+                            last_name?: string;
+                        };
+                        utm?: {
+                            source?: string;
+                            medium?: string;
+                            campaign?: string;
+                            content?: string;
+                            term?: string;
+                        };
+                        idempotency_key?: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Event accepted */
+                202: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                event_id: string;
+                                status: string;
+                            };
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/goals": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List conversion goals
+         * @description Returns all conversion definitions for this profile.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Goal list */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                id: string;
+                                display_name: string;
+                                conversion_key: string;
+                                source_event_names: string[];
+                                revenue_type: string;
+                                attribution_eligible: boolean;
+                            }[];
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        /**
+         * Create a conversion goal
+         * @description Creates a new conversion definition that maps event types to conversion metrics.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        /** @example Trial Signup */
+                        name: string;
+                        /**
+                         * @example [
+                         *       "trial_started"
+                         *     ]
+                         */
+                        source_event_names: string[];
+                        /** @enum {string} */
+                        revenue_type: "cash" | "pipeline" | "gross";
+                        attribution_eligible?: boolean;
+                    };
+                };
+            };
+            responses: {
+                /** @description Goal created */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                id: string;
+                                display_name: string;
+                                conversion_key: string;
+                            };
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        /**
+         * Delete a conversion goal
+         * @description Deletes a conversion definition by ID. Pass `id` as a query parameter.
+         */
+        delete: {
+            parameters: {
+                query: {
+                    id: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Goal deleted */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                deleted: boolean;
+                            };
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/attribution/recompute": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Trigger attribution recompute
+         * @description Queues a full attribution recompute for this profile. Returns 202 Accepted. Heavy endpoint — rate limited to prevent abuse.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Recompute queued */
+                202: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                status: string;
+                                message: string;
+                            };
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/messages": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Send a channel-agnostic message
+         * @description Sends a WhatsApp or Instagram message via a connected `data_connection`. Requires the `whatsapp` or `instagram` scope on the API key (matching the `channel`). For keys minted through the OAuth provider flow, an active `oauth_app_authorizations` row must also exist for the (app, profile, data_connection).
+         *
+         *     **WhatsApp media (image/video/audio/document)** accepts either `media.media_id` (pre-uploaded via Meta's `/media` endpoint, 30-day cache) or `media.link` (public HTTPS URL Meta fetches once per send — no caching, size caps enforced). High-fanout sends should pre-upload.
+         *
+         *     **Instagram image** accepts `image_url` directly (Meta downloads the URL). Quick replies are IG-only.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        connection_id: string;
+                        /** @enum {string} */
+                        channel: "whatsapp" | "instagram";
+                        /** @description E.164 phone for WhatsApp; IGSID for Instagram. */
+                        to: string;
+                        content: {
+                            /** @enum {string} */
+                            type: "text";
+                            /** @description Up to 4096 chars. */
+                            text: string;
+                        } | {
+                            /** @enum {string} */
+                            type: "template";
+                            template_name: string;
+                            language_code: string;
+                            components?: {
+                                [key: string]: unknown;
+                            }[];
+                        } | {
+                            /** @enum {string} */
+                            type: "image";
+                            /**
+                             * Format: uri
+                             * @description Instagram path.
+                             */
+                            image_url?: string;
+                            /** @description WhatsApp path — either media_id or link. */
+                            media?: {
+                                /** @description Pre-uploaded handle from POST /{phone-number-id}/media. Valid 30 days. Meta-cached. */
+                                media_id?: string;
+                                /**
+                                 * Format: uri
+                                 * @description Publicly accessible HTTPS URL. Meta fetches at send-time; no auth, no caching, size caps enforced server-side.
+                                 */
+                                link?: string;
+                            };
+                            caption?: string;
+                        } | {
+                            /** @enum {string} */
+                            type: "video";
+                            media: {
+                                /** @description Pre-uploaded handle from POST /{phone-number-id}/media. Valid 30 days. Meta-cached. */
+                                media_id?: string;
+                                /**
+                                 * Format: uri
+                                 * @description Publicly accessible HTTPS URL. Meta fetches at send-time; no auth, no caching, size caps enforced server-side.
+                                 */
+                                link?: string;
+                            };
+                            caption?: string;
+                        } | {
+                            /** @enum {string} */
+                            type: "audio";
+                            media: {
+                                /** @description Pre-uploaded handle from POST /{phone-number-id}/media. Valid 30 days. Meta-cached. */
+                                media_id?: string;
+                                /**
+                                 * Format: uri
+                                 * @description Publicly accessible HTTPS URL. Meta fetches at send-time; no auth, no caching, size caps enforced server-side.
+                                 */
+                                link?: string;
+                            };
+                        } | {
+                            /** @enum {string} */
+                            type: "document";
+                            media: {
+                                /** @description Pre-uploaded handle from POST /{phone-number-id}/media. Valid 30 days. Meta-cached. */
+                                media_id?: string;
+                                /**
+                                 * Format: uri
+                                 * @description Publicly accessible HTTPS URL. Meta fetches at send-time; no auth, no caching, size caps enforced server-side.
+                                 */
+                                link?: string;
+                            };
+                            filename: string;
+                            caption?: string;
+                        } | {
+                            /** @enum {string} */
+                            type: "quick_replies";
+                            text: string;
+                            quick_replies: {
+                                title: string;
+                                payload: string;
+                            }[];
+                        };
+                    };
+                };
+            };
+            responses: {
+                /** @description Message sent */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                /** Format: uuid */
+                                connection_id: string;
+                                /** @enum {string} */
+                                channel: "whatsapp" | "instagram";
+                                to: string;
+                                provider_message_id: string;
+                                sent_at: string;
+                            };
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+                /** @description Missing scope or OAuth-app not authorized for this connection */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Connection not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Connection not ready (status != connected) */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Validation error (content shape unsupported for this channel) */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Upstream Meta send failed */
+                502: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/comments/{comment_id}/private-reply": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Send a DM to the user who left an IG comment
+         * @description Targets Meta's `recipient.comment_id` send path — the message lands as a DM in the comment-to-DM thread. Requires `instagram` scope.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    comment_id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        connection_id: string;
+                        text: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Private reply sent */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                comment_id: string;
+                                /** @enum {string} */
+                                kind: "private_reply" | "public_reply";
+                                /** Format: uuid */
+                                connection_id: string;
+                                provider_message_id: string;
+                                sent_at: string;
+                            };
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+                /** @description Missing scope or unauthorized connection */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Connection not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/comments/{comment_id}/reply": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Post a public reply on an IG comment thread
+         * @description Posts directly to `/<comment-id>/replies` — visible to everyone, not a DM. Requires `instagram` scope.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    comment_id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        connection_id: string;
+                        text: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Public reply posted */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                comment_id: string;
+                                /** @enum {string} */
+                                kind: "private_reply" | "public_reply";
+                                /** Format: uuid */
+                                connection_id: string;
+                                provider_message_id: string;
+                                sent_at: string;
+                            };
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+                /** @description Missing scope or unauthorized connection */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Connection not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/webhooks/subscriptions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List webhook subscriptions
+         * @description Returns the subscriptions owned by the calling OAuth app for the calling profile. At most one subscription per (app, profile) today.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Subscriptions list */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                /** Format: uuid */
+                                id: string;
+                                /** Format: uuid */
+                                app_id: string;
+                                /** Format: uuid */
+                                profile_id: string;
+                                /** Format: uri */
+                                url: string;
+                                events: string[];
+                                providers: string[];
+                                /** @enum {string} */
+                                status: "active" | "paused" | "failed";
+                                last_delivery_at: string | null;
+                                consecutive_failures: number;
+                                previous_secret_expires_at: string | null;
+                                created_at: string;
+                                updated_at: string;
+                            }[];
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+                /** @description Endpoint is only available to OAuth-flow-minted keys */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        /**
+         * Create a webhook subscription
+         * @description Creates a webhook subscription. The HMAC `secret` is returned ONCE in the response body and never again — persist it on your side. Atribu signs every outbound event as `X-Atribu-Signature: t=<unix>,v1=<hex_hmac_sha256>` over `<ts>.<body>`.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        /**
+                         * Format: uri
+                         * @description HTTPS URL where Atribu will POST signed events.
+                         */
+                        url: string;
+                        events: ("message.received" | "message.delivery" | "conversation.started")[];
+                        providers: ("whatsapp" | "instagram")[];
+                    };
+                };
+            };
+            responses: {
+                /** @description Subscription created; `secret` field shown once */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                /** Format: uuid */
+                                id: string;
+                                /** Format: uuid */
+                                app_id: string;
+                                /** Format: uuid */
+                                profile_id: string;
+                                /** Format: uri */
+                                url: string;
+                                events: string[];
+                                providers: string[];
+                                /** @enum {string} */
+                                status: "active" | "paused" | "failed";
+                                last_delivery_at: string | null;
+                                consecutive_failures: number;
+                                previous_secret_expires_at: string | null;
+                                created_at: string;
+                                updated_at: string;
+                                secret: string;
+                            };
+                        };
+                    };
+                };
+                /** @description A subscription already exists for this (app, profile) */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/webhooks/subscriptions/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete a webhook subscription
+         * @description Hard-deletes the subscription. Existing `webhook_deliveries` audit rows cascade via FK ON DELETE CASCADE.
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Subscription deleted */
+                204: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Subscription not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        options?: never;
+        head?: never;
+        /**
+         * Update a webhook subscription
+         * @description Update `url`, `events`, `providers`, or `status` (active/paused). At least one field is required.
+         */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        /** Format: uri */
+                        url?: string;
+                        events?: string[];
+                        providers?: string[];
+                        /** @enum {string} */
+                        status?: "active" | "paused";
+                    };
+                };
+            };
+            responses: {
+                /** @description Subscription updated */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                /** Format: uuid */
+                                id: string;
+                                /** Format: uuid */
+                                app_id: string;
+                                /** Format: uuid */
+                                profile_id: string;
+                                /** Format: uri */
+                                url: string;
+                                events: string[];
+                                providers: string[];
+                                /** @enum {string} */
+                                status: "active" | "paused" | "failed";
+                                last_delivery_at: string | null;
+                                consecutive_failures: number;
+                                previous_secret_expires_at: string | null;
+                                created_at: string;
+                                updated_at: string;
+                            };
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+                /** @description Subscription not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        trace?: never;
+    };
+    "/api/v1/webhooks/subscriptions/{id}/rotate-secret": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Rotate a subscription's HMAC secret
+         * @description Generates a fresh HMAC secret and atomically rolls current→previous with a grace window (default 7d, max 90d). **Important: deploy dual-verify on your side BEFORE calling this** — Atribu starts signing with the new secret immediately. The previous secret stays in DB only so subscribers can dual-verify during their deploy.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        grace_days?: number;
+                    };
+                };
+            };
+            responses: {
+                /** @description New secret returned once */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                /** Format: uuid */
+                                subscription_id: string;
+                                secret: string;
+                                grace_days: number;
+                                previous_secret_expires_at: string;
+                            };
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/webhooks/test/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Fire a synthetic test event
+         * @description Enqueues a synthetic `message.received` event onto the outbound queue for the subscription. Subscriber receives a fully-signed POST so signature + payload handling can be verified before the first real inbound event.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Synthetic event enqueued */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                enqueued: boolean;
+                                /** Format: uuid */
+                                event_id: string;
+                                /** Format: uuid */
+                                subscription_id: string;
+                            };
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/webhooks/deliveries/{id}/replay": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Replay a webhook delivery
+         * @description Re-enqueues the payload from an existing `webhook_deliveries` row. The original `event.id` is preserved so subscribers can de-dup the replay. Only the OAuth app that owns the subscription can replay.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Replay queued */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                enqueued: boolean;
+                                /** Format: uuid */
+                                delivery_id: string;
+                                /** Format: uuid */
+                                event_id: string;
+                                /** Format: uuid */
+                                subscription_id: string;
+                            };
+                            meta: components["schemas"]["Meta"];
+                        };
+                    };
+                };
+                /** @description Delivery or subscription not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/oauth/token": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * OAuth 2.0 authorization_code grant exchange
+         * @description RFC 6749 §4.1.3 token endpoint. Exchanges a single-use `code` (issued at `/oauth/authorize` consent) for an Atribu API key. Accepts both `application/x-www-form-urlencoded` (spec-default) and `application/json` bodies. Client authentication: `client_secret_basic` (`Authorization: Basic <base64(id:secret)>`) OR `client_secret_post` (`client_id` + `client_secret` in body).
+         *
+         *     Returns `Cache-Control: no-store` per RFC.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/x-www-form-urlencoded": {
+                        /** @enum {string} */
+                        grant_type: "authorization_code";
+                        code: string;
+                        /** Format: uri */
+                        redirect_uri: string;
+                        /** @description Required when not using `Authorization: Basic`. */
+                        client_id?: string;
+                        /** @description Required when not using `Authorization: Basic`. */
+                        client_secret?: string;
+                        /** @description PKCE verifier (RFC 7636). Required when the authorize step sent a `code_challenge`. */
+                        code_verifier?: string;
+                    };
+                    "application/json": {
+                        /** @enum {string} */
+                        grant_type: "authorization_code";
+                        code: string;
+                        /** Format: uri */
+                        redirect_uri: string;
+                        /** @description Required when not using `Authorization: Basic`. */
+                        client_id?: string;
+                        /** @description Required when not using `Authorization: Basic`. */
+                        client_secret?: string;
+                        /** @description PKCE verifier (RFC 7636). Required when the authorize step sent a `code_challenge`. */
+                        code_verifier?: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Code exchanged successfully */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description The minted Atribu API key (`atb_live_...`). Use as `Authorization: Bearer <token>` on `/api/v1/*` calls. */
+                            access_token: string;
+                            /** @enum {string} */
+                            token_type: "bearer";
+                            /** @description Space-separated scopes. Subset of `whatsapp instagram` today. */
+                            scope: string;
+                            /**
+                             * Format: uuid
+                             * @description UUID of the `data_connections` row the user authorized. Pass on `POST /api/v1/messages`.
+                             */
+                            connection_id?: string;
+                            /** Format: uuid */
+                            profile_id: string;
+                            /** Format: uuid */
+                            workspace_id: string;
+                        };
+                    };
+                };
+                /** @description `invalid_grant` / `invalid_request` / `unsupported_grant_type` */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description RFC 6749 §5.2 / RFC 7009 §2.2.1 error code. */
+                            error: string;
+                            error_description?: string;
+                        };
+                    };
+                };
+                /** @description `invalid_client` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description RFC 6749 §5.2 / RFC 7009 §2.2.1 error code. */
+                            error: string;
+                            error_description?: string;
+                        };
+                    };
+                };
+                /** @description `server_error` */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description RFC 6749 §5.2 / RFC 7009 §2.2.1 error code. */
+                            error: string;
+                            error_description?: string;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/oauth/revoke": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * RFC 7009 token revocation
+         * @description Revokes an access token minted via `/oauth/token`. Returns 200 regardless of whether the token existed (RFC §2.2 — no enumeration). Idempotent. Client authentication identical to `/oauth/token`. The `token_type_hint` is accepted (`access_token`) but ignored — only `access_token` is supported.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/x-www-form-urlencoded": {
+                        token: string;
+                        /** @enum {string} */
+                        token_type_hint?: "access_token";
+                        client_id?: string;
+                        client_secret?: string;
+                    };
+                    "application/json": {
+                        token: string;
+                        /** @enum {string} */
+                        token_type_hint?: "access_token";
+                        client_id?: string;
+                        client_secret?: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Empty 200 (RFC 7009) */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description `invalid_request` */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description RFC 6749 §5.2 / RFC 7009 §2.2.1 error code. */
+                            error: string;
+                            error_description?: string;
+                        };
+                    };
+                };
+                /** @description `invalid_client` */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description RFC 6749 §5.2 / RFC 7009 §2.2.1 error code. */
+                            error: string;
+                            error_description?: string;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/admin/oauth-apps": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Create a consumer OAuth app
+         * @description Creates a new consumer OAuth app (e.g. "vitrina"). Generates fresh `client_secret` + `jwt_signing_secret` server-side — both returned **once** in the 201 response and never readable again. Store them safely; rotate via the dedicated endpoints.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        client_id: string;
+                        name: string;
+                        description?: string;
+                        /** Format: uri */
+                        logo_url?: string;
+                        redirect_uris: string[];
+                        allowed_scopes: ("whatsapp" | "instagram")[];
+                        /** Format: uuid */
+                        created_by: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description App created; secrets shown once */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                /** Format: uuid */
+                                id: string;
+                                client_id: string;
+                                name: string;
+                                description: string | null;
+                                logo_url: string | null;
+                                redirect_uris: string[];
+                                allowed_scopes: ("whatsapp" | "instagram")[];
+                                /** @enum {string} */
+                                status: "active" | "suspended";
+                                created_at: string;
+                                client_secret: string;
+                                jwt_signing_secret: string;
+                            };
+                        };
+                    };
+                };
+                /** @description Invalid request (e.g. unknown `created_by` user) */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description `client_id` already exists */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Validation error */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/admin/oauth-apps/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Suspend a consumer OAuth app (kill-switch)
+         * @description Flips `status='suspended'` AND atomically revokes every `api_key` minted via this app. Idempotent — re-running on an already-suspended app returns `keys_revoked=0`. After suspension, in-flight consumer keys stop working immediately; the app reappears (with the same id) only if re-activated via PATCH.
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description App suspended; api_keys cascaded */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                /** Format: uuid */
+                                id: string;
+                                /** @enum {string} */
+                                status: "suspended";
+                                keys_revoked: number;
+                            };
+                        };
+                    };
+                };
+                /** @description App not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        options?: never;
+        head?: never;
+        /**
+         * Update a consumer OAuth app
+         * @description Update name, description, logo, redirect URIs, scopes, or status. At least one field is required.
+         */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        name?: string;
+                        description?: string | null;
+                        /** Format: uri */
+                        logo_url?: string | null;
+                        redirect_uris?: string[];
+                        allowed_scopes?: ("whatsapp" | "instagram")[];
+                        /** @enum {string} */
+                        status?: "active" | "suspended";
+                    };
+                };
+            };
+            responses: {
+                /** @description App updated */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                /** Format: uuid */
+                                id: string;
+                                client_id: string;
+                                name: string;
+                                description: string | null;
+                                logo_url: string | null;
+                                redirect_uris: string[];
+                                allowed_scopes: ("whatsapp" | "instagram")[];
+                                /** @enum {string} */
+                                status: "active" | "suspended";
+                                created_at: string;
+                            };
+                        };
+                    };
+                };
+                /** @description App not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Validation error */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        trace?: never;
+    };
+    "/api/v1/admin/oauth-apps/{id}/rotate-client-secret": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Rotate the OAuth app's `client_secret`
+         * @description Atomically rolls `client_secret_hash` → `previous_client_secret_hash` with a grace window (default 7 days, max 90). The new plaintext secret is returned **once**. In-flight `/oauth/token` calls authenticated with the old secret continue to succeed until the grace window expires.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        grace_days?: number;
+                    };
+                };
+            };
+            responses: {
+                /** @description New secret returned once */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                /** Format: uuid */
+                                oauth_app_id: string;
+                                client_secret: string;
+                                grace_days: number;
+                                previous_client_secret_expires_at: string;
+                            };
+                        };
+                    };
+                };
+                /** @description App not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description `grace_days` out of range */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/admin/oauth-apps/{id}/rotate-jwt-secret": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Rotate the OAuth app's `id_token_hint` HS256 signing secret
+         * @description Atomically rolls `jwt_signing_secret` → `previous_jwt_signing_secret` with a grace window (default 7 days, max 90). Atribu's `id_token_hint` verifier accepts both during the window so in-flight authorize flows don't break mid-deploy.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        grace_days?: number;
+                    };
+                };
+            };
+            responses: {
+                /** @description New secret returned once */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                /** Format: uuid */
+                                oauth_app_id: string;
+                                jwt_signing_secret: string;
+                                grace_days: number;
+                                previous_jwt_signing_secret_expires_at: string;
+                            };
+                        };
+                    };
+                };
+                /** @description App not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description `grace_days` out of range */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+interface components {
+    schemas: {
+        ErrorResponse: {
+            error: {
+                /** @example invalid_parameter */
+                code: string;
+                /** @example date_from is required */
+                message: string;
+                /** @example 400 */
+                status: number;
+                /** @example req_a1b2c3d4 */
+                request_id: string;
+            };
+        };
+        Meta: {
+            /** @example 2026-03-01 */
+            date_from?: string;
+            /** @example 2026-03-25 */
+            date_to?: string;
+            /** @example uuid */
+            profile_id: string;
+        };
+        Pagination: {
+            has_next: boolean;
+            cursor?: string;
+        };
+        /**
+         * @description Start date (YYYY-MM-DD, inclusive)
+         * @example 2026-03-01
+         */
+        date_from: string;
+        /**
+         * @description End date (YYYY-MM-DD, inclusive). Max range: 366 days.
+         * @example 2026-03-25
+         */
+        date_to: string;
+        /**
+         * @description Max results to return (default 10, max 100)
+         * @example 10
+         */
+        limit: string;
+        /**
+         * @description Attribution model. One of: last_touch, first_touch, split_50_50, linear, position_based, time_decay, last_non_direct, custom_weighted
+         * @example last_touch
+         */
+        model: string;
+        OverviewResponse: {
+            data: {
+                current: {
+                    spend: number;
+                    revenue: number;
+                    roas: number;
+                    outcomes: number;
+                    attributed_outcomes: number;
+                    coverage_percent: number;
+                    visitors: number;
+                    pageviews: number;
+                    bounce_rate: number;
+                    avg_engaged_seconds: number;
+                    cash_revenue: number;
+                    cash_payments: number;
+                };
+                previous: {
+                    spend: number;
+                    revenue: number;
+                    roas: number;
+                    outcomes: number;
+                    attributed_outcomes: number;
+                    coverage_percent: number;
+                    visitors: number;
+                    pageviews: number;
+                    bounce_rate: number;
+                    avg_engaged_seconds: number;
+                    cash_revenue: number;
+                    cash_payments: number;
+                };
+            };
+            meta: components["schemas"]["Meta"];
+        };
+    };
+    responses: never;
+    parameters: {
+        /** @description Start date (YYYY-MM-DD, inclusive) */
+        date_from: components["schemas"]["date_from"];
+        /** @description End date (YYYY-MM-DD, inclusive). Max range: 366 days. */
+        date_to: components["schemas"]["date_to"];
+        /** @description Max results to return (default 10, max 100) */
+        limit: components["schemas"]["limit"];
+        /** @description Attribution model. One of: last_touch, first_touch, split_50_50, linear, position_based, time_decay, last_non_direct, custom_weighted */
+        model: components["schemas"]["model"];
+    };
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+
+export type { HttpClientLike as H, RequestOptions as R, paths as p };