useyuva 0.0.10 → 0.0.12

package/dist/types/schema.gen.d.ts

@@ -1429,6 +1429,33 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/contacts/{contactId}/visits": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * A contact's recent visits
+         * @description The visits linked to the contact on the analytics properties the caller can see, newest
+         *     first, from the raw window (`YUVA_ANALYTICS_RAW_DAYS`). A visit is linked only when the
+         *     visitor consented to the `persistent` and `identify` features of the property and the
+         *     host's backend identified them with a valid identity token; visits of anyone else are never
+         *     joined to a contact, so for most contacts the list is empty. Deleting the contact deletes
+         *     these visits; merging contacts moves them.
+         *
+         *     Scopes: `contacts:read` and `analytics:read`.
+         */
+        get: operations["listContactVisits"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/contacts/{contactId}/subscriptions": {
         parameters: {
             query?: never;
@@ -4708,7 +4735,8 @@ export interface paths {
          *     (one column per dimension and metric) instead.
          *
          *     A visitor exists for one day (its salt does), so `visitors` over a range is the sum of each
-         *     day's visitors. Finished days are read from daily rollups and open days (today, yesterday
+         *     day's visitors; only a visitor who consented to the `persistent` feature counts once over
+         *     the range (`AnalyticsMetric`). Finished days are read from daily rollups and open days (today, yesterday
          *     until it is rolled up, days with late events) from raw rows; `meta.served_from` says which.
          *     Totals, any single dimension, totals with one `is` filter on a visit dimension, and pages
          *     with one `is` filter on `channel`, `source` or `country` come from rollups. Other
@@ -4721,6 +4749,10 @@ export interface paths {
          *     raw rows inside the raw window, for any prop key, and the rollups of the property's
          *     `tracked_props` before it. `segment_id` adds a saved segment's filters.
          *
+         *     `dataset: support` puts the linked inbox's conversations, page feedback, page ratings and
+         *     discussions next to each page's views (`AnalyticsDataset`). `insights: true` adds fixed-rule
+         *     `insights` to the answer.
+         *
          *     Queries run for at most 15 seconds and four at a time per workspace; a fifth waits up to
          *     two seconds and then answers `429`. Answers about finished days are cached for ten minutes,
          *     answers that include today for 30 seconds.
@@ -4757,6 +4789,110 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/analytics/properties/{propertyId}/events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Send server-side analytics events
+         * @description A host backend reports up to 100 events of its visitors, such as a signup its server
+         *     handled, with `sdk/go/analytics` or any HTTP client. API keys only (`403 forbidden` for
+         *     members' sessions); a key limited to inboxes reaches the properties of its inboxes. Scope:
+         *     `analytics:write`.
+         *
+         *     Each event names its visitor in one of two ways, neither stored:
+         *     - `ip` and `user_agent` forwarded from the visitor's request, with `sec_ch_ua_platform`
+         *       and `sec_ch_ua_mobile` when the request had them. They are hashed exactly as the
+         *       collection endpoint hashes the browser's own request, so the event joins the visitor's
+         *       browser visit of that day; the address is shortened first and used for the location,
+         *       excluded addresses and the per-address limit like a browser's.
+         *     - `visitor_key`, the backend's own key for the visitor (a session id, never an e-mail
+         *       address), hashed under the day's salt like an app's process key. With it, `ip` only
+         *       places the visitor and `user_agent` only describes the device.
+         *
+         *     A visitor who consented to `persistent` in the browser or app can be named by the
+         *     `persistent_id` it holds, with `consent: true`, so the event joins that visitor's days;
+         *     `identity_token` with it identifies them, as `AnalyticsConsent` describes.
+         *
+         *     `url` is the page (http(s), on one of the property's `domains`) or, for a property with
+         *     `ios` or `android`, an app screen (`app://<app id>/<screen>`). A visit that a server event
+         *     starts has platform `server`. `name` is `pageview` or a custom or built-in event with the
+         *     rules of `AnalyticsEvent`; `engagement` is for browsers only. `timestamp` defaults to now;
+         *     an event older than 72 hours is dropped as `late`.
+         *
+         *     Invalid events are left out on their own and listed in `errors`; the others are taken.
+         *     Taken but not stored, as on the collection endpoint and counted in the property's health:
+         *     events with `dnt` or `gpc`; events of a `consent` property without `consent: true`; events
+         *     from bots, excluded addresses or paths; events over the per-address or per-property limit
+         *     or the workspace's monthly cap. When the server cannot take more events it answers `503`
+         *     with `Retry-After`.
+         */
+        post: operations["sendAnalyticsEvents"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/analytics/properties/{propertyId}/retention": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * How consented visitors come back
+         * @description Cohorts of the visitors with a persistent id (the `persistent` consent feature): each
+         *     cohort holds the visitors first seen in one day, week (from Monday) or month of the
+         *     property's time zone, and `periods[n]` how many of them came back in the n-th period after
+         *     it, `periods[0]` being the cohort itself. Days go up to 30 periods, weeks and months up to
+         *     12. Visitors without consent are never in a cohort, so a property without the feature has
+         *     none. The cohorts job rebuilds the numbers every hour (`built_at`); a persistent id is
+         *     forgotten 13 months after it was first seen, so cohorts reach back at most that far.
+         *
+         *     Scope: `analytics:read`.
+         */
+        get: operations["getAnalyticsRetention"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/analytics/properties/{propertyId}/visitors/{persistentId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete a consented visitor's analytics
+         * @description For a person's erasure request: deletes everything stored under a persistent id (the
+         *     value their browser or app holds, `AnalyticsConsent.p`), its raw visits and events, its
+         *     cohort days and its link to a contact. Days already rolled up are rolled up again without
+         *     them. Answers `204` whether or not anything was stored under the id. Owners, admins and
+         *     API keys without an inbox limit.
+         *
+         *     Scope: `analytics:manage`.
+         */
+        delete: operations["deleteAnalyticsVisitor"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/analytics/properties/{propertyId}/health": {
         parameters: {
             query?: never;
@@ -4908,7 +5044,9 @@ export interface paths {
          * How visitors went through a funnel
          * @description Per step, the visitors who completed it after every step before it within one visit, from
          *     the raw events of the range. A visitor exists for one day, so a funnel never crosses
-         *     midnight; visitors over a range are added up per day. The range must lie inside the raw
+         *     midnight; visitors over a range are added up per day. Visitors with a persistent id (the
+         *     `persistent` consent feature) are also followed across visits and days of the range, in
+         *     `consented_visitors`. The range must lie inside the raw
          *     window (`422 needs_raw_window`) and span at most 90 days, or 31 when the property counted
          *     more than 10 million events over the last 30 days (`422 range_too_large`). Answers are
          *     cached for ten minutes.
@@ -5042,6 +5180,269 @@ export interface paths {
         patch: operations["updateAnalyticsAnnotation"];
         trace?: never;
     };
+    "/v1/analytics/properties/{propertyId}/subscription": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get my reports and alerts of a property
+         * @description The calling member's e-mail report (`none`, `weekly`, `monthly`) and the alert kinds they
+         *     get by e-mail for the property; `none` and no alerts until they choose. Member session only.
+         */
+        get: operations["getAnalyticsSubscription"];
+        /**
+         * Choose my reports and alerts of a property
+         * @description Weekly reports go out on Monday morning (08:00 in the property's time zone) about the week
+         *     before, monthly ones on the 1st about the month before, in the member's language, to the
+         *     member's address: plain numbers, no images, nothing that tracks opening or clicks. Alerts
+         *     are fixed rules checked every hour (`AnalyticsAlertKind`); each alert is sent once. Member
+         *     session only; the member must see the property.
+         */
+        put: operations["updateAnalyticsSubscription"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/analytics/properties/{propertyId}/subscription/send-report": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Send me a report now
+         * @description Mails the calling member the report of the last seven finished days (`weekly`) or the last
+         *     month (`monthly`, by the subscription; `weekly` when there is none), so they see what it
+         *     looks like. Five an hour per member (`429`). Member session only.
+         */
+        post: operations["sendAnalyticsReport"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/analytics/properties/{propertyId}/alerts": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List a property's alerts
+         * @description The alerts the property raised, newest first, at most 100; each also has an annotation on
+         *     its day and an `analytics.alert` event and webhook. With `before`, older ones.
+         *
+         *     Scope: `analytics:read`.
+         */
+        get: operations["listAnalyticsAlerts"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/analytics/properties/{propertyId}/shares": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List a property's share links
+         * @description Newest first, revoked and expired links included (`active` tells them apart). A link's
+         *     token is shown only once, when it is made; the list carries its first characters as
+         *     `token_prefix`.
+         *
+         *     Scope: `analytics:read`.
+         */
+        get: operations["listAnalyticsShares"];
+        put?: never;
+        /**
+         * Make a read-only share link
+         * @description A link anyone holding it can open at `<public URL>/share/<token>` without signing in. It
+         *     shows only the `views` it lists, of this property only, read-only. With a `password` the
+         *     viewer unlocks it first (`POST /client/v1/analytics-shares/{token}/access`); the password
+         *     is stored as an argon2id hash and the token as a SHA-256 hash, so neither can be shown
+         *     again: the answer carries the `token` and the `url` once. `expires_at` ends the link;
+         *     `embed_origins` lists the sites whose pages may show it in an iframe (the share page's
+         *     `frame-ancestors`); without them no other site can frame it. A property has at most 50
+         *     links (`403 share_limit`).
+         *
+         *     Owners, admins and API keys without an inbox limit. Scope: `analytics:manage`.
+         */
+        post: operations["createAnalyticsShare"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/analytics/properties/{propertyId}/shares/{shareId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete a share link
+         * @description The link stops working at once and leaves the list.
+         *
+         *     Owners, admins and API keys without an inbox limit. Scope: `analytics:manage`.
+         */
+        delete: operations["deleteAnalyticsShare"];
+        options?: never;
+        head?: never;
+        /**
+         * Change a share link
+         * @description Changes the given fields; the token stays. A new `password` (or `password: null`, which
+         *     removes it) ends every viewer's unlocked access at once. `expires_at: null` keeps the link
+         *     until it is revoked. A revoked link cannot be changed (`409 share_revoked`).
+         *
+         *     Owners, admins and API keys without an inbox limit. Scope: `analytics:manage`.
+         */
+        patch: operations["updateAnalyticsShare"];
+        trace?: never;
+    };
+    "/v1/analytics/properties/{propertyId}/shares/{shareId}/revoke": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Revoke a share link
+         * @description The link stops working at once and stays in the list with `revoked_at`. Revoking a revoked
+         *     link changes nothing.
+         *
+         *     Owners, admins and API keys without an inbox limit. Scope: `analytics:manage`.
+         */
+        post: operations["revokeAnalyticsShare"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/analytics/properties/{propertyId}/exports": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List a property's exports
+         * @description Newest first, until each expires. `raw` exports are listed only for callers who may make
+         *     them.
+         *
+         *     Scope: `analytics:read`.
+         */
+        get: operations["listAnalyticsExports"];
+        put?: never;
+        /**
+         * Export a property's numbers or raw events
+         * @description A background job writes the file to the server's storage; poll `getAnalyticsExport` until
+         *     `status` is `done`, then download it with `downloadAnalyticsExport`. Files are kept seven
+         *     days (`expires_at`) and then deleted.
+         *
+         *     - `view`: the rows of one `query` (as `queryAnalytics` answers it, every row, no
+         *       comparison), CSV or NDJSON.
+         *     - `daily`: one row per day of `range` (at most 400 days) with visitors, visits, page views,
+         *       views per visit, bounce rate, visit duration, time on page and scroll depth, broken down
+         *       by `dimension` when given, CSV or NDJSON.
+         *     - `raw`: every stored event of `range` (at most 31 days, inside the raw window of
+         *       `YUVA_ANALYTICS_RAW_DAYS`, else `422 needs_raw_window`) with its visit's description, as
+         *       NDJSON only (`AnalyticsRawEvent`). It carries no visitor hash, salt, address, contact or
+         *       stored visit id: a visit is a number that counts up within the file. Bots are left out.
+         *       Raw rows are pseudonymous personal data, so raw exports need `analytics:manage` and an
+         *       owner, an admin or an API key without an inbox limit (`403`).
+         *
+         *     CSV cells that start with `=`, `+`, `-`, `@`, a tab or a carriage return get a leading `'`
+         *     so spreadsheets do not run them as formulas. A file larger than 1 GiB fails with
+         *     `error` `too_large`. A workspace runs at most three exports at a time (`429 rate_limited`).
+         *
+         *     Scope: `analytics:read`; `analytics:manage` for `raw`.
+         */
+        post: operations["createAnalyticsExport"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/analytics/properties/{propertyId}/exports/{exportId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * An export and its progress
+         * @description Scope: `analytics:read`; `analytics:manage` for `raw`.
+         */
+        get: operations["getAnalyticsExport"];
+        put?: never;
+        post?: never;
+        /**
+         * Delete an export
+         * @description Deletes the export and its file before it expires; one still running stops at its next
+         *     step.
+         *
+         *     Scope: `analytics:read`; `analytics:manage` for `raw`.
+         */
+        delete: operations["deleteAnalyticsExport"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/analytics/properties/{propertyId}/exports/{exportId}/download": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Download an export's file
+         * @description `text/csv` or `application/x-ndjson`, always as a download (`Content-Disposition:
+         *     attachment`). An export that is not `done` answers `409 export_not_ready`; an expired or
+         *     deleted one `404`. Links cannot carry headers, so the workspace can also be named with the
+         *     `workspace_id` query parameter instead of `Yuva-Workspace`.
+         *
+         *     Scope: `analytics:read`; `analytics:manage` for `raw`.
+         */
+        get: operations["downloadAnalyticsExport"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/realtime": {
         parameters: {
             query?: never;
@@ -5601,9 +6002,15 @@ export interface paths {
         /**
          * Start a conversation
          * @description Starts a conversation on the session's channel with its first message. Send
-         *     `multipart/form-data` to attach files (`body`, `subject`, `client_id` as form fields and up
-         *     to 10 `files` parts), with the same size and type rules as `/v1`. Rate limited per IP
-         *     address and per channel.
+         *     `multipart/form-data` to attach files (`body`, `subject`, `client_id`, `page_url` and
+         *     `page_title` as form fields and up to 10 `files` parts), with the same size and type rules
+         *     as `/v1`. Rate limited per IP address and per channel.
+         *
+         *     `page_url` is the page the conversation starts on, kept without query and fragment only
+         *     when the channel is a chat channel and the page's origin is one of its allowed origins;
+         *     otherwise `page_url` and `page_title` are dropped and the conversation starts without a
+         *     page. The page never refuses a conversation. It is shown as `page` on the conversation and
+         *     counted per page, and never joined to a visitor of Analytics.
          */
         post: operations["createClientConversation"];
         delete?: never;
@@ -5835,16 +6242,41 @@ export interface paths {
          *
          *     A browser's `Origin` host and every event's page host (`u`) must be one of the property's
          *     `domains` (`403 origin_not_allowed`, `403 page_not_allowed`); refusals carry
-         *     `Access-Control-Allow-Origin` so the script can read them. Requests without an `Origin`
-         *     are refused until app collection exists. An unknown or deleted key answers `404`.
+         *     `Access-Control-Allow-Origin` so the script can read them. An unknown or deleted key
+         *     answers `404`.
+         *
+         *     Apps (the Swift and Kotlin SDKs) send without an `Origin`, always in the batch form with
+         *     `k` and `a` (`AnalyticsEventBatch`), to a property whose `platforms` hold `a.platform`
+         *     (`403 platform_not_allowed` otherwise; a request without an `Origin` to a property with
+         *     neither `ios` nor `android` answers `403 origin_not_allowed`). A screen is a page view whose
+         *     `u` is `app://<app id>/<screen>`; the app id is the visit's `hostname` and is not checked
+         *     against `domains`. The visitor is a keyed hash of `k`, a random key the app holds in memory
+         *     for the life of its process, under the salt of the event's day, or of the day the event
+         *     arrives once that day's salt is gone: a new process is a new visitor and a new visit. Events
+         *     carry their own time in `t`; one older than 72 hours is dropped and counted as `late`, one
+         *     in the future is taken as now. The browser-only header rules for bots do not apply to apps,
+         *     the volume rules do.
          *
          *     Custom and built-in events carry props (`p`) and revenue (`$`) within the limits of
-         *     `AnalyticsEvent`; an event that breaks them, an `outbound_click` or `file_download` without
-         *     an http(s) `url` prop (for `outbound_click` on another host), or revenue on a page view
-         *     answers `400` for the whole request.
+         *     `AnalyticsEvent`. An invalid event (a `u` that is not an http(s) URL, a reserved name, props
+         *     or revenue that break those limits, revenue on a page view or engagement, an
+         *     `outbound_click` or `file_download` without an http(s) `url` prop, or an `outbound_click`
+         *     to the page's own host) answers `400` with the reason when it is sent alone. In a batch
+         *     it is dropped on its own and counted as `invalid` in the property's health, the batch's
+         *     other events are taken, and the answer is `202`. A body that is not JSON or does not match
+         *     `AnalyticsBatch`, a body over 64 KiB, a refused origin or page host and an unknown key
+         *     still refuse the whole request.
+         *
+         *     Consent features (`AnalyticsConsent`): an event with `c.a: 1` and a persistent id `c.p`, on
+         *     a general-audience property that offers `persistent`, is the visitor of that id on every
+         *     day instead of the day's hash; `c.j` with it, on a property that also offers `identify`,
+         *     links the id to a contact. Without them, or on any other property, the event is counted
+         *     exactly as in default mode. `yuva_consent` carries an identification or a withdrawal at
+         *     once and is never stored; 20 a minute per shortened address and property.
          *
-         *     Accepted but not stored, still `202`: every request with `Sec-GPC: 1` or `DNT: 1`; events
-         *     of a `consent` property that do not carry `c.a: 1`; events from an excluded address or
+         *     Accepted but not stored, still `202`: every request with `Sec-GPC: 1` or `DNT: 1` (but for
+         *     a `yuva_consent` withdrawal); events
+         *     older than 72 hours; events of a `consent` property that do not carry `c.a: 1`; events from an excluded address or
          *     path; events over the property's per-minute limit or the workspace's monthly cap. One
          *     shortened address may send 120 events a minute to a property (`429 rate_limited` with
          *     `Retry-After`). When the server cannot take more events it answers `503` with
@@ -5857,7 +6289,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/client/v1/realtime": {
+    "/client/v1/analytics-shares/{token}": {
         parameters: {
             query?: never;
             header?: never;
@@ -5865,18 +6297,124 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Live events for a contact (WebSocket)
-         * @description Upgrades to a WebSocket that streams the events of the contact's own conversations in the
-         *     session's inbox. Authenticate with the session token, either as the `token` query
-         *     parameter or as a WebSocket subprotocol: offer `yuva` and `yuva.token.<token>`
-         *     (`new WebSocket(url, ["yuva", "yuva.token." + token])`); the server selects `yuva`.
-         *     Cookies are not used. A browser's `Origin` must be one of the channel's allowed origins.
+         * A share link's page settings
+         * @description What the public share page (`<public URL>/share/<token>`, served by the panel) needs first.
+         *     A link with a password answers only `password_required: true` until the request carries
+         *     an access token from `unlockSharedAnalytics` as `Authorization: Bearer yuva_sa_…`; then,
+         *     like a link without a password, it answers the views it may show, the property's name,
+         *     time zone and currency, the raw window, its goals (with the `goals` view) and the GeoIP
+         *     attribution to show next to locations.
          *
-         *     Every server message is one JSON text frame matching `ClientRealtimeMessage`. Stored events
-         *     (`conversation.created`, `conversation.updated`, `message.created`, `message.updated`,
-         *     `read`) carry an increasing `id`; resume exactly as on `/v1/realtime`: remember the larger
-         *     of `ready.last_event_id` and the last `id` received, reconnect with `?last_event_id=`, and
-         *     reload over HTTP on `resync_required`. `typing`, `presence` and `inbox.updated` have no
+         *     The share page itself is served with `Content-Security-Policy: frame-ancestors` set to the
+         *     link's `embed_origins` (`'none'` without them, an unknown, revoked or expired link included),
+         *     so only those sites can show it in an iframe; it carries no analytics script.
+         *
+         *     An unknown, revoked or expired token answers `404`. Every share endpoint is limited per IP
+         *     address (`429 rate_limited` with `Retry-After`).
+         */
+        get: operations["getSharedAnalytics"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/client/v1/analytics-shares/{token}/access": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Unlock a share link with its password
+         * @description Answers an access token for the link's other endpoints, valid for 12 hours or until the
+         *     link expires, is revoked or gets another password. A wrong password answers
+         *     `401 wrong_password`; an IP address may try 10 times a minute per link and 30 times a minute
+         *     in all (`429 rate_limited`). A link without a password answers `409 no_password`.
+         */
+        post: operations["unlockSharedAnalytics"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/client/v1/analytics-shares/{token}/query": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Query a shared property's numbers
+         * @description `queryAnalytics` for a share link, with the same body and answer, limited to the link's
+         *     views: totals and time grains with any view; `page`, `entry_page`, `exit_page` and
+         *     `hostname` with `pages`; `channel`, `source`, `referrer` and the UTM dimensions with
+         *     `sources`; `country`, `region` and `city` with `locations`; `device`, `browser`,
+         *     `browser_version`, `os`, `os_version`, `screen_size`, `language`, `platform` and
+         *     `app_version` with `devices`; `event`, `prop` and the `events` metric with `events`; a
+         *     `goal_id` of the property and the goal metrics with `goals`. Dimensions and filters outside
+         *     them answer `403 view_not_shared`; `segment_id` is refused (`400`).
+         *
+         *     A link with a password needs its access token (`401 share_password_required`). Answers are
+         *     cached like `queryAnalytics` and count towards the workspace's four concurrent queries.
+         */
+        post: operations["querySharedAnalytics"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/client/v1/analytics-shares/{token}/realtime": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * A shared property's last 30 minutes
+         * @description `getAnalyticsRealtime` for a share link with the `realtime` view (`403 view_not_shared`
+         *     otherwise). A link with a password needs its access token (`401 share_password_required`).
+         */
+        get: operations["getSharedAnalyticsRealtime"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/client/v1/realtime": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Live events for a contact (WebSocket)
+         * @description Upgrades to a WebSocket that streams the events of the contact's own conversations in the
+         *     session's inbox. Authenticate with the session token, either as the `token` query
+         *     parameter or as a WebSocket subprotocol: offer `yuva` and `yuva.token.<token>`
+         *     (`new WebSocket(url, ["yuva", "yuva.token." + token])`); the server selects `yuva`.
+         *     Cookies are not used. A browser's `Origin` must be one of the channel's allowed origins.
+         *
+         *     Every server message is one JSON text frame matching `ClientRealtimeMessage`. Stored events
+         *     (`conversation.created`, `conversation.updated`, `message.created`, `message.updated`,
+         *     `read`) carry an increasing `id`; resume exactly as on `/v1/realtime`: remember the larger
+         *     of `ready.last_event_id` and the last `id` received, reconnect with `?last_event_id=`, and
+         *     reload over HTTP on `resync_required`. `typing`, `presence` and `inbox.updated` have no
          *     `id` and are not replayed. `message.*` carries only messages (no notes or internal events),
          *     and `conversation.updated` only the status. `typing` (a member typing), `read` (how far
          *     members have read) and `presence` (whether someone is available; sent after `ready` and
@@ -6480,6 +7018,27 @@ export interface webhooks {
         patch?: never;
         trace?: never;
     };
+    "analytics.alert": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * A property raised an alert
+         * @description A spike, a drop, a goal drop, support load or a new referrer (`AnalyticsAlertKind`), once
+         *     per alert. Endpoints of an inbox get the alerts of properties linked to that inbox.
+         */
+        post: operations["webhookAnalyticsAlert"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export interface components {
     schemas: {
@@ -7532,7 +8091,7 @@ export interface components {
             count: number;
         };
         /** @enum {string} */
-        WebhookEventType: "conversation.created" | "conversation.updated" | "conversation.rated" | "message.created" | "feedback.created" | "contact.updated" | "contact.deleted" | "draft.created" | "draft.updated" | "draft.deleted" | "discussion.created" | "discussion.post_created" | "discussion.answered" | "discussion.updated" | "subscription.created" | "subscription.updated" | "broadcast.updated";
+        WebhookEventType: "conversation.created" | "conversation.updated" | "conversation.rated" | "message.created" | "feedback.created" | "contact.updated" | "contact.deleted" | "draft.created" | "draft.updated" | "draft.deleted" | "discussion.created" | "discussion.post_created" | "discussion.answered" | "discussion.updated" | "subscription.created" | "subscription.updated" | "broadcast.updated" | "analytics.alert";
         WebhookEndpoint: {
             /** Format: uuid */
             id: string;
@@ -9953,7 +10512,7 @@ export interface components {
             type: "resync_required";
         };
         /** @description An event as `GET /v1/events` returns it, told apart by `type`; the same objects realtime and webhooks carry. */
-        StoredEvent: components["schemas"]["ConversationEvent"] | components["schemas"]["ConversationMovedEvent"] | components["schemas"]["MessageCreatedEvent"] | components["schemas"]["MessageUpdatedEvent"] | components["schemas"]["DraftEvent"] | components["schemas"]["ContactUpdatedEvent"] | components["schemas"]["ContactDeletedEvent"] | components["schemas"]["InboxCreatedEvent"] | components["schemas"]["InboxUpdatedEvent"] | components["schemas"]["InboxDeletedEvent"] | components["schemas"]["InboxAccessChangedEvent"] | components["schemas"]["ConversationReadEvent"] | components["schemas"]["ContactReadEvent"] | components["schemas"]["ConversationPinEvent"] | components["schemas"]["DiscussionEvent"] | components["schemas"]["SubscriptionEvent"] | components["schemas"]["BroadcastEvent"] | components["schemas"]["MigrationEvent"];
+        StoredEvent: components["schemas"]["ConversationEvent"] | components["schemas"]["ConversationMovedEvent"] | components["schemas"]["MessageCreatedEvent"] | components["schemas"]["MessageUpdatedEvent"] | components["schemas"]["DraftEvent"] | components["schemas"]["ContactUpdatedEvent"] | components["schemas"]["ContactDeletedEvent"] | components["schemas"]["InboxCreatedEvent"] | components["schemas"]["InboxUpdatedEvent"] | components["schemas"]["InboxDeletedEvent"] | components["schemas"]["InboxAccessChangedEvent"] | components["schemas"]["ConversationReadEvent"] | components["schemas"]["ContactReadEvent"] | components["schemas"]["ConversationPinEvent"] | components["schemas"]["DiscussionEvent"] | components["schemas"]["SubscriptionEvent"] | components["schemas"]["BroadcastEvent"] | components["schemas"]["MigrationEvent"] | components["schemas"]["AnalyticsAlertEvent"];
         EventPage: {
             events: components["schemas"]["StoredEvent"][];
             /**
@@ -9972,7 +10531,7 @@ export interface components {
             id: number;
         };
         /** @description One server message on `/v1/realtime`, told apart by `type`. */
-        RealtimeMessage: components["schemas"]["ConversationEvent"] | components["schemas"]["ConversationMovedEvent"] | components["schemas"]["MessageCreatedEvent"] | components["schemas"]["MessageUpdatedEvent"] | components["schemas"]["DraftEvent"] | components["schemas"]["ContactUpdatedEvent"] | components["schemas"]["ContactDeletedEvent"] | components["schemas"]["InboxCreatedEvent"] | components["schemas"]["InboxUpdatedEvent"] | components["schemas"]["InboxDeletedEvent"] | components["schemas"]["InboxAccessChangedEvent"] | components["schemas"]["ConversationReadEvent"] | components["schemas"]["ContactReadEvent"] | components["schemas"]["ConversationPinEvent"] | components["schemas"]["DiscussionEvent"] | components["schemas"]["SubscriptionEvent"] | components["schemas"]["BroadcastEvent"] | components["schemas"]["MigrationEvent"] | components["schemas"]["MigrationProgressEvent"] | components["schemas"]["MigrationForwardingConfirmationEvent"] | components["schemas"]["BroadcastProgressEvent"] | components["schemas"]["ListImportEvent"] | components["schemas"]["ListImportProgressEvent"] | components["schemas"]["TypingEvent"] | components["schemas"]["MemberPresenceEvent"] | components["schemas"]["ContactPresenceEvent"] | components["schemas"]["ViewingEvent"] | components["schemas"]["RealtimeReady"] | components["schemas"]["RealtimeResyncRequired"];
+        RealtimeMessage: components["schemas"]["ConversationEvent"] | components["schemas"]["ConversationMovedEvent"] | components["schemas"]["MessageCreatedEvent"] | components["schemas"]["MessageUpdatedEvent"] | components["schemas"]["DraftEvent"] | components["schemas"]["ContactUpdatedEvent"] | components["schemas"]["ContactDeletedEvent"] | components["schemas"]["InboxCreatedEvent"] | components["schemas"]["InboxUpdatedEvent"] | components["schemas"]["InboxDeletedEvent"] | components["schemas"]["InboxAccessChangedEvent"] | components["schemas"]["ConversationReadEvent"] | components["schemas"]["ContactReadEvent"] | components["schemas"]["ConversationPinEvent"] | components["schemas"]["DiscussionEvent"] | components["schemas"]["SubscriptionEvent"] | components["schemas"]["BroadcastEvent"] | components["schemas"]["MigrationEvent"] | components["schemas"]["AnalyticsAlertEvent"] | components["schemas"]["MigrationProgressEvent"] | components["schemas"]["MigrationForwardingConfirmationEvent"] | components["schemas"]["BroadcastProgressEvent"] | components["schemas"]["ListImportEvent"] | components["schemas"]["ListImportProgressEvent"] | components["schemas"]["TypingEvent"] | components["schemas"]["MemberPresenceEvent"] | components["schemas"]["ContactPresenceEvent"] | components["schemas"]["ViewingEvent"] | components["schemas"]["RealtimeReady"] | components["schemas"]["RealtimeResyncRequired"];
         /**
          * @description `auto`: available in `live` inboxes while connected to `/v1/realtime` within business
          *     hours. `away`: never shown as available.
@@ -10605,6 +11164,14 @@ export interface components {
             audience: components["schemas"]["BroadcastAudience"];
             /** @description Links go through `/c/{token}` on the server's link domain and unique clicks are counted. Off by default. */
             click_tracking: boolean;
+            /**
+             * @description Links to the web get `utm_source=newsletter`, `utm_medium=email` and
+             *     `utm_campaign=<utm_campaign>` (a link that has a `utm_` parameter of its own keeps its
+             *     own), so Analytics counts the visits of the campaign. On by default.
+             */
+            utm: boolean;
+            /** @description The campaign's name in links; made from `name` when the broadcast is created. */
+            utm_campaign: string;
             state: components["schemas"]["BroadcastState"];
             pause_reason?: components["schemas"]["BroadcastPauseReason"];
             /** @description Why it paused or failed, in words (an SMTP answer, the rates). */
@@ -10663,6 +11230,10 @@ export interface components {
             design_id?: string;
             audience?: components["schemas"]["BroadcastAudienceInput"];
             click_tracking?: boolean;
+            /** @description On when absent at creation. */
+            utm?: boolean;
+            /** @description Lowercase letters, digits, `-`, `_` and `.`; made from `name` when absent at creation. */
+            utm_campaign?: string;
         };
         BroadcastUpdate: {
             /** Format: uuid */
@@ -10674,6 +11245,10 @@ export interface components {
             design_id?: string | null;
             audience?: components["schemas"]["BroadcastAudienceInput"];
             click_tracking?: boolean;
+            /** @description On when absent at creation. */
+            utm?: boolean;
+            /** @description Lowercase letters, digits, `-`, `_` and `.`; made from `name` when absent at creation. */
+            utm_campaign?: string;
         };
         BroadcastPage: {
             items: components["schemas"]["Broadcast"][];
@@ -10878,6 +11453,23 @@ export interface components {
             links?: components["schemas"]["BroadcastReportLink"][];
             /** @description The first 50 conversations opened by replies. */
             replies: components["schemas"]["BroadcastReportReply"][];
+            /**
+             * @description With `utm` and the scope `analytics:read`: per Analytics property the caller sees, the
+             *     visits whose `utm_campaign` is the broadcast's, from the day sending started; only
+             *     properties with any.
+             */
+            campaign_visits?: components["schemas"]["BroadcastCampaignVisits"][];
+        };
+        BroadcastCampaignVisits: {
+            /** Format: uuid */
+            property_id: string;
+            property_name: string;
+            /** Format: int64 */
+            visitors: number;
+            /** Format: int64 */
+            visits: number;
+            /** Format: int64 */
+            pageviews: number;
         };
         BroadcastEventData: {
             broadcast: components["schemas"]["Broadcast"];
@@ -11909,11 +12501,19 @@ export interface components {
             body?: string;
             /** @description The first message's `client_id`. */
             client_id?: string;
+            /** @description The page the conversation starts on, an absolute http(s) URL; query and fragment are dropped, and so is a page a chat channel does not allow. */
+            page_url?: string;
+            /** @description The page's title; ignored without a kept `page_url`. */
+            page_title?: string;
         };
         ClientConversationCreateMultipart: {
             subject?: string;
             body?: string;
             client_id?: string;
+            /** @description The page the conversation starts on, an absolute http(s) URL; query and fragment are dropped, and so is a page a chat channel does not allow. */
+            page_url?: string;
+            /** @description The page's title; ignored without a kept `page_url`. */
+            page_title?: string;
             files?: string[];
         };
         ClientConversationCreated: {
@@ -12050,7 +12650,8 @@ export interface components {
         /** @description One server message on `/client/v1/realtime`, told apart by `type`. */
         ClientRealtimeMessage: components["schemas"]["ClientConversationCreatedEvent"] | components["schemas"]["ClientConversationUpdatedEvent"] | components["schemas"]["ClientMessageEvent"] | components["schemas"]["ClientReadEvent"] | components["schemas"]["ClientTypingEvent"] | components["schemas"]["ClientPresenceEvent"] | components["schemas"]["ClientInboxUpdatedEvent"] | components["schemas"]["RealtimeReady"] | components["schemas"]["RealtimeResyncRequired"];
         /**
-         * @description Where a property's events come from. Browsers send from `web` pages; `ios` and `android` apps send without an `Origin`.
+         * @description Where a property's events come from. Browsers send from `web` pages; `ios` and `android`
+         *     apps send without an `Origin`. Server-side events (`sendAnalyticsEvents`) need no platform.
          * @enum {string}
          */
         AnalyticsPlatform: "web" | "ios" | "android";
@@ -12063,7 +12664,10 @@ export interface components {
         AnalyticsCollection: "anonymous" | "consent";
         /**
          * @description Offered only to visitors who consented: `persistent` keeps a random id on the device for at
-         *     most 13 months, `identify` links a verified user's visits to their contact.
+         *     most 13 months, `identify` links a verified user's visits to their contact. `identify`
+         *     needs `persistent` and a linked inbox, whose identity secret signs the tokens; a children's
+         *     property offers neither. Visitors who did not consent are counted exactly as without
+         *     these features.
          * @enum {string}
          */
         AnalyticsConsentFeature: "persistent" | "identify";
@@ -12242,7 +12846,10 @@ export interface components {
             all?: boolean;
         };
         /**
-         * @description `visitors` (distinct visitors per day, added up over the range), `visits`, `pageviews`,
+         * @description `visitors` (distinct visitors per day, added up over the range; a visitor with a persistent
+         *     id counts once over the range's totals and once per `time:week` or `time:month` bucket,
+         *     from their cohort days without filters and from raw rows inside the raw window with
+         *     filters), `visits`, `pageviews`,
          *     `views_per_visit`, `bounce_rate` (percent of visits with one page view and no interaction),
          *     `visit_duration` (seconds per visit), `time_on_page` (seconds the page was visible and
          *     focused, per page view that reported it), `scroll_depth` (deepest scroll in percent, per
@@ -12253,9 +12860,15 @@ export interface components {
          *     completed) and `revenue` (what the completing events carried, per currency, in
          *     `metrics.revenue`). With an `event` or `prop` dimension only `visitors`, `visits`, `events`
          *     and `revenue` are offered, counted over the events of each row. `revenue` cannot order rows.
+         *
+         *     With `dataset: support` (a property linked to an inbox): `conversations` (conversations
+         *     started on the page), `feedback` (page feedback sent from it), `ratings_up` and
+         *     `ratings_down` (page ratings), `helpful_rate` (percent of ratings that are `up`),
+         *     `discussions` (discussion threads started on it) and `support_rate` (conversations per
+         *     1,000 page views), next to `visitors` and `pageviews`.
          * @enum {string}
          */
-        AnalyticsMetric: "visitors" | "visits" | "pageviews" | "views_per_visit" | "bounce_rate" | "visit_duration" | "time_on_page" | "scroll_depth" | "events" | "conversions" | "conversion_rate" | "completions" | "revenue";
+        AnalyticsMetric: "visitors" | "visits" | "pageviews" | "views_per_visit" | "bounce_rate" | "visit_duration" | "time_on_page" | "scroll_depth" | "events" | "conversions" | "conversion_rate" | "completions" | "revenue" | "conversations" | "feedback" | "ratings_up" | "ratings_down" | "helpful_rate" | "discussions" | "support_rate";
         /**
          * @description A value of a visit or page. `page` is a path that was viewed (pages are counted by path;
          *     `hostname` tells sites apart), `entry_page` and `exit_page` the first and last of a visit.
@@ -12263,14 +12876,19 @@ export interface components {
          *     `email`, `referral`, `ai_assistants`, `internal`; `source` the UTM source, or the named site
          *     (Google, ChatGPT) or host a visit came from; `device` is `desktop`, `mobile` or `tablet`;
          *     `screen_size` is `phone`, `tablet`, `laptop` or `desktop`; `country` an ISO 3166-1 alpha-2
-         *     code. Unknown values are empty strings. `event` is the name of a custom or built-in event
+         *     code. `platform` is `web`, `ios`, `android` or `server` (a visit a server event started);
+         *     `app_version` the version an app sent, empty on the web. In an app, a page is a screen:
+         *     its `hostname` is the app id and `page`, `entry_page` and `exit_page` are screen paths, so
+         *     an app property's "Screens" are a `page` breakdown filtered by `platform`. `visitor_type` is
+         *     `new` (the day a consented visitor with a persistent id was first seen) or `returning` (a
+         *     later day) for consented traffic, and empty for every other visit. Unknown values are empty strings. `event` is the name of a custom or built-in event
          *     and `prop` the value of the event prop the filter's `prop` (or the query's `prop`) names, empty
          *     for events without it: as
          *     a filter of visits they keep the visits with such an event; in an `event` or `prop`
          *     breakdown they keep the matching events.
          * @enum {string}
          */
-        AnalyticsFilterDimension: "page" | "entry_page" | "exit_page" | "hostname" | "channel" | "source" | "referrer" | "utm_source" | "utm_medium" | "utm_campaign" | "utm_term" | "utm_content" | "country" | "region" | "city" | "device" | "browser" | "browser_version" | "os" | "os_version" | "screen_size" | "language" | "platform" | "app_version" | "event" | "prop";
+        AnalyticsFilterDimension: "page" | "entry_page" | "exit_page" | "hostname" | "channel" | "source" | "referrer" | "utm_source" | "utm_medium" | "utm_campaign" | "utm_term" | "utm_content" | "country" | "region" | "city" | "device" | "browser" | "browser_version" | "os" | "os_version" | "screen_size" | "language" | "platform" | "app_version" | "visitor_type" | "event" | "prop";
         /**
          * @description A filter dimension (`AnalyticsFilterDimension`), or a time grain: `time:hour` (local hours
          *     of the property's time zone; only alone, and only with `visitors`, `visits`, `pageviews` and
@@ -12281,7 +12899,7 @@ export interface components {
          *     a time grain other than `time:hour` or a visit dimension.
          * @enum {string}
          */
-        AnalyticsDimension: "time:hour" | "time:day" | "time:week" | "time:month" | "page" | "entry_page" | "exit_page" | "hostname" | "channel" | "source" | "referrer" | "utm_source" | "utm_medium" | "utm_campaign" | "utm_term" | "utm_content" | "country" | "region" | "city" | "device" | "browser" | "browser_version" | "os" | "os_version" | "screen_size" | "language" | "platform" | "app_version" | "event" | "prop";
+        AnalyticsDimension: "time:hour" | "time:day" | "time:week" | "time:month" | "page" | "entry_page" | "exit_page" | "hostname" | "channel" | "source" | "referrer" | "utm_source" | "utm_medium" | "utm_campaign" | "utm_term" | "utm_content" | "country" | "region" | "city" | "device" | "browser" | "browser_version" | "os" | "os_version" | "screen_size" | "language" | "platform" | "app_version" | "visitor_type" | "event" | "prop";
         /**
          * @description `is` and `is_not` compare whole values, `contains` and `not_contains` parts of them (case
          *     does not matter), `matches` patterns: on paths `*` is one segment and `**` any number of
@@ -12330,8 +12948,29 @@ export interface components {
              */
             dir: "asc" | "desc";
         };
+        /**
+         * @description `traffic` (default) counts visits, page views and events. `support` counts, per page and
+         *     day, what the property's linked inbox received from its pages: conversations started on a
+         *     page, page feedback, page ratings and discussion threads, next to the page's `pageviews`
+         *     and `visitors`. Pages are joined by host and path only; no visitor is ever joined to a
+         *     contact or conversation. It takes the dimensions `page`, `hostname` and `time:day`,
+         *     `time:week` or `time:month` (a page or host and a grain at most), filters on `page` and
+         *     `hostname`, no goal, prop or segment, and answers `422 no_linked_inbox` for a property
+         *     without an inbox. Rows are the pages (or hosts) with any support in the range, ordered by
+         *     `support_rate` with pages of fewer than 100 page views after the others unless `order_by`
+         *     says otherwise. Days of the past come from the support rollup, today and days not yet rolled
+         *     up from the inbox itself.
+         * @enum {string}
+         */
+        AnalyticsDataset: "traffic" | "support";
         AnalyticsQuery: {
+            dataset?: components["schemas"]["AnalyticsDataset"];
             metrics: components["schemas"]["AnalyticsMetric"][];
+            /**
+             * @description Add `insights` to the answer, worked out from its own numbers by fixed rules.
+             * @default false
+             */
+            insights: boolean;
             /**
              * Format: uuid
              * @description The goal whose `conversions`, `conversion_rate`, `completions` and `revenue` the query
@@ -12390,6 +13029,20 @@ export interface components {
             completions?: number;
             /** @description Per currency, most first. */
             revenue?: components["schemas"]["AnalyticsRevenue"][];
+            /** Format: double */
+            conversations?: number;
+            /** Format: double */
+            feedback?: number;
+            /** Format: double */
+            ratings_up?: number;
+            /** Format: double */
+            ratings_down?: number;
+            /** Format: double */
+            helpful_rate?: number;
+            /** Format: double */
+            discussions?: number;
+            /** Format: double */
+            support_rate?: number;
         };
         AnalyticsRevenue: {
             /** @description ISO 4217 code. */
@@ -12452,6 +13105,47 @@ export interface components {
             meta: components["schemas"]["AnalyticsResultMeta"];
             /** @description Present when there are more rows. */
             next_cursor?: string;
+            /** @description With `insights` in the query; empty when no rule applies. */
+            insights?: components["schemas"]["AnalyticsInsight"][];
+        };
+        /**
+         * @description A fixed rule over the answer's own numbers; Yuva runs no model. Each insight appears once
+         *     per answer, and `current` and `previous` are the plain numbers to phrase and pluralise it.
+         *     The change rules need `compare`; a number below 10 is never compared in percent.
+         *     `metric_change`: a count total that moved by at least 20% from a comparison total of at
+         *     least 10; `change` is the percentage. `metric_new`: a count total of at least 10 whose
+         *     comparison total is 0 ("no visitors in the compared days"); it has no `change`. A
+         *     comparison total from 1 to 9 gives neither. With one dimension other than time:
+         *     `row_change`, a row whose first count metric (by `order_by`, else the first one asked)
+         *     moved by at least 50% from at least 10, the three largest moves; `new_value`, a row with at
+         *     least 10 that had none in the comparison range (a new referrer, page or campaign), the
+         *     three largest, without `change`. `support_hotspot` (`dataset: support` by page): a page
+         *     with at least 3 conversations whose `support_rate` (`current`) is at least twice the
+         *     range's (`previous`), the three highest; `change` is how much higher in percent.
+         */
+        AnalyticsInsight: {
+            /** @enum {string} */
+            kind: "metric_change" | "metric_new" | "row_change" | "new_value" | "support_hotspot";
+            metric: components["schemas"]["AnalyticsMetric"];
+            /** @description The dimension of the row; absent for a total. */
+            dimension?: string;
+            /** @description The row's value of `dimension`. */
+            value?: string;
+            /**
+             * Format: double
+             * @description The range's number.
+             */
+            current: number;
+            /**
+             * Format: double
+             * @description The comparison range's number (0 for `metric_new` and `new_value`), or the range's overall `support_rate` for a hotspot.
+             */
+            previous: number;
+            /**
+             * Format: double
+             * @description The change in percent of `previous`, one decimal; only for `metric_change`, `row_change` and `support_hotspot`.
+             */
+            change?: number;
         };
         AnalyticsRangeProblem: components["schemas"]["Problem"] & {
             /** Format: date */
@@ -12560,6 +13254,88 @@ export interface components {
             /** @description Why no database is loaded, or why the last update failed. */
             error?: string;
         };
+        AnalyticsServerEvents: {
+            events: components["schemas"]["AnalyticsServerEvent"][];
+        };
+        /** @description One server-side event. Give `ip` and `user_agent`, or `visitor_key`. */
+        AnalyticsServerEvent: {
+            /**
+             * @description `pageview`, a built-in event or a custom event's name, as in `AnalyticsEvent.n`.
+             * @example Signup
+             */
+            name: string;
+            /**
+             * @description The page or app screen, read like `AnalyticsEvent.u`.
+             * @example https://example.com/signup
+             */
+            url: string;
+            /** @description The page's referrer, for a `pageview` that starts a visit. */
+            referrer?: string;
+            /**
+             * Format: date-time
+             * @description When it happened; now when absent.
+             */
+            timestamp?: string;
+            /**
+             * @description Up to 30 props with the rules of `AnalyticsEvent.p`.
+             * @example {
+             *       "plan": "pro"
+             *     }
+             */
+            props?: {
+                [key: string]: string | number | boolean;
+            };
+            revenue?: components["schemas"]["AnalyticsEventRevenue"];
+            /** @description `false` makes a custom event non-interactive. */
+            interactive?: boolean;
+            /**
+             * @description The visitor's IP address as your server saw it. Shortened on arrival, never stored.
+             * @example 203.0.113.7
+             */
+            ip?: string;
+            /** @description The visitor's `User-Agent` header. Never stored. */
+            user_agent?: string;
+            /**
+             * @description The visitor's `Sec-CH-UA-Platform` header, as sent.
+             * @example "macOS"
+             */
+            sec_ch_ua_platform?: string;
+            /**
+             * @description The visitor's `Sec-CH-UA-Mobile` header, as sent.
+             * @example ?0
+             */
+            sec_ch_ua_mobile?: string;
+            /** @description The visitor's `Accept-Language` header; only the primary language of its first entry is kept. */
+            accept_language?: string;
+            /** @description Your own key for the visitor instead of `ip` and `user_agent`; hashed under the day's salt, never stored. */
+            visitor_key?: string;
+            /** @description The visitor's request had `DNT: 1`; the event is not stored. */
+            dnt?: boolean;
+            /** @description The visitor's request had `Sec-GPC: 1`; the event is not stored. */
+            gpc?: boolean;
+            /** @description The visitor agreed to analytics; required for a `consent` property to store the event. */
+            consent?: boolean;
+            /**
+             * @description The persistent id the visitor's browser or app holds (`AnalyticsConsent.p`), forwarded
+             *     for a visitor who agreed to `persistent`; taken only with `consent: true` on a property
+             *     that offers `persistent`, and then names the visitor in place of `ip` and `user_agent`
+             *     or `visitor_key`. Those are still required: they describe the visit, and name the
+             *     visitor whenever the id is not taken.
+             */
+            persistent_id?: string;
+            /** @description An identity token as in `AnalyticsConsent.j`, with `persistent_id` and `consent: true`, on a property that offers `identify`. */
+            identity_token?: string;
+        };
+        AnalyticsEventsResult: {
+            /** @description The valid events, stored unless a rule of the operation dropped them. */
+            accepted: number;
+            /** @description The events left out as invalid, by their position in `events`. */
+            errors: components["schemas"]["AnalyticsEventError"][];
+        };
+        AnalyticsEventError: {
+            index: number;
+            detail: string;
+        };
         AnalyticsHealth: {
             /** Format: date-time */
             first_event_at?: string;
@@ -12661,6 +13437,12 @@ export interface components {
             visitors: number;
             /** Format: int64 */
             visits: number;
+            /**
+             * Format: int64
+             * @description Visitors with a persistent id who reached this step after all before it anywhere in
+             *     the range, across visits and days, each counted once; 0 on a property without them.
+             */
+            consented_visitors: number;
             /**
              * Format: int64
              * @description Visitors of the step before who did not reach this one; 0 for the first step.
@@ -12677,6 +13459,76 @@ export interface components {
              */
             step_rate: number;
         };
+        AnalyticsRetention: {
+            /** @enum {string} */
+            grain: "day" | "week" | "month";
+            /**
+             * Format: date
+             * @description The first cohort's start.
+             */
+            from: string;
+            /** Format: date */
+            to: string;
+            /**
+             * Format: date-time
+             * @description When the cohorts job last rebuilt the numbers; absent before it ran.
+             */
+            built_at?: string;
+            /** @description Cohorts with at least one visitor. */
+            cohorts: components["schemas"]["AnalyticsCohort"][];
+        };
+        AnalyticsCohort: {
+            /**
+             * Format: date
+             * @description The start of the day, week or month the cohort's visitors were first seen.
+             */
+            cohort: string;
+            /**
+             * Format: int64
+             * @description The cohort's size, `periods[0]`.
+             */
+            visitors: number;
+            /** @description Visitors of the cohort seen in each period from the cohort's own, up to the period that holds today. */
+            periods: number[];
+        };
+        AnalyticsContactVisitList: {
+            items: components["schemas"]["AnalyticsContactVisit"][];
+            /** @description Present when there are older visits. */
+            next_cursor?: string;
+        };
+        /** @description One visit, described as its first event saw it, as the dimensions of `AnalyticsFilterDimension` name its values. */
+        AnalyticsContactVisit: {
+            /** Format: uuid */
+            property_id: string;
+            property_name: string;
+            /** Format: date-time */
+            started_at: string;
+            /** Format: date-time */
+            ended_at: string;
+            hostname: string;
+            entry_page: string;
+            exit_page: string;
+            pageviews: number;
+            events: number;
+            channel: string;
+            source: string;
+            utm_campaign: string;
+            country: string;
+            city: string;
+            device: string;
+            browser: string;
+            os: string;
+            platform: string;
+            app_version: string;
+            /** @description `new` or `returning`. */
+            visitor_type: string;
+            /** @description The paths (or app screens) the visit viewed, most viewed first, at most 20. */
+            pages: components["schemas"]["AnalyticsVisitPage"][];
+        };
+        AnalyticsVisitPage: {
+            path: string;
+            views: number;
+        };
         AnalyticsFunnelReport: {
             /** Format: uuid */
             funnel_id: string;
@@ -12718,11 +13570,12 @@ export interface components {
             /** Format: uuid */
             id: string;
             /**
-             * @description `note` is a member's; Yuva adds `key_rotated` when the property got a new key and
-             *     `goal_created` (with `goal_id` while the goal exists, and its name as `text`).
+             * @description `note` is a member's; Yuva adds `key_rotated` when the property got a new key,
+             *     `goal_created` (with `goal_id` while the goal exists, and its name as `text`) and
+             *     `alert` (with `alert_id`, what the alert found as `text`).
              * @enum {string}
              */
-            kind: "note" | "key_rotated" | "goal_created";
+            kind: "note" | "key_rotated" | "goal_created" | "alert";
             /** Format: date */
             starts_on: string;
             /** Format: date */
@@ -12730,6 +13583,8 @@ export interface components {
             text: string;
             /** Format: uuid */
             goal_id?: string;
+            /** Format: uuid */
+            alert_id?: string;
             /**
              * Format: uuid
              * @description The member who wrote it; absent for Yuva's own, API keys and removed members.
@@ -12760,62 +13615,439 @@ export interface components {
         AnalyticsAnnotationList: {
             items: components["schemas"]["AnalyticsAnnotation"][];
         };
-        AnalyticsConsent: {
-            /**
-             * @description `1` when the visitor agreed to analytics.
-             * @enum {integer}
-             */
-            a?: 0 | 1;
-        };
         /**
-         * @description One event. Keys the server does not know are ignored, so newer scripts keep working with
-         *     older servers.
+         * @description Fixed rules, checked every hour over the property's finished hours and days:
+         *     `spike` and `drop`, page views of the last two finished hours at least three times, or at
+         *     most half, the same two hours' average over the seven days before (at least 20 views
+         *     a day in those hours); `goal_drop`, a goal's conversions yesterday at most half its
+         *     average of the seven days before (at least 10 a day); `support_load`, yesterday's
+         *     conversations per 1,000 page views at least twice the rate of the 28 days before, with at
+         *     least 5 conversations (a property linked to an inbox); `new_referrer`, a referring site with
+         *     at least 10 visits yesterday and none in the 28 days before. Each kind fires once per
+         *     property and day (`new_referrer` once per site).
+         * @enum {string}
          */
-        AnalyticsEvent: {
+        AnalyticsAlertKind: "spike" | "drop" | "goal_drop" | "support_load" | "new_referrer";
+        /** @enum {string} */
+        AnalyticsReportFrequency: "none" | "weekly" | "monthly";
+        AnalyticsSubscription: {
+            /** Format: uuid */
+            property_id: string;
+            report: components["schemas"]["AnalyticsReportFrequency"];
+            alerts: components["schemas"]["AnalyticsAlertKind"][];
             /**
-             * @description `pageview`; `engagement` (sent once per view when the page is hidden or left); a built-in
-             *     event: `outbound_click` (a link to another host, with prop `url`), `file_download` (a
-             *     link to a file, with prop `url`), `not_found` (the page is the site's 404 page) or
-             *     `chat_open` (the page's chat was opened); or a custom event's name, 1 to 120
-             *     characters. `screen` and names starting with `$` or `yuva_` are reserved.
-             * @example pageview
-             * @example Signup
-             * @example outbound_click
+             * Format: date-time
+             * @description When the last scheduled report went out.
              */
-            n: string;
+            last_report_at?: string;
             /**
-             * @description The page URL. Only the host and the path are kept; of the query, only `utm_source`,
-             *     `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`, `ref` and `source` are read, into
-             *     the visit's acquisition. Path segments shaped like e-mail addresses are stored as
-             *     `:email`.
+             * Format: date-time
+             * @description Absent until the member chose.
              */
-            u: string;
-            /** @description `document.referrer`; only its host and path are kept, and none when it is the page's own host. */
-            r?: string;
-            /** @description Viewport width in CSS pixels, turned into a screen size class and not stored. */
-            w?: number;
-            /** @description The page uses hash routing, so the fragment is part of the path. */
-            h?: boolean;
-            /** @description `engagement` only: milliseconds the page was visible and focused, at most 30 minutes. */
-            ms?: number;
-            /** @description `engagement` only: the deepest scroll position reached, in percent. */
-            sd?: number;
+            updated_at?: string;
+        };
+        AnalyticsSubscriptionUpdate: {
+            report?: components["schemas"]["AnalyticsReportFrequency"];
+            alerts?: components["schemas"]["AnalyticsAlertKind"][];
+        };
+        AnalyticsAlert: {
+            /** Format: uuid */
+            id: string;
+            /** Format: uuid */
+            property_id: string;
+            kind: components["schemas"]["AnalyticsAlertKind"];
             /**
-             * @description Custom and built-in events only: up to 30 props. Keys have 1 to 300 characters and must
-             *     not start with `$` or `yuva_`; values are strings, numbers or booleans, kept as text of
-             *     at most 2,000 characters. A value shaped like an e-mail address is dropped (and counted
-             *     as scrubbed); a children's property keeps no props but a built-in event's `url`. The
-             *     `url` of `outbound_click` and `file_download` is kept without its query and fragment.
-             * @example {
-             *       "plan": "pro",
-             *       "seats": 3
-             *     }
+             * Format: date
+             * @description The property's day the alert is about.
              */
-            p?: {
-                [key: string]: string | number | boolean;
-            };
-            $?: components["schemas"]["AnalyticsEventRevenue"];
-            /** @description `false` makes a custom event non-interactive, so a visit with only that event still bounces. */
+            day: string;
+            /**
+             * Format: date-time
+             * @description `spike` and `drop`: the start of the two hours.
+             */
+            hours_from?: string;
+            /** Format: date-time */
+            hours_to?: string;
+            /** @description `pageviews`, `conversions`, `support_rate` or `visits`. */
+            metric: string;
+            /** Format: double */
+            current: number;
+            /**
+             * Format: double
+             * @description What the rule compared `current` with; 0 for a new referrer.
+             */
+            baseline: number;
+            /** Format: uuid */
+            goal_id?: string;
+            goal_name?: string;
+            /** @description `new_referrer`: the site's host. */
+            referrer?: string;
+            /** @description What was found, in English, as on the annotation. */
+            text: string;
+            /** Format: uuid */
+            annotation_id?: string;
+            /** Format: date-time */
+            created_at: string;
+        };
+        AnalyticsAlertList: {
+            items: components["schemas"]["AnalyticsAlert"][];
+        };
+        AnalyticsAlertEventData: {
+            alert: components["schemas"]["AnalyticsAlert"];
+            property: components["schemas"]["AnalyticsPropertyRef"];
+        };
+        AnalyticsPropertyRef: {
+            /** Format: uuid */
+            id: string;
+            name: string;
+        };
+        /**
+         * @description `analytics.alert`: a property raised an alert. Delivered to callers who hold
+         *     `analytics:read` and can see the property; `inbox_id` is the property's linked inbox.
+         */
+        AnalyticsAlertEvent: {
+            /** Format: int64 */
+            id: number;
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "analytics.alert";
+            /** Format: uuid */
+            workspace_id: string;
+            /** Format: uuid */
+            inbox_id?: string;
+            /** Format: date-time */
+            created_at: string;
+            data: components["schemas"]["AnalyticsAlertEventData"];
+        };
+        WebhookAnalyticsAlertPayload: components["schemas"]["WebhookPayloadBase"] & {
+            data: components["schemas"]["AnalyticsAlertEventData"];
+        };
+        /**
+         * @description A part of the property's report a share link shows: `overview` (totals and the chart),
+         *     `realtime`, `pages`, `sources`, `locations`, `devices`, `events`, `goals`.
+         * @enum {string}
+         */
+        AnalyticsShareView: "overview" | "realtime" | "pages" | "sources" | "locations" | "devices" | "events" | "goals";
+        /**
+         * @description A site whose pages may frame the link: `https://` (or `http://`) and a host with an
+         *     optional port, nothing after it; `https://*.example.com` allows every subdomain.
+         */
+        AnalyticsEmbedOrigin: string;
+        AnalyticsShare: {
+            /** Format: uuid */
+            id: string;
+            /** Format: uuid */
+            property_id: string;
+            /** @description What the link is for, shown to members only. */
+            name: string;
+            views: components["schemas"]["AnalyticsShareView"][];
+            has_password: boolean;
+            embed_origins: components["schemas"]["AnalyticsEmbedOrigin"][];
+            /** @description The first characters of the token, to tell links apart. */
+            token_prefix: string;
+            /** Format: date-time */
+            expires_at?: string;
+            /** Format: date-time */
+            revoked_at?: string;
+            /** @description Neither revoked nor expired. */
+            active: boolean;
+            /**
+             * Format: date-time
+             * @description The last time the link's page settings were read, to the minute.
+             */
+            last_viewed_at?: string;
+            /**
+             * Format: uuid
+             * @description The member who made it; absent for API keys and removed members.
+             */
+            created_by?: string;
+            /** Format: date-time */
+            created_at: string;
+            /** Format: date-time */
+            updated_at: string;
+        };
+        AnalyticsShareCreated: {
+            share: components["schemas"]["AnalyticsShare"];
+            /** @description The link's token, `yuva_sh_…`; shown only in this answer. */
+            token: string;
+            /**
+             * Format: uri
+             * @description The share page, `<public URL>/share/<token>`.
+             */
+            url: string;
+        };
+        AnalyticsShareCreate: {
+            name: string;
+            views: components["schemas"]["AnalyticsShareView"][];
+            password?: string;
+            embed_origins?: components["schemas"]["AnalyticsEmbedOrigin"][];
+            /**
+             * Format: date-time
+             * @description When the link stops working; in the future.
+             */
+            expires_at?: string;
+        };
+        AnalyticsShareUpdate: {
+            name?: string;
+            views?: components["schemas"]["AnalyticsShareView"][];
+            /** @description A new password; `null` removes it. */
+            password?: string | null;
+            embed_origins?: components["schemas"]["AnalyticsEmbedOrigin"][];
+            /**
+             * Format: date-time
+             * @description `null` keeps the link until it is revoked.
+             */
+            expires_at?: string | null;
+        };
+        AnalyticsShareList: {
+            items: components["schemas"]["AnalyticsShare"][];
+        };
+        AnalyticsShareUnlock: {
+            password: string;
+        };
+        AnalyticsShareAccess: {
+            /** @description `yuva_sa_…`, sent as `Authorization: Bearer` to the link's other endpoints. */
+            access_token: string;
+            /** Format: date-time */
+            expires_at: string;
+        };
+        AnalyticsSharedProperty: {
+            name: string;
+            timezone: string;
+            currency: string;
+            platforms: components["schemas"]["AnalyticsPlatform"][];
+        };
+        /**
+         * @description With `password_required` and no valid access token only that field is present; otherwise
+         *     everything the page shows.
+         */
+        AnalyticsSharedPage: {
+            password_required: boolean;
+            /** @description The link's name. */
+            name?: string;
+            views?: components["schemas"]["AnalyticsShareView"][];
+            property?: components["schemas"]["AnalyticsSharedProperty"];
+            /** Format: date-time */
+            expires_at?: string;
+            /**
+             * Format: date
+             * @description The first day queries that need raw rows can serve.
+             */
+            raw_window_from?: string;
+            /** @description With the `goals` view, the property's goals. */
+            goals?: components["schemas"]["AnalyticsGoal"][];
+            geoip?: components["schemas"]["AnalyticsGeoIP"];
+        };
+        /** @enum {string} */
+        AnalyticsExportKind: "view" | "daily" | "raw";
+        /** @enum {string} */
+        AnalyticsExportFormat: "csv" | "ndjson";
+        /**
+         * @description `view` takes `query` (its own range; `compare`, `limit` and `cursor` are ignored); `daily`
+         *     and `raw` take `range`, `daily` also an optional `dimension` other than `event` and `prop`.
+         *     `format` is `csv` by default, and must be `ndjson` for `raw`.
+         */
+        AnalyticsExportCreate: {
+            kind: components["schemas"]["AnalyticsExportKind"];
+            format?: components["schemas"]["AnalyticsExportFormat"];
+            query?: components["schemas"]["AnalyticsQuery"];
+            range?: components["schemas"]["AnalyticsRange"];
+            dimension?: components["schemas"]["AnalyticsFilterDimension"];
+        };
+        AnalyticsExport: {
+            /** Format: uuid */
+            id: string;
+            /** Format: uuid */
+            property_id: string;
+            kind: components["schemas"]["AnalyticsExportKind"];
+            format: components["schemas"]["AnalyticsExportFormat"];
+            /** @enum {string} */
+            status: "queued" | "running" | "done" | "failed";
+            /** Format: date */
+            from: string;
+            /** Format: date */
+            to: string;
+            /** @description Percent of the work done. */
+            progress: number;
+            /**
+             * Format: int64
+             * @description Rows written so far.
+             */
+            rows: number;
+            /** Format: int64 */
+            size_bytes: number;
+            /**
+             * @description Why a `failed` export failed: `too_large`, `needs_raw_window`, `invalid_query` (with the
+             *     reason after a colon) or `internal`.
+             */
+            error?: string;
+            /** @description The file's name, when it is `done`. */
+            file_name?: string;
+            /**
+             * Format: uuid
+             * @description The member who asked for it; absent for API keys and removed members.
+             */
+            created_by?: string;
+            /** Format: date-time */
+            created_at: string;
+            /** Format: date-time */
+            finished_at?: string;
+            /**
+             * Format: date-time
+             * @description When the export and its file are deleted, seven days after it was made or finished.
+             */
+            expires_at: string;
+        };
+        AnalyticsExportList: {
+            items: components["schemas"]["AnalyticsExport"][];
+        };
+        /**
+         * @description One line of a `raw` export. `visit` counts up from 1 within the file and joins a visit's
+         *     events; it is not the stored visit and says nothing about the visitor. `type` is
+         *     `pageview`, `screen`, `event` or `engagement`. Places, devices and sources describe the
+         *     visit as its first event did.
+         */
+        AnalyticsRawEvent: {
+            /** Format: date */
+            day: string;
+            /** Format: date-time */
+            time: string;
+            /** Format: int64 */
+            visit: number;
+            /** @enum {string} */
+            type: "pageview" | "screen" | "event" | "engagement";
+            name?: string;
+            hostname: string;
+            path: string;
+            props?: {
+                [key: string]: unknown;
+            };
+            /**
+             * Format: int64
+             * @description Revenue the event carried, in the currency's minor units.
+             */
+            revenue_minor?: number;
+            currency?: string;
+            engaged_ms?: number;
+            scroll?: number;
+            channel: string;
+            source?: string;
+            referrer?: string;
+            utm_source?: string;
+            utm_medium?: string;
+            utm_campaign?: string;
+            utm_term?: string;
+            utm_content?: string;
+            country?: string;
+            region?: string;
+            city?: string;
+            device?: string;
+            browser?: string;
+            browser_version?: string;
+            os?: string;
+            os_version?: string;
+            screen_size?: string;
+            language?: string;
+            platform: string;
+            app_version?: string;
+        };
+        /**
+         * @description What the visitor agreed to in the site's or app's own consent tool. `p` and `j` count only
+         *     with `a: 1`, on a property whose `consent_features` offer them; otherwise they are ignored
+         *     and the event is counted as in default mode.
+         */
+        AnalyticsConsent: {
+            /**
+             * @description `1` when the visitor agreed to analytics.
+             * @enum {integer}
+             */
+            a?: 0 | 1;
+            /**
+             * @description The persistent id, for a visitor who also agreed to `persistent`: a random value of at
+             *     least 128 bits (a UUID or base64url) that the script or SDK keeps on the device for at
+             *     most 13 months from when it made it, and sends on every event, engagements included.
+             *     The server keeps only a keyed hash of it under the property's own secret, so the same
+             *     id means nothing on another property. With it the visitor counts once over several
+             *     days, is told apart as new or returning, enters retention cohorts and crosses days in
+             *     funnels. A value of the wrong shape is ignored.
+             * @example 0f8fad5b-d9cb-469f-a165-70867728950e
+             */
+            p?: string;
+            /**
+             * @description An identity token of the property's linked inbox, signed by the host's backend as for
+             *     `/client/v1/session` (HS256, `sub`, `exp` at most 10 minutes ahead, a `jti` used once),
+             *     sent once after the user signs in, together with `p`, on a property that offers
+             *     `identify`. It links the persistent id, and its visits, to the contact; the contact is
+             *     found or made exactly as `/client/v1/session` does. A forged, expired or reused token is
+             *     ignored and the event is still counted.
+             */
+            j?: string;
+        };
+        /**
+         * @description One event. Keys the server does not know are ignored, so newer scripts keep working with
+         *     older servers.
+         */
+        AnalyticsEvent: {
+            /**
+             * @description `pageview`; `engagement` (sent once per view when the page is hidden or left); a built-in
+             *     event: `outbound_click` (a link to another host, with prop `url`), `file_download` (a
+             *     link to a file, with prop `url`), `not_found` (the page is the site's 404 page) or
+             *     `chat_open` (the page's chat was opened); or a custom event's name, 1 to 120
+             *     characters. `screen` and names starting with `$` or `yuva_` are reserved.
+             *
+             *     `yuva_consent` is not an event and is never stored or counted: it carries a change of
+             *     consent at once. With `c.a: 1`, `c.p` and `c.j` it identifies the visitor (see
+             *     `AnalyticsConsent`); with `c.a: 0` and `c.p` it withdraws: the persistent id's link to
+             *     a contact and its cohort days are deleted, so its visits leave the contact's page and
+             *     retention. A withdrawal is taken even with `Sec-GPC` or `DNT`.
+             * @example pageview
+             * @example Signup
+             * @example outbound_click
+             */
+            n: string;
+            /**
+             * @description The page URL. Only the host and the path are kept; of the query, only `utm_source`,
+             *     `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`, `ref` and `source` are read, into
+             *     the visit's acquisition. Path segments shaped like e-mail addresses are stored as
+             *     `:email`. In an app, the screen: `app://<app id>/<screen>`, the screen's path
+             *     percent-encoded (`app://com.example.shop/Product%20Detail`), read the same way.
+             */
+            u: string;
+            /**
+             * Format: int64
+             * @description Apps only: when the event happened, in milliseconds since the Unix epoch. Taken as now
+             *     when absent or in the future; an event older than 72 hours is dropped as `late`.
+             * @example 1760263200000
+             */
+            t?: number;
+            /** @description `document.referrer`; only its host and path are kept, and none when it is the page's own host. */
+            r?: string;
+            /** @description Viewport width in CSS pixels, turned into a screen size class and not stored. */
+            w?: number;
+            /** @description The page uses hash routing, so the fragment is part of the path. */
+            h?: boolean;
+            /** @description `engagement` only: milliseconds the page was visible and focused, at most 30 minutes. */
+            ms?: number;
+            /** @description `engagement` only: the deepest scroll position reached, in percent. */
+            sd?: number;
+            /**
+             * @description Custom and built-in events only: up to 30 props. Keys have 1 to 300 characters and must
+             *     not start with `$` or `yuva_`; values are strings, numbers or booleans, kept as text of
+             *     at most 2,000 characters. A value shaped like an e-mail address is dropped (and counted
+             *     as scrubbed); a children's property keeps no props but a built-in event's `url`. The
+             *     `url` of `outbound_click` and `file_download` is kept without its query and fragment.
+             * @example {
+             *       "plan": "pro",
+             *       "seats": 3
+             *     }
+             */
+            p?: {
+                [key: string]: string | number | boolean;
+            };
+            $?: components["schemas"]["AnalyticsEventRevenue"];
+            /** @description `false` makes a custom event non-interactive, so a visit with only that event still bounces. */
             i?: boolean;
             c?: components["schemas"]["AnalyticsConsent"];
         };
@@ -12833,9 +14065,52 @@ export interface components {
             /** @example EUR */
             c: string;
         };
+        /** @description Up to 100 events. Apps also send `k` and `a`, and one request per process key. */
         AnalyticsEventBatch: {
+            /**
+             * @description Apps only, required there: the process key, a random value (at least 128 bits, such as
+             *     a UUID) the app makes at launch and keeps in memory only, never on disk. It stands for
+             *     the visitor in place of the address: a relaunch makes a new key, so a new visitor and
+             *     visit. Queued events keep the key of the process that recorded them.
+             * @example 0f8fad5b-d9cb-469f-a165-70867728950e
+             */
+            k?: string;
+            a?: components["schemas"]["AnalyticsApp"];
             e: components["schemas"]["AnalyticsEvent"][];
         };
+        /**
+         * @description Apps only, required there: the app that sent the events, describing a visit it starts.
+         *     Nothing here identifies a device.
+         */
+        AnalyticsApp: {
+            /** @enum {string} */
+            platform: "ios" | "android";
+            /**
+             * @description The app's version as users see it (`CFBundleShortVersionString`, `versionName`), the `app_version` dimension.
+             * @example 2.3.1
+             */
+            version?: string;
+            /**
+             * @description The OS version; its major number is kept (`os_version` dimension `iOS 18`).
+             * @example 18.1
+             */
+            os_version?: string;
+            /**
+             * @description `tablet` for iPads and Android tablets, `desktop` for Mac and ChromeOS.
+             * @enum {string}
+             */
+            device?: "mobile" | "tablet" | "desktop";
+            /**
+             * @description Screen width in points or dp, turned into a screen size class and not stored.
+             * @example 390
+             */
+            width?: number;
+            /**
+             * @description The app's language as a BCP 47 tag; only its primary language is kept. `Accept-Language` when absent.
+             * @example tr-TR
+             */
+            language?: string;
+        };
         /** @description One event, or up to 100 in `e`. */
         AnalyticsBatch: components["schemas"]["AnalyticsEvent"] | components["schemas"]["AnalyticsEventBatch"];
         IngressResult: {
@@ -13667,6 +14942,10 @@ export interface components {
         AnalyticsGoalId: string;
         AnalyticsFunnelId: string;
         AnalyticsSegmentId: string;
+        AnalyticsShareId: string;
+        AnalyticsExportId: string;
+        /** @description The share link's token, `yuva_sh_…`. */
+        AnalyticsShareToken: string;
         AnalyticsAnnotationId: string;
         ListId: string;
         MigrationId: string;
@@ -15962,9 +17241,13 @@ export interface operations {
             404: components["responses"]["Problem"];
         };
     };
-    listContactSubscriptions: {
+    listContactVisits: {
         parameters: {
-            query?: never;
+            query?: {
+                limit?: number;
+                /** @description `next_cursor` of the previous page. */
+                cursor?: string;
+            };
             header?: {
                 /** @description The workspace to act on; see "Workspace selection". */
                 "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
@@ -15976,26 +17259,55 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description The subscriptions, newest first. */
+            /** @description The visits, newest first. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ContactSubscriptionList"];
+                    "application/json": components["schemas"]["AnalyticsContactVisitList"];
                 };
             };
+            400: components["responses"]["Problem"];
             401: components["responses"]["Problem"];
             403: components["responses"]["Problem"];
             404: components["responses"]["Problem"];
         };
     };
-    exportContactConsent: {
+    listContactSubscriptions: {
         parameters: {
-            query?: {
-                /** @description `csv` (the default) or `json`. */
-                format?: components["parameters"]["ConsentFormat"];
-            };
+            query?: never;
+            header?: {
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
+            path: {
+                contactId: components["parameters"]["ContactId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The subscriptions, newest first. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ContactSubscriptionList"];
+                };
+            };
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+        };
+    };
+    exportContactConsent: {
+        parameters: {
+            query?: {
+                /** @description `csv` (the default) or `json`. */
+                format?: components["parameters"]["ConsentFormat"];
+            };
             header?: {
                 /** @description The workspace to act on; see "Workspace selection". */
                 "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
@@ -20909,6 +22221,110 @@ export interface operations {
             429: components["responses"]["Problem"];
         };
     };
+    sendAnalyticsEvents: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                propertyId: components["parameters"]["AnalyticsPropertyId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AnalyticsServerEvents"];
+            };
+        };
+        responses: {
+            /** @description Taken; stored unless one of the rules above dropped them. */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AnalyticsEventsResult"];
+                };
+            };
+            400: components["responses"]["Problem"];
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+            503: components["responses"]["Problem"];
+        };
+    };
+    getAnalyticsRetention: {
+        parameters: {
+            query?: {
+                /** @description `week` when absent. */
+                grain?: "day" | "week" | "month";
+                /** @description The first cohort's day; 30 days, 12 weeks or 12 months before today when absent. */
+                from?: string;
+                /** @description The last cohort's day; today when absent. */
+                to?: string;
+            };
+            header?: {
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
+            path: {
+                propertyId: components["parameters"]["AnalyticsPropertyId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The cohorts, oldest first. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AnalyticsRetention"];
+                };
+            };
+            400: components["responses"]["Problem"];
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+            /** @description `range_too_large`: `from` and `to` are more than 400 days apart. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+        };
+    };
+    deleteAnalyticsVisitor: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
+            path: {
+                propertyId: components["parameters"]["AnalyticsPropertyId"];
+                persistentId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Nothing is stored under the id any more. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            400: components["responses"]["Problem"];
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+        };
+    };
     getAnalyticsHealth: {
         parameters: {
             query?: {
@@ -21493,84 +22909,88 @@ export interface operations {
             404: components["responses"]["Problem"];
         };
     };
-    realtime: {
+    getAnalyticsSubscription: {
         parameters: {
-            query?: {
-                /** @description The workspace to act on, for clients that cannot send `Yuva-Workspace`. */
-                workspace_id?: string;
-                /** @description Replay the events after this one before streaming live ones. */
-                last_event_id?: number;
-            };
+            query?: never;
             header?: {
                 /** @description The workspace to act on; see "Workspace selection". */
                 "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
             };
-            path?: never;
+            path: {
+                propertyId: components["parameters"]["AnalyticsPropertyId"];
+            };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /**
-             * @description Switching to the WebSocket protocol. Each text frame is one `RealtimeMessage`; the
-             *     content below describes a frame, not an HTTP body.
-             */
-            101: {
+            /** @description The subscription. */
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["RealtimeMessage"];
+                    "application/json": components["schemas"]["AnalyticsSubscription"];
                 };
             };
             400: components["responses"]["Problem"];
             401: components["responses"]["Problem"];
             403: components["responses"]["Problem"];
-            503: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
         };
     };
-    getClientSession: {
+    updateAnalyticsSubscription: {
         parameters: {
             query?: never;
-            header?: never;
-            path?: never;
+            header?: {
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
+            path: {
+                propertyId: components["parameters"]["AnalyticsPropertyId"];
+            };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AnalyticsSubscriptionUpdate"];
+            };
+        };
         responses: {
-            /** @description The session. */
+            /** @description The subscription. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ClientSessionInfo"];
+                    "application/json": components["schemas"]["AnalyticsSubscription"];
                 };
             };
+            400: components["responses"]["Problem"];
             401: components["responses"]["Problem"];
             403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
         };
     };
-    createClientSession: {
+    sendAnalyticsReport: {
         parameters: {
             query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["ClientSessionCreate"];
+            header?: {
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
+            path: {
+                propertyId: components["parameters"]["AnalyticsPropertyId"];
             };
+            cookie?: never;
         };
+        requestBody?: never;
         responses: {
-            /** @description The session, the contact and the inbox's public settings. */
-            201: {
+            /** @description The report is on its way. */
+            202: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    "application/json": components["schemas"]["ClientSession"];
-                };
+                content?: never;
             };
             400: components["responses"]["Problem"];
             401: components["responses"]["Problem"];
@@ -21579,96 +22999,533 @@ export interface operations {
             429: components["responses"]["Problem"];
         };
     };
-    deleteClientSession: {
+    listAnalyticsAlerts: {
         parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
+            query?: {
+                /** @description `created_at` of the last alert of the previous page. */
+                before?: string;
+            };
+            header?: {
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
+            path: {
+                propertyId: components["parameters"]["AnalyticsPropertyId"];
+            };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Ended. */
-            204: {
+            /** @description The alerts. */
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["AnalyticsAlertList"];
+                };
             };
+            400: components["responses"]["Problem"];
             401: components["responses"]["Problem"];
             403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
         };
     };
-    getClientChannel: {
+    listAnalyticsShares: {
         parameters: {
             query?: never;
-            header?: never;
+            header?: {
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
             path: {
-                /** @description The chat or app channel's public key. */
-                channel_key: string;
+                propertyId: components["parameters"]["AnalyticsPropertyId"];
             };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description The inbox's public settings. */
+            /** @description The share links. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ClientInbox"];
+                    "application/json": components["schemas"]["AnalyticsShareList"];
                 };
             };
+            401: components["responses"]["Problem"];
             403: components["responses"]["Problem"];
             404: components["responses"]["Problem"];
-            429: components["responses"]["Problem"];
         };
     };
-    createPageRating: {
+    createAnalyticsShare: {
         parameters: {
             query?: never;
-            header?: never;
+            header?: {
+                /** @description Makes a retried request return the first response; see "Idempotency". */
+                "Idempotency-Key"?: components["parameters"]["IdempotencyKey"];
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
             path: {
-                /** @description The chat channel's public key. */
-                channel_key: components["parameters"]["ChannelKey"];
+                propertyId: components["parameters"]["AnalyticsPropertyId"];
             };
             cookie?: never;
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["PageRatingCreate"];
+                "application/json": components["schemas"]["AnalyticsShareCreate"];
             };
         };
         responses: {
-            /** @description Counted. */
-            204: {
+            /** @description The link with its token, shown only now. */
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["AnalyticsShareCreated"];
+                };
             };
             400: components["responses"]["Problem"];
+            401: components["responses"]["Problem"];
             403: components["responses"]["Problem"];
             404: components["responses"]["Problem"];
-            429: components["responses"]["Problem"];
         };
     };
-    listClientDiscussions: {
+    deleteAnalyticsShare: {
         parameters: {
-            query: {
-                /** @description The page's URL. */
-                page: string;
-                sort?: components["schemas"]["DiscussionSort"];
-                /** @description The `next_cursor` of the previous page. */
-                cursor?: components["parameters"]["Cursor"];
-                /** @description Page size, 1 to 100; 25 by default. */
-                limit?: components["parameters"]["Limit"];
+            query?: never;
+            header?: {
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
             };
-            header?: never;
             path: {
-                /** @description The chat channel's public key. */
-                channel_key: components["parameters"]["ChannelKey"];
+                propertyId: components["parameters"]["AnalyticsPropertyId"];
+                shareId: components["parameters"]["AnalyticsShareId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Deleted. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+        };
+    };
+    updateAnalyticsShare: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
+            path: {
+                propertyId: components["parameters"]["AnalyticsPropertyId"];
+                shareId: components["parameters"]["AnalyticsShareId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AnalyticsShareUpdate"];
+            };
+        };
+        responses: {
+            /** @description The updated link. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AnalyticsShare"];
+                };
+            };
+            400: components["responses"]["Problem"];
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+            409: components["responses"]["Problem"];
+        };
+    };
+    revokeAnalyticsShare: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
+            path: {
+                propertyId: components["parameters"]["AnalyticsPropertyId"];
+                shareId: components["parameters"]["AnalyticsShareId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The revoked link. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AnalyticsShare"];
+                };
+            };
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+        };
+    };
+    listAnalyticsExports: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
+            path: {
+                propertyId: components["parameters"]["AnalyticsPropertyId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The exports. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AnalyticsExportList"];
+                };
+            };
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+        };
+    };
+    createAnalyticsExport: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Makes a retried request return the first response; see "Idempotency". */
+                "Idempotency-Key"?: components["parameters"]["IdempotencyKey"];
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
+            path: {
+                propertyId: components["parameters"]["AnalyticsPropertyId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AnalyticsExportCreate"];
+            };
+        };
+        responses: {
+            /** @description The export, queued. */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AnalyticsExport"];
+                };
+            };
+            400: components["responses"]["Problem"];
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+            /** @description `needs_raw_window` or `range_too_large`: the range cannot be exported. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["AnalyticsRangeProblem"];
+                };
+            };
+            429: components["responses"]["Problem"];
+        };
+    };
+    getAnalyticsExport: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
+            path: {
+                propertyId: components["parameters"]["AnalyticsPropertyId"];
+                exportId: components["parameters"]["AnalyticsExportId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The export. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AnalyticsExport"];
+                };
+            };
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+        };
+    };
+    deleteAnalyticsExport: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
+            path: {
+                propertyId: components["parameters"]["AnalyticsPropertyId"];
+                exportId: components["parameters"]["AnalyticsExportId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Deleted. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+        };
+    };
+    downloadAnalyticsExport: {
+        parameters: {
+            query?: {
+                /** @description The workspace to act on, for links that cannot send `Yuva-Workspace`. */
+                workspace_id?: string;
+            };
+            header?: {
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
+            path: {
+                propertyId: components["parameters"]["AnalyticsPropertyId"];
+                exportId: components["parameters"]["AnalyticsExportId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The file. NDJSON has one JSON object per line, `AnalyticsRawEvent` for `raw`. */
+            200: {
+                headers: {
+                    "Content-Disposition"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/csv": string;
+                    "application/x-ndjson": components["schemas"]["AnalyticsRawEvent"];
+                };
+            };
+            400: components["responses"]["Problem"];
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+            409: components["responses"]["Problem"];
+        };
+    };
+    realtime: {
+        parameters: {
+            query?: {
+                /** @description The workspace to act on, for clients that cannot send `Yuva-Workspace`. */
+                workspace_id?: string;
+                /** @description Replay the events after this one before streaming live ones. */
+                last_event_id?: number;
+            };
+            header?: {
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /**
+             * @description Switching to the WebSocket protocol. Each text frame is one `RealtimeMessage`; the
+             *     content below describes a frame, not an HTTP body.
+             */
+            101: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RealtimeMessage"];
+                };
+            };
+            400: components["responses"]["Problem"];
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            503: components["responses"]["Problem"];
+        };
+    };
+    getClientSession: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The session. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ClientSessionInfo"];
+                };
+            };
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+        };
+    };
+    createClientSession: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ClientSessionCreate"];
+            };
+        };
+        responses: {
+            /** @description The session, the contact and the inbox's public settings. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ClientSession"];
+                };
+            };
+            400: components["responses"]["Problem"];
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+            429: components["responses"]["Problem"];
+        };
+    };
+    deleteClientSession: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Ended. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+        };
+    };
+    getClientChannel: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The chat or app channel's public key. */
+                channel_key: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The inbox's public settings. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ClientInbox"];
+                };
+            };
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+            429: components["responses"]["Problem"];
+        };
+    };
+    createPageRating: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The chat channel's public key. */
+                channel_key: components["parameters"]["ChannelKey"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PageRatingCreate"];
+            };
+        };
+        responses: {
+            /** @description Counted. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            400: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+            429: components["responses"]["Problem"];
+        };
+    };
+    listClientDiscussions: {
+        parameters: {
+            query: {
+                /** @description The page's URL. */
+                page: string;
+                sort?: components["schemas"]["DiscussionSort"];
+                /** @description The `next_cursor` of the previous page. */
+                cursor?: components["parameters"]["Cursor"];
+                /** @description Page size, 1 to 100; 25 by default. */
+                limit?: components["parameters"]["Limit"];
+            };
+            header?: never;
+            path: {
+                /** @description The chat channel's public key. */
+                channel_key: components["parameters"]["ChannelKey"];
             };
             cookie?: never;
         };
@@ -22530,6 +24387,132 @@ export interface operations {
             503: components["responses"]["Problem"];
         };
     };
+    getSharedAnalytics: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The share link's token, `yuva_sh_…`. */
+                token: components["parameters"]["AnalyticsShareToken"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The link's page settings. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AnalyticsSharedPage"];
+                };
+            };
+            401: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+            429: components["responses"]["Problem"];
+        };
+    };
+    unlockSharedAnalytics: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The share link's token, `yuva_sh_…`. */
+                token: components["parameters"]["AnalyticsShareToken"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AnalyticsShareUnlock"];
+            };
+        };
+        responses: {
+            /** @description The access token. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AnalyticsShareAccess"];
+                };
+            };
+            400: components["responses"]["Problem"];
+            401: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+            409: components["responses"]["Problem"];
+            429: components["responses"]["Problem"];
+        };
+    };
+    querySharedAnalytics: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The share link's token, `yuva_sh_…`. */
+                token: components["parameters"]["AnalyticsShareToken"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AnalyticsQuery"];
+            };
+        };
+        responses: {
+            /** @description The numbers. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AnalyticsResult"];
+                };
+            };
+            400: components["responses"]["Problem"];
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+            /** @description `needs_raw_window` or `range_too_large`, as on `queryAnalytics`. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["AnalyticsRangeProblem"];
+                };
+            };
+            429: components["responses"]["Problem"];
+        };
+    };
+    getSharedAnalyticsRealtime: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The share link's token, `yuva_sh_…`. */
+                token: components["parameters"]["AnalyticsShareToken"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The last 30 minutes. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AnalyticsRealtime"];
+                };
+            };
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+            429: components["responses"]["Problem"];
+        };
+    };
     clientRealtime: {
         parameters: {
             query?: {
@@ -23404,4 +25387,37 @@ export interface operations {
             };
         };
     };
+    webhookAnalyticsAlert: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description The delivery's id, the same on every retry; use it to ignore duplicates. */
+                "webhook-id": components["parameters"]["WebhookIdHeader"];
+                /** @description Unix seconds of this attempt. Refuse values far from your clock. */
+                "webhook-timestamp": components["parameters"]["WebhookTimestampHeader"];
+                /**
+                 * @description Space-separated `v1,<base64>` signatures: HMAC-SHA256 over
+                 *     `<webhook-id>.<webhook-timestamp>.<body>` with the base64-decoded part of the
+                 *     `whsec_` secret (Standard Webhooks). Two during a secret rotation.
+                 */
+                "webhook-signature": components["parameters"]["WebhookSignatureHeader"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["WebhookAnalyticsAlertPayload"];
+            };
+        };
+        responses: {
+            /** @description Any 2xx answer counts as delivered. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
 }