@graph8/sdk 0.251.0 → 0.262.0

package/docs/api/analytics.md

@@ -0,0 +1,2095 @@
+<!-- Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. -->
+
+# `g8.api.analytics`: Analytics
+
+51 operations (51 read).
+
+No hand-written client covers this area. Call it through `g8.api.analytics.*` as shown below, or by operationId with `g8.api.call(operationId, input)`.
+
+Every example below assumes this setup (server-side, API key):
+
+```ts
+import { g8 } from "@graph8/sdk";
+
+g8.init({ apiKey: process.env.G8_API_KEY! });
+```
+
+Example values are placeholders that match each field's type. Only required fields are shown. Every example is type-checked against the SDK in CI.
+
+Exact TypeScript types for every operation on this page, and every schema they use: [analytics.d.ts](analytics.d.ts).
+
+## Operations
+
+| Call | HTTP | Tier | Scope | Summary |
+|---|---|---|---|---|
+| [`computeCohort`](#op-computecohort) | `POST /api/v1/analytics/sales-report/cohort` | read | `analytics:read` | Compute Cohort |
+| [`explainCohort`](#op-explaincohort) | `POST /api/v1/analytics/sales-report/cohort/explain` | read | `analytics:read` | Explain Cohort |
+| [`exportCohortCsv`](#op-exportcohortcsv) | `POST /api/v1/analytics/sales-report/export` | read | `analytics:read` | Export Cohort Csv |
+| [`getActivationFunnel`](#op-getactivationfunnel) | `GET /api/v1/analytics/product-usage/activation-funnel` | read | `analytics:read` | Get Activation Funnel |
+| [`getActiveUsers`](#op-getactiveusers) | `GET /api/v1/analytics/product-usage/active-users` | read | `analytics:read` | Get Active Users |
+| [`getAnalyticsDataSources`](#op-getanalyticsdatasources) | `GET /api/v1/analytics/data-sources` | read | `analytics:read` | Get Analytics Data Sources |
+| [`getAudienceByIndustry`](#op-getaudiencebyindustry) | `GET /api/v1/analytics/outbound/audience/industry` | read | `analytics:read` | Get Audience By Industry |
+| [`getAudienceByIndustryGroup`](#op-getaudiencebyindustrygroup) | `GET /api/v1/analytics/outbound/audience/industry-group` | read | `analytics:read` | Get Audience By Industry Group |
+| [`getAudienceBySeniority`](#op-getaudiencebyseniority) | `GET /api/v1/analytics/outbound/audience/seniority` | read | `analytics:read` | Get Audience By Seniority |
+| [`getCallMetrics`](#op-getcallmetrics) | `GET /api/v1/analytics/outbound/call-metrics` | read | `analytics:read` | Get Call Metrics |
+| [`getCallTrend`](#op-getcalltrend) | `GET /api/v1/analytics/outbound/call-metrics/trend` | read | `analytics:read` | Get Call Trend |
+| [`getCampaignDashboard`](#op-getcampaigndashboard) | `GET /api/v1/analytics/outbound/dashboards/campaign` | read | `analytics:read` | Get Campaign Dashboard |
+| [`getCampaignVisitors`](#op-getcampaignvisitors) | `GET /api/v1/analytics/campaign-visitors` | read | `analytics:read` | Get Campaign Visitors |
+| [`getChannelAttribution`](#op-getchannelattribution) | `GET /api/v1/analytics/outbound/channel-attribution` | read | `analytics:read` | Get Channel Attribution |
+| [`getDataQuality`](#op-getdataquality) | `GET /api/v1/analytics/sales-report/data-quality` | read | `analytics:read` | Get Data Quality |
+| [`getDunning`](#op-getdunning) | `GET /api/v1/analytics/subscriptions/dunning` | read | `analytics:read` | Get Dunning |
+| [`getEmailBySequence`](#op-getemailbysequence) | `GET /api/v1/analytics/outbound/email-metrics/by-sequence` | read | `analytics:read` | Get Email By Sequence |
+| [`getEmailByStep`](#op-getemailbystep) | `GET /api/v1/analytics/outbound/email-metrics/by-step` | read | `analytics:read` | Get Email By Step |
+| [`getEmailMetrics`](#op-getemailmetrics) | `GET /api/v1/analytics/outbound/email-metrics` | read | `analytics:read` | Get Email Metrics |
+| [`getEmailTrend`](#op-getemailtrend) | `GET /api/v1/analytics/outbound/email-metrics/trend` | read | `analytics:read` | Get Email Trend |
+| [`getExecutiveDashboard`](#op-getexecutivedashboard) | `GET /api/v1/analytics/outbound/dashboards/executive` | read | `analytics:read` | Get Executive Dashboard |
+| [`getFeatureAdoption`](#op-getfeatureadoption) | `GET /api/v1/analytics/product-usage/feature-adoption` | read | `analytics:read` | Get Feature Adoption |
+| [`getFilterOptions`](#op-getfilteroptions) | `GET /api/v1/analytics/sales-report/filter-options` | read | `analytics:read` | Get Filter Options |
+| [`getLaunchpadActivityProfile`](#op-getlaunchpadactivityprofile) | `GET /api/v1/analytics/launchpad/activity-profile` | read | `analytics:read` | Get Launchpad Activity Profile |
+| [`getLaunchpadBriefing`](#op-getlaunchpadbriefing) | `GET /api/v1/analytics/launchpad/briefing` | read | `analytics:read` | Get Launchpad Briefing |
+| [`getLaunchpadCalendarToday`](#op-getlaunchpadcalendartoday) | `GET /api/v1/analytics/launchpad/calendar/today` | read | `analytics:read` | Get Launchpad Calendar Today |
+| [`getLaunchpadHomeFeed`](#op-getlaunchpadhomefeed) | `GET /api/v1/analytics/launchpad/home-feed` | read | `analytics:read` | Get Launchpad Home Feed |
+| [`getLaunchpadSmartCards`](#op-getlaunchpadsmartcards) | `GET /api/v1/analytics/launchpad/smart-cards` | read | `analytics:read` | Get Launchpad Smart Cards |
+| [`getManagerDashboard`](#op-getmanagerdashboard) | `GET /api/v1/analytics/outbound/dashboards/manager` | read | `analytics:read` | Get Manager Dashboard |
+| [`getMeetingByChannel`](#op-getmeetingbychannel) | `GET /api/v1/analytics/outbound/meeting-metrics/by-channel` | read | `analytics:read` | Get Meeting By Channel |
+| [`getMeetingFunnel`](#op-getmeetingfunnel) | `GET /api/v1/analytics/outbound/meeting-funnel` | read | `analytics:read` | Get Meeting Funnel |
+| [`getMeetingMetrics`](#op-getmeetingmetrics) | `GET /api/v1/analytics/outbound/meeting-metrics` | read | `analytics:read` | Get Meeting Metrics |
+| [`getMeetingTrend`](#op-getmeetingtrend) | `GET /api/v1/analytics/outbound/meeting-metrics/trend` | read | `analytics:read` | Get Meeting Trend |
+| [`getMovement`](#op-getmovement) | `GET /api/v1/analytics/subscriptions/movement` | read | `analytics:read` | Get Movement |
+| [`getMrr`](#op-getmrr) | `GET /api/v1/analytics/subscriptions/mrr` | read | `analytics:read` | Get Mrr |
+| [`getMySdrDashboard`](#op-getmysdrdashboard) | `GET /api/v1/analytics/outbound/dashboards/sdr` | read | `analytics:read` | Get My Sdr Dashboard |
+| [`getOutboundSummary`](#op-getoutboundsummary) | `GET /api/v1/analytics/outbound/summary` | read | `analytics:read` | Get Outbound Summary |
+| [`getPlanDistribution`](#op-getplandistribution) | `GET /api/v1/analytics/subscriptions/plan-distribution` | read | `analytics:read` | Get Plan Distribution |
+| [`getRetention`](#op-getretention) | `GET /api/v1/analytics/subscriptions/retention` | read | `analytics:read` | Get Retention |
+| [`getSdrActivity`](#op-getsdractivity) | `GET /api/v1/analytics/outbound/sdr-activity` | read | `analytics:read` | Get Sdr Activity |
+| [`getSdrActivityByEmail`](#op-getsdractivitybyemail) | `GET /api/v1/analytics/outbound/sdr-activity/{sdr_email}` | read | `analytics:read` | Get Sdr Activity By Email |
+| [`getSdrDaily`](#op-getsdrdaily) | `GET /api/v1/analytics/outbound/sdr-activity/daily` | read | `analytics:read` | Get Sdr Daily |
+| [`getSdrDashboardByEmail`](#op-getsdrdashboardbyemail) | `GET /api/v1/analytics/outbound/dashboards/sdr/{sdr_email}` | read | `analytics:read` | Get Sdr Dashboard By Email |
+| [`getSdrLeaderboard`](#op-getsdrleaderboard) | `GET /api/v1/analytics/outbound/sdr-activity/leaderboard` | read | `analytics:read` | Get Sdr Leaderboard |
+| [`getSequencePerformance`](#op-getsequenceperformance) | `GET /api/v1/analytics/outbound/sequence-performance` | read | `analytics:read` | Get Sequence Performance |
+| [`getSequencePerformanceById`](#op-getsequenceperformancebyid) | `GET /api/v1/analytics/outbound/sequence-performance/{sequence_id}` | read | `analytics:read` | Get Sequence Performance By Id |
+| [`getTeamComparison`](#op-getteamcomparison) | `GET /api/v1/analytics/outbound/sdr-activity/team-comparison` | read | `analytics:read` | Get Team Comparison |
+| [`getTopPages`](#op-gettoppages) | `GET /api/v1/analytics/product-usage/top-pages` | read | `analytics:read` | Get Top Pages |
+| [`getTrialConversion`](#op-gettrialconversion) | `GET /api/v1/analytics/subscriptions/trial-conversion` | read | `analytics:read` | Get Trial Conversion |
+| [`getVoiceAiOutcomes`](#op-getvoiceaioutcomes) | `GET /api/v1/analytics/outbound/call-metrics/voice-ai` | read | `analytics:read` | Get Voice Ai Outcomes |
+| [`postDataQuality`](#op-postdataquality) | `POST /api/v1/analytics/sales-report/data-quality` | read | `analytics:read` | Post Data Quality |
+
+---
+
+<a id="op-computecohort"></a>
+
+### `g8.api.analytics.computeCohort(input)`
+
+**Compute Cohort**
+
+- HTTP: `POST /api/v1/analytics/sales-report/cohort`
+- operationId: `compute_cohort_analytics_sales_report_cohort_post` (also callable as `g8.api.call("compute_cohort_analytics_sales_report_cohort_post", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+The whole Sales Report for one filter, in one round trip.
+
+Cohort plus funnel, pipeline, revenue and drill-down - thirteen sections
+resolved from a single deal cohort, which is the reason this is one call
+and not thirteen: the sections agree because they are computed over the
+same resolved set, not re-derived.
+
+Reads; writes nothing. It is a POST because the filter is a tree, not
+because it mutates - and it is tiered `read` for that reason.
+
+The filter is `extra="forbid"`: a misspelled key is a 422 naming it,
+rather than a silently wider result with a 200 on it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `FilterQueryDto` | yes | Request body; fields below. |
+| `query.tz` | `string` | no | IANA timezone the local-day window bounds are computed in, e.g. `Asia/Tokyo`. Changes which deals fall inside the date range. default `"UTC"` |
+
+Body fields (`FilterQueryDto`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.date` | `DateRangeDto` | yes |  |
+| `body.audiences` | `IntIdFilterGroupDto \| null` | no |  |
+| `body.campaign` | `FilterGroupDto \| null` | no |  |
+| `body.channel` | `FilterGroupDto \| null` | no |  |
+| `body.country` | `FilterGroupDto \| null` | no |  |
+| `body.grading_bucket` | `GradingBucketFilterGroupDto \| null` | no |  |
+| `body.granularity` | `"day" \| "week" \| "month" \| null` | no |  |
+| `body.headcount` | `HeadcountFilterGroupDto \| null` | no |  |
+| `body.industry` | `FilterGroupDto \| null` | no |  |
+| `body.lifecycle` | `FilterGroupDto \| null` | no |  |
+| `body.objections` | `ObjectionCodeFilterGroupDto \| null` | no |  |
+| `body.pipeline` | `UuidFilterGroupDto \| null` | no |  |
+| `body.pipeline_target` | `"prospects_meeting" \| "prospects_revenue" \| "customers_revenue" \| null` | no | default `"prospects_revenue"` |
+| `body.rec_type` | `IntIdFilterGroupDto \| null` | no |  |
+| `body.rep` | `FilterGroupDto \| null` | no |  |
+| `body.signals_calendar` | `FilterGroupDto \| null` | no |  |
+| `body.signals_chat` | `FilterGroupDto \| null` | no |  |
+| `body.signals_crm` | `FilterGroupDto \| null` | no |  |
+| `body.signals_email` | `FilterGroupDto \| null` | no |  |
+| `body.signals_enrichment` | `FilterGroupDto \| null` | no |  |
+| `body.signals_forms` | `FilterGroupDto \| null` | no |  |
+| `body.signals_intent` | `FilterGroupDto \| null` | no |  |
+| `body.signals_linkedin` | `FilterGroupDto \| null` | no |  |
+| `body.signals_sequence` | `FilterGroupDto \| null` | no |  |
+| `body.signals_sms` | `FilterGroupDto \| null` | no |  |
+| `body.signals_voice` | `FilterGroupDto \| null` | no |  |
+| `body.signals_website` | `FilterGroupDto \| null` | no |  |
+| `body.stage` | `UuidFilterGroupDto \| null` | no |  |
+| `body.tier` | `FilterGroupDto \| null` | no |  |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.computeCohort({ body: { date: { from: "2026-01-01", to: "2026-01-01" } } });
+```
+
+---
+
+<a id="op-explaincohort"></a>
+
+### `g8.api.analytics.explainCohort(input)`
+
+**Explain Cohort**
+
+- HTTP: `POST /api/v1/analytics/sales-report/cohort/explain`
+- operationId: `explain_cohort_analytics_sales_report_cohort_explain_post` (also callable as `g8.api.call("explain_cohort_analytics_sales_report_cohort_explain_post", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Which clause emptied the view.
+
+Takes the SAME body as `/cohort` and answers one
+`{label, lead_count, deal_count, measured}` row per progressively-built
+prefix of the filter - baseline, then +rep, then +lifecycle, and so on.
+Read the drop (`290 -> 57 -> 11 -> 0`) and the last step that moved is the
+clause that did it.
+
+COUNTS ONLY, never rows - which is both what makes it affordable (about 26
+count queries against `/cohort`'s full section fan-out) and why it is safe
+to call when `/cohort` itself would withhold person rows.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `FilterQueryDto` | yes | Request body; fields below. |
+| `query.tz` | `string` | no | IANA timezone the local-day window bounds are computed in, e.g. `Asia/Tokyo`. Changes which deals fall inside the date range. default `"UTC"` |
+
+Body fields (`FilterQueryDto`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.date` | `DateRangeDto` | yes |  |
+| `body.audiences` | `IntIdFilterGroupDto \| null` | no |  |
+| `body.campaign` | `FilterGroupDto \| null` | no |  |
+| `body.channel` | `FilterGroupDto \| null` | no |  |
+| `body.country` | `FilterGroupDto \| null` | no |  |
+| `body.grading_bucket` | `GradingBucketFilterGroupDto \| null` | no |  |
+| `body.granularity` | `"day" \| "week" \| "month" \| null` | no |  |
+| `body.headcount` | `HeadcountFilterGroupDto \| null` | no |  |
+| `body.industry` | `FilterGroupDto \| null` | no |  |
+| `body.lifecycle` | `FilterGroupDto \| null` | no |  |
+| `body.objections` | `ObjectionCodeFilterGroupDto \| null` | no |  |
+| `body.pipeline` | `UuidFilterGroupDto \| null` | no |  |
+| `body.pipeline_target` | `"prospects_meeting" \| "prospects_revenue" \| "customers_revenue" \| null` | no | default `"prospects_revenue"` |
+| `body.rec_type` | `IntIdFilterGroupDto \| null` | no |  |
+| `body.rep` | `FilterGroupDto \| null` | no |  |
+| `body.signals_calendar` | `FilterGroupDto \| null` | no |  |
+| `body.signals_chat` | `FilterGroupDto \| null` | no |  |
+| `body.signals_crm` | `FilterGroupDto \| null` | no |  |
+| `body.signals_email` | `FilterGroupDto \| null` | no |  |
+| `body.signals_enrichment` | `FilterGroupDto \| null` | no |  |
+| `body.signals_forms` | `FilterGroupDto \| null` | no |  |
+| `body.signals_intent` | `FilterGroupDto \| null` | no |  |
+| `body.signals_linkedin` | `FilterGroupDto \| null` | no |  |
+| `body.signals_sequence` | `FilterGroupDto \| null` | no |  |
+| `body.signals_sms` | `FilterGroupDto \| null` | no |  |
+| `body.signals_voice` | `FilterGroupDto \| null` | no |  |
+| `body.signals_website` | `FilterGroupDto \| null` | no |  |
+| `body.stage` | `UuidFilterGroupDto \| null` | no |  |
+| `body.tier` | `FilterGroupDto \| null` | no |  |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.explainCohort({ body: { date: { from: "2026-01-01", to: "2026-01-01" } } });
+```
+
+---
+
+<a id="op-exportcohortcsv"></a>
+
+### `g8.api.analytics.exportCohortCsv(input)`
+
+**Export Cohort Csv**
+
+- HTTP: `POST /api/v1/analytics/sales-report/export`
+- operationId: `export_cohort_csv_analytics_sales_report_export_post` (also callable as `g8.api.call("export_cohort_csv_analytics_sales_report_export_post", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Download one section of the report - or the cohort drill-down - as CSV.
+
+Takes the `/cohort` filter plus `section`; an absent or unknown section is
+the persons drill-down. The export is the SAME cohort the report shows,
+narrowed by the same deal and lead scopes, so it can never be a wider
+download than the screen. Person rows are withheld exactly where `/cohort`
+withholds them.
+
+Reads; writes nothing. A POST only because the filter is a tree - tiered
+`read`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `ExportRequestDto` | yes | Request body; fields below. |
+| `query.tz` | `string` | no | IANA timezone the local-day window bounds are computed in, e.g. `Asia/Tokyo`. Changes which deals fall inside the date range. default `"UTC"` |
+
+Body fields (`ExportRequestDto`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.date` | `DateRangeDto` | yes |  |
+| `body.audiences` | `IntIdFilterGroupDto \| null` | no |  |
+| `body.campaign` | `FilterGroupDto \| null` | no |  |
+| `body.channel` | `FilterGroupDto \| null` | no |  |
+| `body.country` | `FilterGroupDto \| null` | no |  |
+| `body.grading_bucket` | `GradingBucketFilterGroupDto \| null` | no |  |
+| `body.granularity` | `"day" \| "week" \| "month" \| null` | no |  |
+| `body.headcount` | `HeadcountFilterGroupDto \| null` | no |  |
+| `body.industry` | `FilterGroupDto \| null` | no |  |
+| `body.lifecycle` | `FilterGroupDto \| null` | no |  |
+| `body.objections` | `ObjectionCodeFilterGroupDto \| null` | no |  |
+| `body.pipeline` | `UuidFilterGroupDto \| null` | no |  |
+| `body.pipeline_target` | `"prospects_meeting" \| "prospects_revenue" \| "customers_revenue" \| null` | no | default `"prospects_revenue"` |
+| `body.rec_type` | `IntIdFilterGroupDto \| null` | no |  |
+| `body.rep` | `FilterGroupDto \| null` | no |  |
+| `body.section` | `string \| null` | no | max length 128 |
+| `body.signals_calendar` | `FilterGroupDto \| null` | no |  |
+| `body.signals_chat` | `FilterGroupDto \| null` | no |  |
+| `body.signals_crm` | `FilterGroupDto \| null` | no |  |
+| `body.signals_email` | `FilterGroupDto \| null` | no |  |
+| `body.signals_enrichment` | `FilterGroupDto \| null` | no |  |
+| `body.signals_forms` | `FilterGroupDto \| null` | no |  |
+| `body.signals_intent` | `FilterGroupDto \| null` | no |  |
+| `body.signals_linkedin` | `FilterGroupDto \| null` | no |  |
+| `body.signals_sequence` | `FilterGroupDto \| null` | no |  |
+| `body.signals_sms` | `FilterGroupDto \| null` | no |  |
+| `body.signals_voice` | `FilterGroupDto \| null` | no |  |
+| `body.signals_website` | `FilterGroupDto \| null` | no |  |
+| `body.stage` | `UuidFilterGroupDto \| null` | no |  |
+| `body.tier` | `FilterGroupDto \| null` | no |  |
+
+**Returns**: no JSON body is declared for the success response.
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.exportCohortCsv({ body: { date: { from: "2026-01-01", to: "2026-01-01" } } });
+```
+
+---
+
+<a id="op-getactivationfunnel"></a>
+
+### `g8.api.analytics.getActivationFunnel(input?)`
+
+**Get Activation Funnel**
+
+- HTTP: `GET /api/v1/analytics/product-usage/activation-funnel`
+- operationId: `get_activation_funnel_analytics_product_usage_activation_funnel_get` (also callable as `g8.api.call("get_activation_funnel_analytics_product_usage_activation_funnel_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Sign-in to first list to first campaign launched.
+
+The onboarding funnel: where a new seat stops before it becomes a user.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getActivationFunnel();
+```
+
+---
+
+<a id="op-getactiveusers"></a>
+
+### `g8.api.analytics.getActiveUsers(input?)`
+
+**Get Active Users**
+
+- HTTP: `GET /api/v1/analytics/product-usage/active-users`
+- operationId: `get_active_users_analytics_product_usage_active_users_get` (also callable as `g8.api.call("get_active_users_analytics_product_usage_active_users_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Daily, weekly and monthly actives, plus stickiness (DAU/MAU).
+
+Stickiness is the one to watch: DAU can climb on a hiring spree while the
+ratio falls, which says the new people are not coming back.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getActiveUsers();
+```
+
+---
+
+<a id="op-getanalyticsdatasources"></a>
+
+### `g8.api.analytics.getAnalyticsDataSources(input?)`
+
+**Get Analytics Data Sources**
+
+- HTTP: `GET /api/v1/analytics/data-sources`
+- operationId: `get_analytics_data_sources_analytics_data_sources_get` (also callable as `g8.api.call("get_analytics_data_sources_analytics_data_sources_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Whether the org has the two sources the revenue and product reports read.
+
+The payments-integration flag gates `/analytics/subscriptions/*` and the
+product-event flag gates `/analytics/product-usage/*`. Check it first: a
+report over a source the org has not connected answers empty, not 404.
+
+**Input**: none.
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getAnalyticsDataSources();
+```
+
+---
+
+<a id="op-getaudiencebyindustry"></a>
+
+### `g8.api.analytics.getAudienceByIndustry(input?)`
+
+**Get Audience By Industry**
+
+- HTTP: `GET /api/v1/analytics/outbound/audience/industry`
+- operationId: `get_audience_by_industry_analytics_outbound_audience_industry_get` (also callable as `g8.api.call("get_audience_by_industry_analytics_outbound_audience_industry_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Performance grouped by the COMPANY's specific industry.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getAudienceByIndustry();
+```
+
+---
+
+<a id="op-getaudiencebyindustrygroup"></a>
+
+### `g8.api.analytics.getAudienceByIndustryGroup(input?)`
+
+**Get Audience By Industry Group**
+
+- HTTP: `GET /api/v1/analytics/outbound/audience/industry-group`
+- operationId: `get_audience_by_industry_group_analytics_outbound_audience_industry_group_get` (also callable as `g8.api.call("get_audience_by_industry_group_analytics_outbound_audience_industry_group_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+The same, grouped into broad categories rather than exact industries.
+
+Use this one when the specific-industry split is too sparse to read -
+"Technology" has volume where "Prepackaged Software" does not.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getAudienceByIndustryGroup();
+```
+
+---
+
+<a id="op-getaudiencebyseniority"></a>
+
+### `g8.api.analytics.getAudienceBySeniority(input?)`
+
+**Get Audience By Seniority**
+
+- HTTP: `GET /api/v1/analytics/outbound/audience/seniority`
+- operationId: `get_audience_by_seniority_analytics_outbound_audience_seniority_get` (also callable as `g8.api.call("get_audience_by_seniority_analytics_outbound_audience_seniority_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Performance grouped by the CONTACT's seniority - C-level down to IC.
+
+Answers who replies, not who was mailed. The three audience reports are
+the ones that change targeting rather than copy.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getAudienceBySeniority();
+```
+
+---
+
+<a id="op-getcallmetrics"></a>
+
+### `g8.api.analytics.getCallMetrics(input?)`
+
+**Get Call Metrics**
+
+- HTTP: `GET /api/v1/analytics/outbound/call-metrics`
+- operationId: `get_call_metrics_analytics_outbound_call_metrics_get` (also callable as `g8.api.call("get_call_metrics_analytics_outbound_call_metrics_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Dispatched, connected, completed, voicemail - call volume and outcome.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getCallMetrics();
+```
+
+---
+
+<a id="op-getcalltrend"></a>
+
+### `g8.api.analytics.getCallTrend(input?)`
+
+**Get Call Trend**
+
+- HTTP: `GET /api/v1/analytics/outbound/call-metrics/trend`
+- operationId: `get_call_trend_analytics_outbound_call_metrics_trend_get` (also callable as `g8.api.call("get_call_trend_analytics_outbound_call_metrics_trend_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+The same call metrics, one row per day.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getCallTrend();
+```
+
+---
+
+<a id="op-getcampaigndashboard"></a>
+
+### `g8.api.analytics.getCampaignDashboard(input?)`
+
+**Get Campaign Dashboard**
+
+- HTTP: `GET /api/v1/analytics/outbound/dashboards/campaign`
+- operationId: `get_campaign_dashboard_analytics_outbound_dashboards_campaign_get` (also callable as `g8.api.call("get_campaign_dashboard_analytics_outbound_dashboards_campaign_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Sequence and campaign performance, as a campaign manager reads it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getCampaignDashboard();
+```
+
+---
+
+<a id="op-getcampaignvisitors"></a>
+
+### `g8.api.analytics.getCampaignVisitors(input?)`
+
+**Get Campaign Visitors**
+
+- HTTP: `GET /api/v1/analytics/campaign-visitors`
+- operationId: `get_campaign_visitors_analytics_campaign_visitors_get` (also callable as `g8.api.call("get_campaign_visitors_analytics_campaign_visitors_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Campaign Visitors report for the authenticated org (analytics report a23).
+
+Returns, for the resolved window:
+
+  * **summary** — KPI tiles (page events, campaign clicks, unique contacts /
+    steps, identified visitors, and the encrypted/plaintext/unparseable
+    diagnostic split). Click counters are email-security-scanner filtered
+    (humans only) so they match the in-app report — raw scanner traffic
+    (Microsoft Defender / SafeLinks) is excluded.
+  * **top_campaign_steps** — per sequencer step: clicks, unique contacts, a
+    human-readable label, and send-side context (emails sent / with link).
+  * **link_engagement** — per clicked destination URL: human clicks, unique
+    contacts, the emails-with-link denominator, and CTR% (clamped 0–100).
+  * **top_contacts** — who clicked, with resolved name/email (PII; omit via
+    `include_contacts=false`).
+
+Enrichment (labels, email, send counts, CTR) is best-effort: a field is
+``null`` when it couldn't be resolved, never a fabricated zero. An org with
+no visitor-tracking pipeline returns an empty report with
+``summary.jitsu_wired = false``.
+
+Agency keys: pass ``X-Target-Org-Id`` to run the report for a specific client
+org within your authorized set.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.start_date` | `string (date) \| null` | no | Window start (inclusive), YYYY-MM-DD. If omitted, derived from `days`. |
+| `query.end_date` | `string (date) \| null` | no | Window end (inclusive), YYYY-MM-DD. If omitted, today. |
+| `query.days` | `integer \| null` | no | Rolling 'last N days from today'. Ignored when start_date/end_date are supplied. |
+| `query.limit` | `integer` | no | Row cap for the steps + contacts tables default `50` |
+| `query.include_contacts` | `boolean` | no | Include the Top contacts table (contact name + email — PII). Set false to omit it entirely for a privacy-lean response. default `true` |
+
+**Returns** `ApiResponse_CampaignVisitorsReport_`: the envelope `{ data: CampaignVisitorsReport, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`CampaignVisitorsReport` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `link_engagement` | `Array<CampaignVisitorLink>` | yes |  |
+| `summary` | `CampaignVisitorsSummary` | yes |  |
+| `top_campaign_steps` | `Array<CampaignVisitorStep>` | yes |  |
+| `top_contacts` | `Array<CampaignVisitorContact>` | yes |  |
+| `window` | `CampaignVisitorsWindow` | yes |  |
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getCampaignVisitors();
+```
+
+---
+
+<a id="op-getchannelattribution"></a>
+
+### `g8.api.analytics.getChannelAttribution(input?)`
+
+**Get Channel Attribution**
+
+- HTTP: `GET /api/v1/analytics/outbound/channel-attribution`
+- operationId: `get_channel_attribution_analytics_outbound_channel_attribution_get` (also callable as `g8.api.call("get_channel_attribution_analytics_outbound_channel_attribution_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+What each channel contributed - email versus phone versus LinkedIn.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getChannelAttribution();
+```
+
+---
+
+<a id="op-getdataquality"></a>
+
+### `g8.api.analytics.getDataQuality(input?)`
+
+**Get Data Quality**
+
+- HTTP: `GET /api/v1/analytics/sales-report/data-quality`
+- operationId: `get_data_quality_analytics_sales_report_data_quality_get` (also callable as `g8.api.call("get_data_quality_analytics_sales_report_data_quality_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Why a Sales Report section might be empty.
+
+Upstream linkage counts plus pre-rendered warnings. ALWAYS 200 - a failing
+sub-query degrades to zero rather than raising, so an empty `warnings` list
+means "nothing breached a threshold", not "the check did not run".
+
+Read this first when a number looks wrong. It is the difference between a
+filter that matched nothing and a pipeline that is not wired up.
+
+**Input**: none.
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getDataQuality();
+```
+
+---
+
+<a id="op-getdunning"></a>
+
+### `g8.api.analytics.getDunning(input?)`
+
+**Get Dunning**
+
+- HTTP: `GET /api/v1/analytics/subscriptions/dunning`
+- operationId: `get_dunning_analytics_subscriptions_dunning_get` (also callable as `g8.api.call("get_dunning_analytics_subscriptions_dunning_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Failed payments: still open, recovered, or written off.
+
+Revenue already earned and not yet collected - usually the cheapest money
+on this router to go and get.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getDunning();
+```
+
+---
+
+<a id="op-getemailbysequence"></a>
+
+### `g8.api.analytics.getEmailBySequence(input?)`
+
+**Get Email By Sequence**
+
+- HTTP: `GET /api/v1/analytics/outbound/email-metrics/by-sequence`
+- operationId: `get_email_by_sequence_analytics_outbound_email_metrics_by_sequence_get` (also callable as `g8.api.call("get_email_by_sequence_analytics_outbound_email_metrics_by_sequence_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Email metrics split by sequence - which campaign is carrying the org.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+| `query.limit` | `integer` | no | Sequences to return. default `50` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getEmailBySequence();
+```
+
+---
+
+<a id="op-getemailbystep"></a>
+
+### `g8.api.analytics.getEmailByStep(input?)`
+
+**Get Email By Step**
+
+- HTTP: `GET /api/v1/analytics/outbound/email-metrics/by-step`
+- operationId: `get_email_by_step_analytics_outbound_email_metrics_by_step_get` (also callable as `g8.api.call("get_email_by_step_analytics_outbound_email_metrics_by_step_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Email metrics by STEP ORDER - where in the sequence people drop.
+
+The step view is the one that changes a sequence: a reply rate that dies
+at step three is a step-three problem, not a sequence problem.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+| `query.sequence_id` | `string \| null` | no | Narrow to one sequence. Omit for every sequence's steps folded together by step order. |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getEmailByStep();
+```
+
+---
+
+<a id="op-getemailmetrics"></a>
+
+### `g8.api.analytics.getEmailMetrics(input?)`
+
+**Get Email Metrics**
+
+- HTTP: `GET /api/v1/analytics/outbound/email-metrics`
+- operationId: `get_email_metrics_analytics_outbound_email_metrics_get` (also callable as `g8.api.call("get_email_metrics_analytics_outbound_email_metrics_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Sent, bounced, delivered, replied, and the rates between them.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getEmailMetrics();
+```
+
+---
+
+<a id="op-getemailtrend"></a>
+
+### `g8.api.analytics.getEmailTrend(input?)`
+
+**Get Email Trend**
+
+- HTTP: `GET /api/v1/analytics/outbound/email-metrics/trend`
+- operationId: `get_email_trend_analytics_outbound_email_metrics_trend_get` (also callable as `g8.api.call("get_email_trend_analytics_outbound_email_metrics_trend_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+The same email metrics, one row per day.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getEmailTrend();
+```
+
+---
+
+<a id="op-getexecutivedashboard"></a>
+
+### `g8.api.analytics.getExecutiveDashboard(input?)`
+
+**Get Executive Dashboard**
+
+- HTTP: `GET /api/v1/analytics/outbound/dashboards/executive`
+- operationId: `get_executive_dashboard_analytics_outbound_dashboards_executive_get` (also callable as `g8.api.call("get_executive_dashboard_analytics_outbound_dashboards_executive_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+The leadership roll-up. Cached for an hour - it is not a live view.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getExecutiveDashboard();
+```
+
+---
+
+<a id="op-getfeatureadoption"></a>
+
+### `g8.api.analytics.getFeatureAdoption(input?)`
+
+**Get Feature Adoption**
+
+- HTTP: `GET /api/v1/analytics/product-usage/feature-adoption`
+- operationId: `get_feature_adoption_analytics_product_usage_feature_adoption_get` (also callable as `g8.api.call("get_feature_adoption_analytics_product_usage_feature_adoption_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Share of distinct actors who hit each lifecycle event in the window.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getFeatureAdoption();
+```
+
+---
+
+<a id="op-getfilteroptions"></a>
+
+### `g8.api.analytics.getFilterOptions(input?)`
+
+**Get Filter Options**
+
+- HTTP: `GET /api/v1/analytics/sales-report/filter-options`
+- operationId: `get_filter_options_analytics_sales_report_filter_options_get` (also callable as `g8.api.call("get_filter_options_analytics_sales_report_filter_options_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Every value the filter above will accept - reps, pipelines, stages,
+lifecycles, audiences, CRM sources.
+
+Call this before `/cohort` rather than guessing ids. Send `from` and `to`
+together to also get a `granularity` block saying which time buckets that
+window supports and why each refused one cannot.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.from` | `string (date) \| null` | no | Start of the window to grade time-bucket granularities against. Must be sent WITH `to`. Omit both and the response is unchanged and carries no `granularity` block. |
+| `query.to` | `string (date) \| null` | no | End of that window. Must be sent WITH `from`. |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getFilterOptions();
+```
+
+---
+
+<a id="op-getlaunchpadactivityprofile"></a>
+
+### `g8.api.analytics.getLaunchpadActivityProfile(input?)`
+
+**Get Launchpad Activity Profile**
+
+- HTTP: `GET /api/v1/analytics/launchpad/activity-profile`
+- operationId: `get_launchpad_activity_profile_analytics_launchpad_activity_profile_get` (also callable as `g8.api.call("get_launchpad_activity_profile_analytics_launchpad_activity_profile_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+The key-holder's detected persona and the activity types they actually do.
+
+**Input**: none.
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getLaunchpadActivityProfile();
+```
+
+---
+
+<a id="op-getlaunchpadbriefing"></a>
+
+### `g8.api.analytics.getLaunchpadBriefing(input?)`
+
+**Get Launchpad Briefing**
+
+- HTTP: `GET /api/v1/analytics/launchpad/briefing`
+- operationId: `get_launchpad_briefing_analytics_launchpad_briefing_get` (also callable as `g8.api.call("get_launchpad_briefing_analytics_launchpad_briefing_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Today's briefing for the key-holder: what changed, and what needs them.
+
+**Input**: none.
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getLaunchpadBriefing();
+```
+
+---
+
+<a id="op-getlaunchpadcalendartoday"></a>
+
+### `g8.api.analytics.getLaunchpadCalendarToday(input?)`
+
+**Get Launchpad Calendar Today**
+
+- HTTP: `GET /api/v1/analytics/launchpad/calendar/today`
+- operationId: `get_launchpad_calendar_today_analytics_launchpad_calendar_today_get` (also callable as `g8.api.call("get_launchpad_calendar_today_analytics_launchpad_calendar_today_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+The key-holder's meetings for one day.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.date` | `string \| null` | no | ISO date to read instead of today. |
+| `query.timezone` | `string` | no | IANA timezone the day boundaries are computed in. default `"UTC"` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getLaunchpadCalendarToday();
+```
+
+---
+
+<a id="op-getlaunchpadhomefeed"></a>
+
+### `g8.api.analytics.getLaunchpadHomeFeed(input?)`
+
+**Get Launchpad Home Feed**
+
+- HTTP: `GET /api/v1/analytics/launchpad/home-feed`
+- operationId: `get_launchpad_home_feed_analytics_launchpad_home_feed_get` (also callable as `g8.api.call("get_launchpad_home_feed_analytics_launchpad_home_feed_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+The key-holder's home feed: replies, meetings and recent activity.
+
+**Input**: none.
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getLaunchpadHomeFeed();
+```
+
+---
+
+<a id="op-getlaunchpadsmartcards"></a>
+
+### `g8.api.analytics.getLaunchpadSmartCards(input?)`
+
+**Get Launchpad Smart Cards**
+
+- HTTP: `GET /api/v1/analytics/launchpad/smart-cards`
+- operationId: `get_launchpad_smart_cards_analytics_launchpad_smart_cards_get` (also callable as `g8.api.call("get_launchpad_smart_cards_analytics_launchpad_smart_cards_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Persona-ranked cards with live counts, as the copilot home screen shows them.
+
+**Input**: none.
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getLaunchpadSmartCards();
+```
+
+---
+
+<a id="op-getmanagerdashboard"></a>
+
+### `g8.api.analytics.getManagerDashboard(input?)`
+
+**Get Manager Dashboard**
+
+- HTTP: `GET /api/v1/analytics/outbound/dashboards/manager`
+- operationId: `get_manager_dashboard_analytics_outbound_dashboards_manager_get` (also callable as `g8.api.call("get_manager_dashboard_analytics_outbound_dashboards_manager_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Team overview, as an SDR manager reads it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getManagerDashboard();
+```
+
+---
+
+<a id="op-getmeetingbychannel"></a>
+
+### `g8.api.analytics.getMeetingByChannel(input?)`
+
+**Get Meeting By Channel**
+
+- HTTP: `GET /api/v1/analytics/outbound/meeting-metrics/by-channel`
+- operationId: `get_meeting_by_channel_analytics_outbound_meeting_metrics_by_channel_get` (also callable as `g8.api.call("get_meeting_by_channel_analytics_outbound_meeting_metrics_by_channel_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Which channel produced each booking - email, phone, or inbound.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getMeetingByChannel();
+```
+
+---
+
+<a id="op-getmeetingfunnel"></a>
+
+### `g8.api.analytics.getMeetingFunnel(input?)`
+
+**Get Meeting Funnel**
+
+- HTTP: `GET /api/v1/analytics/outbound/meeting-funnel`
+- operationId: `get_meeting_funnel_analytics_outbound_meeting_funnel_get` (also callable as `g8.api.call("get_meeting_funnel_analytics_outbound_meeting_funnel_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Booked, held, cancelled - and the conversion between them.
+
+The funnel, not the counts: `/meeting-metrics` answers how many, this
+answers how many SURVIVED.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getMeetingFunnel();
+```
+
+---
+
+<a id="op-getmeetingmetrics"></a>
+
+### `g8.api.analytics.getMeetingMetrics(input?)`
+
+**Get Meeting Metrics**
+
+- HTTP: `GET /api/v1/analytics/outbound/meeting-metrics`
+- operationId: `get_meeting_metrics_analytics_outbound_meeting_metrics_get` (also callable as `g8.api.call("get_meeting_metrics_analytics_outbound_meeting_metrics_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Meetings booked, cancelled, net, and the cancellation rate.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getMeetingMetrics();
+```
+
+---
+
+<a id="op-getmeetingtrend"></a>
+
+### `g8.api.analytics.getMeetingTrend(input?)`
+
+**Get Meeting Trend**
+
+- HTTP: `GET /api/v1/analytics/outbound/meeting-metrics/trend`
+- operationId: `get_meeting_trend_analytics_outbound_meeting_metrics_trend_get` (also callable as `g8.api.call("get_meeting_trend_analytics_outbound_meeting_metrics_trend_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+The same meeting metrics, one row per day.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getMeetingTrend();
+```
+
+---
+
+<a id="op-getmovement"></a>
+
+### `g8.api.analytics.getMovement(input?)`
+
+**Get Movement**
+
+- HTTP: `GET /api/v1/analytics/subscriptions/movement`
+- operationId: `get_movement_analytics_subscriptions_movement_get` (also callable as `g8.api.call("get_movement_analytics_subscriptions_movement_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+The MRR waterfall: new, expansion, contraction, churned, reactivated.
+
+Where `/mrr` says what the number is, this says what MOVED it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getMovement();
+```
+
+---
+
+<a id="op-getmrr"></a>
+
+### `g8.api.analytics.getMrr(input?)`
+
+**Get Mrr**
+
+- HTTP: `GET /api/v1/analytics/subscriptions/mrr`
+- operationId: `get_mrr_analytics_subscriptions_mrr_get` (also callable as `g8.api.call("get_mrr_analytics_subscriptions_mrr_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+MRR and ARR headline, plus the trailing trend.
+
+The window sizes the TREND only - the headline is the current snapshot
+either way, so a shorter window makes the chart shorter, not the number
+smaller.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.trailing_days` | `integer` | no | Length of the trend series, in days. default `90` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getMrr();
+```
+
+---
+
+<a id="op-getmysdrdashboard"></a>
+
+### `g8.api.analytics.getMySdrDashboard(input?)`
+
+**Get My Sdr Dashboard**
+
+- HTTP: `GET /api/v1/analytics/outbound/dashboards/sdr`
+- operationId: `get_my_sdr_dashboard_analytics_outbound_dashboards_sdr_get` (also callable as `g8.api.call("get_my_sdr_dashboard_analytics_outbound_dashboards_sdr_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+The dashboard of the person who minted this key.
+
+The rep is read from the key-holder's identity, so an organisation-scoped
+key - which has no person behind it and would resolve to a synthetic
+sentinel address, answering empty - is refused with a 403 rather than
+handed a dashboard that looks like a rep with no activity.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getMySdrDashboard();
+```
+
+---
+
+<a id="op-getoutboundsummary"></a>
+
+### `g8.api.analytics.getOutboundSummary(input?)`
+
+**Get Outbound Summary**
+
+- HTTP: `GET /api/v1/analytics/outbound/summary`
+- operationId: `get_outbound_summary_analytics_outbound_summary_get` (also callable as `g8.api.call("get_outbound_summary_analytics_outbound_summary_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Email, calls and meetings in one call - the top-line outbound KPIs.
+
+The cheapest way to ask "how is outbound doing": one request instead of
+the three channel summaries below.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getOutboundSummary();
+```
+
+---
+
+<a id="op-getplandistribution"></a>
+
+### `g8.api.analytics.getPlanDistribution(input?)`
+
+**Get Plan Distribution**
+
+- HTTP: `GET /api/v1/analytics/subscriptions/plan-distribution`
+- operationId: `get_plan_distribution_analytics_subscriptions_plan_distribution_get` (also callable as `g8.api.call("get_plan_distribution_analytics_subscriptions_plan_distribution_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Active subscriptions and MRR per plan, as of now.
+
+A snapshot, so it takes no window - the only report here that does not.
+
+**Input**: none.
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getPlanDistribution();
+```
+
+---
+
+<a id="op-getretention"></a>
+
+### `g8.api.analytics.getRetention(input?)`
+
+**Get Retention**
+
+- HTTP: `GET /api/v1/analytics/subscriptions/retention`
+- operationId: `get_retention_analytics_subscriptions_retention_get` (also callable as `g8.api.call("get_retention_analytics_subscriptions_retention_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Gross revenue churn, net revenue retention, and logo churn.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Trailing window, in days. default `90` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getRetention();
+```
+
+---
+
+<a id="op-getsdractivity"></a>
+
+### `g8.api.analytics.getSdrActivity(input?)`
+
+**Get Sdr Activity**
+
+- HTTP: `GET /api/v1/analytics/outbound/sdr-activity`
+- operationId: `get_sdr_activity_analytics_outbound_sdr_activity_get` (also callable as `g8.api.call("get_sdr_activity_analytics_outbound_sdr_activity_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Activity per rep across the window - the roster view.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getSdrActivity();
+```
+
+---
+
+<a id="op-getsdractivitybyemail"></a>
+
+### `g8.api.analytics.getSdrActivityByEmail(input)`
+
+**Get Sdr Activity By Email**
+
+- HTTP: `GET /api/v1/analytics/outbound/sdr-activity/{sdr_email}`
+- operationId: `get_sdr_activity_by_email_analytics_outbound_sdr_activity__sdr_email__get` (also callable as `g8.api.call("get_sdr_activity_by_email_analytics_outbound_sdr_activity__sdr_email__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+One rep's daily activity.
+
+A PLAIN path segment, where the app declares `{sdr_email:path}`. The
+greedy converter would match across `/` and swallow every future route
+under `/sdr-activity/`; an email address has no slash in it, and the
+already-published `GET /analytics/sdr/{sdr_email}` sets the precedent one
+namespace over.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.sdr_email` | `string` | yes | The rep's email address. |
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getSdrActivityByEmail({ path: { sdr_email: "jane@acme.com" } });
+```
+
+---
+
+<a id="op-getsdrdaily"></a>
+
+### `g8.api.analytics.getSdrDaily(input?)`
+
+**Get Sdr Daily**
+
+- HTTP: `GET /api/v1/analytics/outbound/sdr-activity/daily`
+- operationId: `get_sdr_daily_analytics_outbound_sdr_activity_daily_get` (also callable as `g8.api.call("get_sdr_daily_analytics_outbound_sdr_activity_daily_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Per-rep activity broken out by day.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+| `query.sdr_email` | `string \| null` | no | Narrow to one rep. Omit for the whole team. |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getSdrDaily();
+```
+
+---
+
+<a id="op-getsdrdashboardbyemail"></a>
+
+### `g8.api.analytics.getSdrDashboardByEmail(input)`
+
+**Get Sdr Dashboard By Email**
+
+- HTTP: `GET /api/v1/analytics/outbound/dashboards/sdr/{sdr_email}`
+- operationId: `get_sdr_dashboard_by_email_analytics_outbound_dashboards_sdr__sdr_email__get` (also callable as `g8.api.call("get_sdr_dashboard_by_email_analytics_outbound_dashboards_sdr__sdr_email__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+One rep's dashboard, named explicitly.
+
+`GET /analytics/outbound/dashboards/sdr` is the key-holder's OWN
+dashboard; this one names the rep, so any key may read any rep's numbers.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.sdr_email` | `string` | yes | The rep's email address. |
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getSdrDashboardByEmail({ path: { sdr_email: "jane@acme.com" } });
+```
+
+---
+
+<a id="op-getsdrleaderboard"></a>
+
+### `g8.api.analytics.getSdrLeaderboard(input?)`
+
+**Get Sdr Leaderboard**
+
+- HTTP: `GET /api/v1/analytics/outbound/sdr-activity/leaderboard`
+- operationId: `get_sdr_leaderboard_analytics_outbound_sdr_activity_leaderboard_get` (also callable as `g8.api.call("get_sdr_leaderboard_analytics_outbound_sdr_activity_leaderboard_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Reps ranked by reply rate.
+
+A rep is only ranked once they have sent at least ten emails - the app's
+own floor, and the reason a rep who sent three and got one reply does not
+appear at 33%.
+
+Not the same report as `GET /analytics/sdr/leaderboard`, which already
+ships: that one ranks on the SDR analytics service's own activity roll-up,
+this one on outbound sequence performance. Different services, different
+numbers, both intentional.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+| `query.limit` | `integer` | no | Reps to return. default `20` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getSdrLeaderboard();
+```
+
+---
+
+<a id="op-getsequenceperformance"></a>
+
+### `g8.api.analytics.getSequencePerformance(input?)`
+
+**Get Sequence Performance**
+
+- HTTP: `GET /api/v1/analytics/outbound/sequence-performance`
+- operationId: `get_sequence_performance_analytics_outbound_sequence_performance_get` (also callable as `g8.api.call("get_sequence_performance_analytics_outbound_sequence_performance_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Contacts to replies to meetings, one row per sequence.
+
+The end-to-end view `/email-metrics/by-sequence` cannot give: that one
+stops at the reply, this one carries through to the meeting.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+| `query.limit` | `integer` | no | Sequences to return. default `50` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getSequencePerformance();
+```
+
+---
+
+<a id="op-getsequenceperformancebyid"></a>
+
+### `g8.api.analytics.getSequencePerformanceById(input)`
+
+**Get Sequence Performance By Id**
+
+- HTTP: `GET /api/v1/analytics/outbound/sequence-performance/{sequence_id}`
+- operationId: `get_sequence_performance_by_id_analytics_outbound_sequence_performance__sequence_id__get` (also callable as `g8.api.call("get_sequence_performance_by_id_analytics_outbound_sequence_performance__sequence_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+The same row for ONE sequence, without paging the list to find it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.sequence_id` | `string` | yes | Sequence id. |
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getSequencePerformanceById({ path: { sequence_id: "id" } });
+```
+
+---
+
+<a id="op-getteamcomparison"></a>
+
+### `g8.api.analytics.getTeamComparison(input?)`
+
+**Get Team Comparison**
+
+- HTTP: `GET /api/v1/analytics/outbound/sdr-activity/team-comparison`
+- operationId: `get_team_comparison_analytics_outbound_sdr_activity_team_comparison_get` (also callable as `g8.api.call("get_team_comparison_analytics_outbound_sdr_activity_team_comparison_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Team averages - the baseline an individual rep is read against.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getTeamComparison();
+```
+
+---
+
+<a id="op-gettoppages"></a>
+
+### `g8.api.analytics.getTopPages(input?)`
+
+**Get Top Pages**
+
+- HTTP: `GET /api/v1/analytics/product-usage/top-pages`
+- operationId: `get_top_pages_analytics_product_usage_top_pages_get` (also callable as `g8.api.call("get_top_pages_analytics_product_usage_top_pages_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Busiest in-app pages and event names by volume.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+| `query.limit` | `integer` | no | Rows per list. default `20` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getTopPages();
+```
+
+---
+
+<a id="op-gettrialconversion"></a>
+
+### `g8.api.analytics.getTrialConversion(input?)`
+
+**Get Trial Conversion**
+
+- HTTP: `GET /api/v1/analytics/subscriptions/trial-conversion`
+- operationId: `get_trial_conversion_analytics_subscriptions_trial_conversion_get` (also callable as `g8.api.call("get_trial_conversion_analytics_subscriptions_trial_conversion_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+Trial-to-paid rate and the median time it takes.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Trailing window, in days. default `60` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getTrialConversion();
+```
+
+---
+
+<a id="op-getvoiceaioutcomes"></a>
+
+### `g8.api.analytics.getVoiceAiOutcomes(input?)`
+
+**Get Voice Ai Outcomes**
+
+- HTTP: `GET /api/v1/analytics/outbound/call-metrics/voice-ai`
+- operationId: `get_voice_ai_outcomes_analytics_outbound_call_metrics_voice_ai_get` (also callable as `g8.api.call("get_voice_ai_outcomes_analytics_outbound_call_metrics_voice_ai_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+How the AI-placed calls ended, broken down by outcome.
+
+Voice AI only - the human dialer's own quality surface is
+`GET /analytics/dialer/*`, which already ships.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Size of the trailing window, in days, ending today (UTC). default `30` |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.getVoiceAiOutcomes();
+```
+
+---
+
+<a id="op-postdataquality"></a>
+
+### `g8.api.analytics.postDataQuality(input)`
+
+**Post Data Quality**
+
+- HTTP: `POST /api/v1/analytics/sales-report/data-quality`
+- operationId: `post_data_quality_analytics_sales_report_data_quality_post` (also callable as `g8.api.call("post_data_quality_analytics_sales_report_data_quality_post", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `analytics:read`
+
+The same diagnostic, narrowed to the deals one filter resolves.
+
+A SECOND VERB rather than a changed one: the GET above is unchanged, so
+"omit the filter and get today's answer" stays a structural fact rather
+than a claim about a defaulted parameter.
+
+Only the DEAL-anchored figures move. The transcript counters, the 90-day
+event total and the tier-rules flag come back org-wide on this path too,
+because no filter on this report can reach them.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `FilterQueryDto` | yes | Request body; fields below. |
+| `query.tz` | `string` | no | IANA timezone the local-day window bounds are computed in, e.g. `Asia/Tokyo`. Changes which deals fall inside the date range. default `"UTC"` |
+
+Body fields (`FilterQueryDto`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.date` | `DateRangeDto` | yes |  |
+| `body.audiences` | `IntIdFilterGroupDto \| null` | no |  |
+| `body.campaign` | `FilterGroupDto \| null` | no |  |
+| `body.channel` | `FilterGroupDto \| null` | no |  |
+| `body.country` | `FilterGroupDto \| null` | no |  |
+| `body.grading_bucket` | `GradingBucketFilterGroupDto \| null` | no |  |
+| `body.granularity` | `"day" \| "week" \| "month" \| null` | no |  |
+| `body.headcount` | `HeadcountFilterGroupDto \| null` | no |  |
+| `body.industry` | `FilterGroupDto \| null` | no |  |
+| `body.lifecycle` | `FilterGroupDto \| null` | no |  |
+| `body.objections` | `ObjectionCodeFilterGroupDto \| null` | no |  |
+| `body.pipeline` | `UuidFilterGroupDto \| null` | no |  |
+| `body.pipeline_target` | `"prospects_meeting" \| "prospects_revenue" \| "customers_revenue" \| null` | no | default `"prospects_revenue"` |
+| `body.rec_type` | `IntIdFilterGroupDto \| null` | no |  |
+| `body.rep` | `FilterGroupDto \| null` | no |  |
+| `body.signals_calendar` | `FilterGroupDto \| null` | no |  |
+| `body.signals_chat` | `FilterGroupDto \| null` | no |  |
+| `body.signals_crm` | `FilterGroupDto \| null` | no |  |
+| `body.signals_email` | `FilterGroupDto \| null` | no |  |
+| `body.signals_enrichment` | `FilterGroupDto \| null` | no |  |
+| `body.signals_forms` | `FilterGroupDto \| null` | no |  |
+| `body.signals_intent` | `FilterGroupDto \| null` | no |  |
+| `body.signals_linkedin` | `FilterGroupDto \| null` | no |  |
+| `body.signals_sequence` | `FilterGroupDto \| null` | no |  |
+| `body.signals_sms` | `FilterGroupDto \| null` | no |  |
+| `body.signals_voice` | `FilterGroupDto \| null` | no |  |
+| `body.signals_website` | `FilterGroupDto \| null` | no |  |
+| `body.stage` | `UuidFilterGroupDto \| null` | no |  |
+| `body.tier` | `FilterGroupDto \| null` | no |  |
+
+**Returns** `ApiResponse_ReportPayload_`: the envelope `{ data: ReportPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.analytics.postDataQuality({ body: { date: { from: "2026-01-01", to: "2026-01-01" } } });
+```
+
+---
+
+## Referenced types
+
+Named types that appear in the tables above. Full TypeScript definitions: `G8Contract.<Name>` (`import type { G8Contract } from "@graph8/sdk"`).
+
+<a id="type-campaignvisitorcontact"></a>
+
+### `CampaignVisitorContact`
+
+One row of the Top contacts table. Carries PII (``name`` / ``email``) for the org's own contacts. Omitted entirely from the response when the request passes ``include_contacts=false``.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `contact_id` | `integer` | yes | Per-org contact id |
+| `visits` | `integer` | yes | Click events by this contact in the window |
+| `email` | `string \| null` | no | Contact work email when resolvable (PII) |
+| `last_path` | `string \| null` | no | Most recent path this contact clicked to |
+| `last_seen` | `string \| null` | no | Latest click timestamp (ISO) |
+| `name` | `string \| null` | no | Contact full name when resolvable (PII) |
+| `step_id` | `string \| null` | no | Sequencer step the click was attributed to |
+| `step_label` | `string \| null` | no | Human-readable step label when resolvable |
+
+<a id="type-campaignvisitorlink"></a>
+
+### `CampaignVisitorLink`
+
+One row of the Email Link Engagement table (a clicked destination URL).
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `events` | `integer` | yes | Human click events on this URL (scanner-filtered) |
+| `host` | `string` | yes | Clicked destination host |
+| `path` | `string` | yes | Clicked destination path |
+| `unique_contacts` | `integer` | yes | Distinct contacts who clicked this URL |
+| `ctr_percent` | `number \| null` | no | events ÷ emails_with_link × 100, clamped [0,100]; null when no denominator |
+| `emails_with_link` | `integer \| null` | no | Sends whose template embedded this URL (CTR denominator) |
+| `last_seen` | `string \| null` | no | Latest click timestamp (ISO) |
+| `step_ids` | `Array<string>` | no | Sequencer steps whose links drove these clicks |
+| `step_labels` | `Array<string> \| null` | no | Human-readable labels for step_ids when resolvable |
+
+<a id="type-campaignvisitorstep"></a>
+
+### `CampaignVisitorStep`
+
+One row of the Top campaign steps table.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `events` | `integer` | yes | Campaign click events attributed to this step |
+| `step_id` | `string` | yes | Sequencer step id (globally-unique CUID) |
+| `unique_contacts` | `integer` | yes | Distinct contacts who clicked from this step |
+| `emails_sent` | `integer \| null` | no | EMAIL sends dispatched from this step in the window |
+| `emails_with_link` | `integer \| null` | no | Of those sends, how many carried a link |
+| `first_seen` | `string \| null` | no | Earliest click timestamp (ISO) |
+| `last_seen` | `string \| null` | no | Latest click timestamp (ISO) |
+| `step_label` | `string \| null` | no | Human-readable '{sequence} / Step {n}' when resolvable |
+
+<a id="type-campaignvisitorssummary"></a>
+
+### `CampaignVisitorsSummary`
+
+KPI tiles for the org's campaign-click activity in the window. All click-derived counters are email-security-scanner filtered (humans only) when ``SEQUENCER_VISITOR_SCANNER_FILTER=enforce`` — the same honest counts the in-app report shows. ``total_page_events`` is all page volume (not filtered).
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `contact_rows` | `integer` | yes | Total (contact, step) click groups before the `limit` cap |
+| `encrypted_pageviews` | `integer` | yes | Diagnostic: campaign clicks with an encrypted (#c=e1.) hash |
+| `identified_visitors` | `integer` | yes | Distinct identified web sessions on campaign clicks |
+| `jitsu_wired` | `boolean` | yes | False when the org has no visitor-tracking pipeline / no page events |
+| `link_rows` | `integer` | yes | Total distinct clicked (host, path) before the ceiling |
+| `pageview_events` | `integer` | yes | Parseable campaign-attributed click events |
+| `plaintext_pageviews` | `integer` | yes | Diagnostic: campaign clicks with a plaintext hash |
+| `step_rows` | `integer` | yes | Total distinct campaign steps before the `limit` cap |
+| `total_page_events` | `integer` | yes | All page events in the window (campaign + non-campaign) |
+| `unique_campaign_steps` | `integer` | yes | Distinct sequencer steps that drew clicks |
+| `unique_contacts` | `integer` | yes | Distinct contacts who clicked a campaign link |
+| `unparseable_pageviews` | `integer` | yes | Campaign clicks whose tracking hash could not be decoded |
+
+<a id="type-campaignvisitorswindow"></a>
+
+### `CampaignVisitorsWindow`
+
+The resolved reporting window echoed back to the caller.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `days` | `integer` | yes | Inclusive calendar-day span of the window |
+| `end_date` | `string` | yes | Window end (inclusive), YYYY-MM-DD |
+| `mode` | `string` | yes | 'anchored' (explicit start/end) or 'rolling' (last-N-days) |
+| `start_date` | `string` | yes | Window start (inclusive), YYYY-MM-DD |
+
+<a id="type-daterangedto"></a>
+
+### `DateRangeDto`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `from` | `string (date)` | yes |  |
+| `to` | `string (date)` | yes |  |
+
+<a id="type-filtergroupdto"></a>
+
+### `FilterGroupDto`
+
+One filter group — list of values + optional NOT toggle. ``in_`` is capped at ``MAX_FILTER_VALUES_PER_GROUP`` items of ``MAX_FILTER_VALUE_LENGTH`` characters each. Over-cap input raises during body parsing, so FastAPI answers 422 with the offending group named in ``detail[].loc`` (``["body", "<group>", "in"]``) and the cap in ``detail[].msg`` — no handler code, and therefore no SQL, runs. THIS SHAPE DOES NOT NEST. ``in_`` holds scalars and there is no group-of-groups member, so a caller cannot vary the tree depth: it is fixed at 2 (query -> group -> values) by construction, and ``extra="forbi…
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `in` | `Array<string>` | no | max items 1000 |
+| `not` | `boolean` | no | default `false` |
+
+<a id="type-gradingbucketfiltergroupdto"></a>
+
+### `GradingBucketFilterGroupDto`
+
+`grading_bucket` — a CLOSED vocabulary (`GRADING_BUCKETS`). An unknown bucket produces no band clause and widens to the full book.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `in` | `Array<"high" \| "med" \| "low">` | no | max items 1000 |
+| `not` | `boolean` | no | default `false` |
+
+<a id="type-headcountfiltergroupdto"></a>
+
+### `HeadcountFilterGroupDto`
+
+`headcount` — a CLOSED vocabulary (`HEADCOUNT_BANDS`), and the exact list `/filter-options` hands the client.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `in` | `Array<"1-10" \| "11-50" \| "51-200" \| "201-1000" \| "1001+">` | no | max items 1000 |
+| `not` | `boolean` | no | default `false` |
+
+<a id="type-intidfiltergroupdto"></a>
+
+### `IntIdFilterGroupDto`
+
+`rec_type` / `audiences` — `Lead.rec_type` is `SmallInteger` and `audience_id` is `Integer`; both appliers coerce and skip what will not parse.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `in` | `Array<string>` | no | max items 1000 |
+| `not` | `boolean` | no | default `false` |
+
+<a id="type-objectioncodefiltergroupdto"></a>
+
+### `ObjectionCodeFilterGroupDto`
+
+`objections` — codes live in the PER-ORG `cb_objection_codes` catalog, so only the SHAPE can be checked here. Blank is the one thing the applier provably cannot use.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `in` | `Array<string>` | no | max items 1000 |
+| `not` | `boolean` | no | default `false` |
+
+<a id="type-uuidfiltergroupdto"></a>
+
+### `UuidFilterGroupDto`
+
+`pipeline` / `stage` — `CBDeal.pipeline_id` and `.stage_id` are real `PostgresUUID` columns, so a non-UUID can only ever fail open.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `in` | `Array<string>` | no | max items 1000 |
+| `not` | `boolean` | no | default `false` |