@curviate/sdk 0.29.0 → 0.31.0

package/dist/index.d.ts

@@ -2409,7 +2409,7 @@ interface paths {
         put?: never;
         /**
          * Start a credential/cookie authentication
-         * @description Authenticate a LinkedIn account directly with credentials or a session cookie. The credential fields are NESTED, not top level: `auth_method: "credentials"` reads `credentials: { email, password }`, and `auth_method: "cookie"` reads `cookie: { li_at }` plus a top-level `user_agent`. Omit `account_id` to connect a NEW account into an empty `seat_id` (every seat id is listed with click-to-copy in the seat table on your dashboard); include `account_id` (in the body) to re-authenticate an EXISTING account in place. Returns the account on success (201 new / 200 reconnect), or a checkpoint challenge (202) carrying the account_id when LinkedIn requires verification. Complete the challenge with POST /v1/auth/checkpoint/solve (codes) or POST /v1/auth/checkpoint/poll (mobile-app approval). Connection scope (which LinkedIn products are enabled) is derived from the account's seat, there is no products input; the recorded scope is readable as `requested_products` on the account. A reconnect that changes scope must use credentials (a saved cookie cannot change scope). Pin a managed proxy with the optional `country`/`ip` or supply a `proxy` to override it.
+         * @description Authenticate a LinkedIn account directly with credentials or a session cookie. The credential fields are NESTED, not top level: `auth_method: "credentials"` reads `credentials: { email, password }`, and `auth_method: "cookie"` reads `cookie: { li_at }` plus a top-level `user_agent`. Omit `account_id` to connect a NEW account into an empty `seat_id` (every seat id is listed with click-to-copy in the seat table on your dashboard); include `account_id` (in the body) to re-authenticate an EXISTING account in place. Returns the account on success (201 new / 200 reconnect), or a checkpoint challenge (202) carrying the account_id when LinkedIn requires verification. Complete the challenge with POST /v1/auth/checkpoint/solve (codes) or POST /v1/auth/checkpoint/poll (mobile-app approval). Connection scope (which LinkedIn products are enabled) is not something you list: the connection asks for every product and LinkedIn activates the ones the account actually has. The recorded scope is readable as `requested_products` on the account. One LinkedIn account can hold only one of the two premium surfaces, and when both are asked for Sales Navigator takes precedence, so pass the optional `linkedin_premium` (`sales_navigator` or `recruiter`) if the account holds both and you want the other one. Omit it and nothing is narrowed. It applies per connection and is not remembered, so state it on every connect and reconnect where Recruiter must win. A reconnect that changes scope must use credentials (a saved cookie cannot change scope), which includes any reconnect of an account connected before the full product set became the default. Pin a managed proxy with the optional `country`/`ip` or supply a `proxy` to override it.
          */
         post: operations["postV1AuthIntent"];
         delete?: never;
@@ -2611,7 +2611,7 @@ interface paths {
         };
         /**
          * List webhook event types
-         * @description Returns the complete canonical event catalogue (27 events) grouped by source: messaging (7), user (2), account_status (15), plus 3 tier-gated events. A local catalogue read: no platform call is made.
+         * @description Returns the complete canonical event catalogue (27 events) grouped by source: messaging (7), user (2), account_status (15), plus 3 recruiter/sales_nav events. A local catalogue read: no platform call is made.
          */
         get: operations["getV1WebhooksEvents"];
         put?: never;
@@ -2679,7 +2679,7 @@ interface paths {
         };
         /**
          * Read an account's safety policy
-         * @description Returns every configurable safety field for every budget row of one account, in a single response: the ceiling, the green and amber bands, the counting window, the enforcement posture and where it was inherited from, the activity window, warm-up state, the per-row character caps and search per-query cap, and how well calibrated each row's number is. Every value is seeded configuration and every one of them is settable. Where a configured value is above the Curviate default, the row carries an `over_default` entry naming the value, the default and the source class of that default. The response also carries `tenant_default_posture`, the workspace-wide default every account inherits, separately from this account's own effective `posture`, and `limit_profile`, which says which of the four Curviate default sets (`basic`, `premium`, `sales_navigator`, `recruiter`) every row below was resolved from, detected from the platform when the account connected. When the Curviate seat attached to this account disagrees with that, `seat_tier_mismatch` names the seat tier; the detected product wins the numbers either way.
+         * @description Returns every configurable safety field for every budget row of one account, in a single response: the ceiling, the green and amber bands, the counting window, the enforcement posture and where it was inherited from, the activity window, warm-up state, the per-row character caps and search per-query cap, and how well calibrated each row's number is. Every value is seeded configuration and every one of them is settable. Where a configured value is above the Curviate default, the row carries an `over_default` entry naming the value, the default and the source class of that default. The response also carries `tenant_default_posture`, the workspace-wide default every account inherits, separately from this account's own effective `posture`, and `limit_profile`, which says which of the four Curviate default sets (`basic`, `premium`, `sales_navigator`, `recruiter`) every row below was resolved from, detected from the platform when the account connected.
          */
         get: operations["getV1AccountIdSafetyPolicy"];
         put?: never;
@@ -2689,7 +2689,7 @@ interface paths {
         head?: never;
         /**
          * Update an account's safety policy
-         * @description The single safety-policy write. Send only the fields you are changing: everything you omit is left byte-identical, and sending `null` for a field clears your override and restores the Curviate default. Any limit may be set to any value: Curviate does not clamp, cap or refuse a change on the grounds that the number is unsafe. A value above the Curviate default is reported back in the response, and on every later read, with the default and its source class attached; there is no way to acknowledge it away, and setting the value back to the default removes it. A value that is not a value, such as a negative ceiling or an unknown row name, is a 400. Every field whose value CHANGES is appended to the account's action ledger with the previous value, the new value, the Curviate default, the actor and the time; a field you send whose value already equals its current effective value is not ledgered and is not stored as an override, so reading the policy and sending the document back changes nothing. Six fields on the read are derived rather than configured: `effective_ceiling`, `interface_ceiling`, `effective_interface_ceiling`, `posture_source`, `over_default` and each row's `warm_up_state`. Send them and they are accepted and ignored, never stored and never ledgered, so the document you read can go straight back. To pin a row's ramp, set `warm_up_factor`. `activity_window` is not accepted: send its settable subfields instead, the top-level `timezone` for the zone, and per row `activity_window_start`, `activity_window_end`, `activity_window_timezone` and `activity_window_applies_to`. The 400 this produces names those subfields, not just the refused object. And read `changes nothing` as `changes no limit`: the `posture` fields are OVERRIDES at every scope, so writing back a posture a scope merely inherits PINS it there and appends one ledger entry per pinned scope. That is what stops a later account- or tenant-wide change from moving it. A pin already in place is a no-op. An agent-authenticated write is accepted on exactly the same footing as an operator's. There is no bulk import, file upload or policy template: configuring many rows or many accounts is a loop over this operation. One field is not account-scoped: `tenant_default_posture` sets the default for EVERY account in the tenant, not just the one in the path, which is what makes it a one-call change for a whole workspace of personas. It is reported back at the top of every policy response, so a change to it is visible even on an account that overrides it. One other field is not row-scoped: `limit_profile` selects which of the four Curviate default sets this account's rows resolve from, so it moves the default under every row at once while leaving every value you have configured explicitly exactly as you set it. It is the platform product active on the account, not your Curviate seat entitlement, and the two can disagree: a lapsed subscription leaves the seat untouched. Curviate detects it when the account connects and re-detects it on every reconnect; setting it here is an operator override of that result, and it holds until the next connect. When the seat and the detected product disagree, the detected product wins the numbers and the read reports the disagreement as `seat_tier_mismatch`. One field on this operation does not configure anything: `clear_halts` lifts the platform pause on the action types you name. When the platform refuses a call on an account, Curviate pauses that action type for the platform's own retry-after or a seeded cooldown, and every later call on it is refused locally without reaching the platform; the account resource reports the live pauses as `quotas[].halt`. Naming an action type here lifts its pause immediately, so the next call goes out. An action type with no active pause is accepted and does nothing, which makes it safe to send for a set you have not checked, and only the ones actually lifted are ledgered, each with the expiry it cut short, the actor and the time, readable afterwards on `GET /v1/{account_id}/safety-events` with `reason: "halt_cleared"`. Clearing disarms nothing: if the platform refuses the account again the pause returns, and a 429 or a refused write returns it for the full cooldown. Clear one when you have reason to believe the refusal was a transient upstream fault rather than the platform pushing back on this account.
+         * @description The single safety-policy write. Send only the fields you are changing: everything you omit is left byte-identical, and sending `null` for a field clears your override and restores the Curviate default. Any limit may be set to any value: Curviate does not clamp, cap or refuse a change on the grounds that the number is unsafe. A value above the Curviate default is reported back in the response, and on every later read, with the default and its source class attached; there is no way to acknowledge it away, and setting the value back to the default removes it. A value that is not a value, such as a negative ceiling or an unknown row name, is a 400. Every field whose value CHANGES is appended to the account's action ledger with the previous value, the new value, the Curviate default, the actor and the time; a field you send whose value already equals its current effective value is not ledgered and is not stored as an override, so reading the policy and sending the document back changes nothing. Six fields on the read are derived rather than configured: `effective_ceiling`, `interface_ceiling`, `effective_interface_ceiling`, `posture_source`, `over_default` and each row's `warm_up_state`. Send them and they are accepted and ignored, never stored and never ledgered, so the document you read can go straight back. To pin a row's ramp, set `warm_up_factor`. `activity_window` is not accepted: send its settable subfields instead, the top-level `timezone` for the zone, and per row `activity_window_start`, `activity_window_end`, `activity_window_timezone` and `activity_window_applies_to`. The 400 this produces names those subfields, not just the refused object. And read `changes nothing` as `changes no limit`: the `posture` fields are OVERRIDES at every scope, so writing back a posture a scope merely inherits PINS it there and appends one ledger entry per pinned scope. That is what stops a later account- or tenant-wide change from moving it. A pin already in place is a no-op. An agent-authenticated write is accepted on exactly the same footing as an operator's. There is no bulk import, file upload or policy template: configuring many rows or many accounts is a loop over this operation. One field is not account-scoped: `tenant_default_posture` sets the default for EVERY account in the tenant, not just the one in the path, which is what makes it a one-call change for a whole workspace of personas. It is reported back at the top of every policy response, so a change to it is visible even on an account that overrides it. One other field is not row-scoped: `limit_profile` selects which of the four Curviate default sets this account's rows resolve from, so it moves the default under every row at once while leaving every value you have configured explicitly exactly as you set it. It is the platform product active on the account, not your Curviate seat entitlement, and the two can disagree: a lapsed subscription leaves the seat untouched. Curviate detects it when the account connects and re-detects it on every reconnect; setting it here is an operator override of that result, and it holds until the next connect. One field on this operation does not configure anything: `clear_halts` lifts the platform pause on the action types you name. When the platform refuses a call on an account, Curviate pauses that action type for the platform's own retry-after or a seeded cooldown, and every later call on it is refused locally without reaching the platform; the account resource reports the live pauses as `quotas[].halt`. Naming an action type here lifts its pause immediately, so the next call goes out. An action type with no active pause is accepted and does nothing, which makes it safe to send for a set you have not checked, and only the ones actually lifted are ledgered, each with the expiry it cut short, the actor and the time, readable afterwards on `GET /v1/{account_id}/safety-events` with `reason: "halt_cleared"`. Clearing disarms nothing: if the platform refuses the account again the pause returns, and a 429 or a refused write returns it for the full cooldown. Clear one when you have reason to believe the refusal was a transient upstream fault rather than the platform pushing back on this account.
          */
         patch: operations["patchV1AccountIdSafetyPolicy"];
         trace?: never;
@@ -2742,11 +2742,6 @@ interface components {
             user_fixable: boolean;
             /** @description True when an identical retry is likely to succeed. */
             retry_likely_to_succeed: boolean;
-            /**
-             * @description Present on tier-gated denials, the seat tier required to proceed.
-             * @enum {string}
-             */
-            required_tier?: "core" | "sales_nav" | "recruiter";
             /** @description Present on a PLATFORM_RATE_LIMIT raised because one account-safety budget row is paused: LinkedIn refused a recent call on that row, so this one was refused locally without reaching LinkedIn. Names the paused row (for example profile_views, connection_requests_no_note). The pause is scoped to this row on this account; every other row keeps working. Absent on every other rate limit. Also present on BUDGET_EXHAUSTED, where it names the row that hit its CEILING rather than one LinkedIn paused: read the code to tell the two apart, because the recovery differs. Null on a BUDGET_EXHAUSTED whose reason is activity_window and whose action spends no budget of its own, because there is no row to name; hint.parameter still names the setting to change. Never null on a rate limit. */
             row?: string | null;
             /** @description Present on BUDGET_EXHAUSTED: the instant the refusal lifts, as an absolute instant rather than a duration, so it stays true however long you hold it. It is the window roll on a ceiling refusal and the next window open on an activity-window one. It is null in the two cases where no clock frees the account: the pending_invites gauge, whose backlog falls when invitations are accepted or withdrawn, and an InMail credit exhaustion (row inmail), which LinkedIn regrants on a schedule this product cannot read. */
@@ -2973,8 +2968,12 @@ interface operations {
                         public_picture_url_large?: string;
                         /** @description A private, time-limited picture download URL (present only in some responses). */
                         private_picture_download_url?: string;
-                        /** @description Profile summary/about section. Passes through verbatim, never stored. */
+                        /** @description Cover/background photo URL. */
+                        background_picture_url?: string;
+                        /** @description Mirrors the profile headline (the short line shown under the member's name). NOT the About/Summary section; see `bio` for that. */
                         description?: string;
+                        /** @description The profile's About/Summary section (free text). Distinct from `description`, which mirrors the headline, not this field. */
+                        bio?: string;
                         /** @description Geographic location string. */
                         location?: string;
                         /** @description ISO-8601 timestamp for when this profile record was created on the platform. */
@@ -2983,10 +2982,25 @@ interface operations {
                         emails?: string[];
                         /** @description Phone numbers associated with the profile. */
                         phone_numbers?: string[];
+                        /** @description Self-declared social handles keyed by platform (e.g. 'github'), each an object naming the handle. Same sensitivity class as `emails`/`phone_numbers` (self-declared contact-class info). */
+                        social_handles?: {
+                            [key: string]: {
+                                /** @description The handle's display name. */
+                                name?: string;
+                            };
+                        };
+                        /** @description Personal/professional website URLs associated with the profile. */
+                        websites?: string[];
                         /** @description Whether the authenticated account has blocked this member. */
                         is_blocked?: boolean;
                         /** @description Whether the authenticated account follows this member. */
                         is_following?: boolean;
+                        /** @description Whether LinkedIn has verified this member. */
+                        is_verified?: boolean;
+                        /** @description Same value as specifics.is_premium; prefer the nested field. */
+                        is_premium?: boolean;
+                        /** @description The member's profile language. Distinct from specifics.default_locale/specifics.supported_locales. */
+                        language?: string;
                         /** @description Total follower count. */
                         followers_count?: number;
                         /** @description Total 1st-degree connection count. */
@@ -4241,7 +4255,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The account does not have the required Core seat. */
+            /** @description Forbidden. NO_ACTIVE_SEAT: the account is not attached to an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -4289,7 +4303,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description A temporary error occurred. Please try again. */
+            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Check `retry_likely_to_succeed`: a temporary error is worth retrying, a response that could not be interpreted is not, and carries `retry_hint: {"kind": "never"}`. */
             502: {
                 headers: {
                     [name: string]: unknown;
@@ -4434,7 +4448,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Please try again. */
+            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Check `retry_likely_to_succeed`: a temporary error is worth retrying, a response that could not be interpreted is not, and carries `retry_hint: {"kind": "never"}`. */
             502: {
                 headers: {
                     [name: string]: unknown;
@@ -4577,7 +4591,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Please try again. */
+            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Check `retry_likely_to_succeed`: a temporary error is worth retrying, a response that could not be interpreted is not, and carries `retry_hint: {"kind": "never"}`. */
             502: {
                 headers: {
                     [name: string]: unknown;
@@ -4720,7 +4734,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Please try again. */
+            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Check `retry_likely_to_succeed`: a temporary error is worth retrying, a response that could not be interpreted is not, and carries `retry_hint: {"kind": "never"}`. */
             502: {
                 headers: {
                     [name: string]: unknown;
@@ -4859,7 +4873,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Please try again. */
+            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Check `retry_likely_to_succeed`: a temporary error is worth retrying, a response that could not be interpreted is not, and carries `retry_hint: {"kind": "never"}`. */
             502: {
                 headers: {
                     [name: string]: unknown;
@@ -5609,7 +5623,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The account does not have the required Core seat. */
+            /** @description Forbidden. NO_ACTIVE_SEAT: the account is not attached to an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -5800,7 +5814,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The account does not have the required Core seat. */
+            /** @description Forbidden. NO_ACTIVE_SEAT: the account is not attached to an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -5994,7 +6008,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The account does not have the required Core seat. */
+            /** @description Forbidden. NO_ACTIVE_SEAT: the account is not attached to an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -6174,7 +6188,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The account does not have the required Core seat. */
+            /** @description Forbidden. NO_ACTIVE_SEAT: the account is not attached to an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -6332,7 +6346,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The account does not administer this page with the invite-to-follow entitlement (fail-closed), or lacks the required Core seat. */
+            /** @description The account does not administer this page with the invite-to-follow entitlement (fail-closed), or lacks an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -6499,7 +6513,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The account does not administer this page (follower analytics is admin-gated), or lacks the required Core seat. */
+            /** @description The account does not administer this page (follower analytics is admin-gated), or lacks an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -6547,7 +6561,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description A temporary error occurred. Please try again. */
+            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Check `retry_likely_to_succeed`: a temporary error is worth retrying, a response that could not be interpreted is not, and carries `retry_hint: {"kind": "never"}`. */
             502: {
                 headers: {
                     [name: string]: unknown;
@@ -6647,7 +6661,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The account does not administer this page with the invite-to-follow entitlement, or lacks the required Core seat. */
+            /** @description The account does not administer this page with the invite-to-follow entitlement, or lacks an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -6695,7 +6709,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description A temporary error occurred. Please try again. */
+            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Check `retry_likely_to_succeed`: a temporary error is worth retrying, a response that could not be interpreted is not, and carries `retry_hint: {"kind": "never"}`. */
             502: {
                 headers: {
                     [name: string]: unknown;
@@ -6842,7 +6856,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The account does not administer this page (the admin gate), or lacks the required Core seat. */
+            /** @description The account does not administer this page (the admin gate), or lacks an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -6890,7 +6904,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description A temporary error occurred. Please try again. */
+            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Check `retry_likely_to_succeed`: a temporary error is worth retrying, a response that could not be interpreted is not, and carries `retry_hint: {"kind": "never"}`. */
             502: {
                 headers: {
                     [name: string]: unknown;
@@ -7025,7 +7039,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The account does not administer this page (the admin gate), or lacks the required Core seat. */
+            /** @description The account does not administer this page (the admin gate), or lacks an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -7073,7 +7087,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description A temporary error occurred. Please try again. */
+            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Check `retry_likely_to_succeed`: a temporary error is worth retrying, a response that could not be interpreted is not, and carries `retry_hint: {"kind": "never"}`. */
             502: {
                 headers: {
                     [name: string]: unknown;
@@ -7201,7 +7215,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The account does not administer this page (the admin gate), or lacks the required Core seat. */
+            /** @description The account does not administer this page (the admin gate), or lacks an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -7249,7 +7263,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description A temporary error occurred. Please try again. */
+            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Check `retry_likely_to_succeed`: a temporary error is worth retrying, a response that could not be interpreted is not, and carries `retry_hint: {"kind": "never"}`. */
             502: {
                 headers: {
                     [name: string]: unknown;
@@ -7362,7 +7376,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The account does not administer this page (fail-closed, the target company is absent from the account's administered pages), or the account lacks the required Core seat. */
+            /** @description The account does not administer this page (fail-closed, the target company is absent from the account's administered pages), or the account lacks an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -7428,7 +7442,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description A temporary error occurred. Please try again. */
+            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Check `retry_likely_to_succeed`: a temporary error is worth retrying, a response that could not be interpreted is not, and carries `retry_hint: {"kind": "never"}`. */
             502: {
                 headers: {
                     [name: string]: unknown;
@@ -7544,7 +7558,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The account does not administer this page (the admin gate), or lacks the required Core seat. */
+            /** @description The account does not administer this page (the admin gate), or lacks an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -7592,7 +7606,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description A temporary error occurred. Please try again. */
+            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Check `retry_likely_to_succeed`: a temporary error is worth retrying, a response that could not be interpreted is not, and carries `retry_hint: {"kind": "never"}`. */
             502: {
                 headers: {
                     [name: string]: unknown;
@@ -7750,7 +7764,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The account does not administer this page (the admin gate), or lacks the required Core seat. */
+            /** @description The account does not administer this page (the admin gate), or lacks an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -7798,7 +7812,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description A temporary error occurred. Please try again. */
+            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Check `retry_likely_to_succeed`: a temporary error is worth retrying, a response that could not be interpreted is not, and carries `retry_hint: {"kind": "never"}`. */
             502: {
                 headers: {
                     [name: string]: unknown;
@@ -7943,7 +7957,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description No active Core seat for this tenant. */
+            /** @description Forbidden. NO_ACTIVE_SEAT: the account is not attached to an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -8119,7 +8133,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description No active Core seat for this tenant. */
+            /** @description Forbidden. NO_ACTIVE_SEAT: the account is not attached to an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -8282,7 +8296,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description No active Core seat for this tenant. */
+            /** @description Forbidden. NO_ACTIVE_SEAT: the account is not attached to an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -9305,7 +9319,7 @@ interface operations {
                         }[];
                         /** @description Paging metadata. */
                         paging: {
-                            /** @description Total matching result count. */
+                            /** @description Total number of matching job postings, including 0 on an empty page. */
                             total_count: number | null;
                         };
                         /** @description Opaque next-page cursor; null on the last page. */
@@ -9830,7 +9844,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description A temporary error occurred. Please try again. */
+            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Check `retry_likely_to_succeed`: a temporary error is worth retrying, a response that could not be interpreted is not, and carries `retry_hint: {"kind": "never"}`. */
             502: {
                 headers: {
                     [name: string]: unknown;
@@ -13148,7 +13162,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Please try again. */
+            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Check `retry_likely_to_succeed`: a temporary error is worth retrying, a response that could not be interpreted is not, and carries `retry_hint: {"kind": "never"}`. */
             502: {
                 headers: {
                     [name: string]: unknown;
@@ -13272,7 +13286,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description A temporary upstream error occurred. Please try again. */
+            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Check `retry_likely_to_succeed`: a temporary error is worth retrying, a response that could not be interpreted is not, and carries `retry_hint: {"kind": "never"}`. */
             502: {
                 headers: {
                     [name: string]: unknown;
@@ -13396,7 +13410,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description A temporary upstream error occurred. Please try again. */
+            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Check `retry_likely_to_succeed`: a temporary error is worth retrying, a response that could not be interpreted is not, and carries `retry_hint: {"kind": "never"}`. */
             502: {
                 headers: {
                     [name: string]: unknown;
@@ -16099,7 +16113,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The account does not have the required Core seat. */
+            /** @description Forbidden. NO_ACTIVE_SEAT: the account is not attached to an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -16350,7 +16364,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The account does not have the required Core seat. */
+            /** @description Forbidden. NO_ACTIVE_SEAT: the account is not attached to an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -16575,7 +16589,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The account does not have the required Core seat. */
+            /** @description Forbidden. NO_ACTIVE_SEAT: the account is not attached to an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -16828,7 +16842,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The account does not have the required Core seat. */
+            /** @description Forbidden. NO_ACTIVE_SEAT: the account is not attached to an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -16998,7 +17012,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The account does not have the required Core seat. */
+            /** @description Forbidden. NO_ACTIVE_SEAT: the account is not attached to an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -17186,7 +17200,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. Either the account does not have the required Core seat (TIER_NOT_ACTIVE, carries required_tier:'core'; upgrade the Curviate subscription), or LINKEDIN_FEATURE_NOT_SUBSCRIBED, the connected LinkedIn account lacks the subscription/entitlement LinkedIn requires to publish job postings, even a FREE posting (activate it on LinkedIn; reconnecting will not help). The code field distinguishes the two. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED, the connected LinkedIn account lacks the subscription/entitlement LinkedIn requires to publish job postings, even a FREE posting (activate it on LinkedIn; reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -17322,7 +17336,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. Either the account does not have the required Core seat (TIER_NOT_ACTIVE, carries required_tier:'core'; upgrade the Curviate subscription), or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the connected LinkedIn account lacks the subscription/entitlement LinkedIn requires to manage job postings (the same gate that blocks publish also blocks close; activate it on LinkedIn; reconnecting will not help). The code field distinguishes the two. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the connected LinkedIn account lacks the subscription/entitlement LinkedIn requires to manage job postings (the same gate that blocks publish also blocks close; activate it on LinkedIn; reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -17545,7 +17559,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The account does not have the required Core seat. */
+            /** @description Forbidden. NO_ACTIVE_SEAT: the account is not attached to an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -17737,7 +17751,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The account does not have the required Core seat. */
+            /** @description Forbidden. NO_ACTIVE_SEAT: the account is not attached to an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -17859,7 +17873,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The account does not have the required Core seat. */
+            /** @description Forbidden. NO_ACTIVE_SEAT: the account is not attached to an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -19325,7 +19339,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description This account does not have an active Core seat. */
+            /** @description Forbidden. NO_ACTIVE_SEAT: the account is not attached to an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -19364,7 +19378,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description A temporary error occurred. Please try again. */
+            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Check `retry_likely_to_succeed`: a temporary error is worth retrying, a response that could not be interpreted is not, and carries `retry_hint: {"kind": "never"}`. */
             502: {
                 headers: {
                     [name: string]: unknown;
@@ -19452,7 +19466,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description This account does not have an active Core seat. */
+            /** @description Forbidden. NO_ACTIVE_SEAT: the account is not attached to an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -19500,7 +19514,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description A temporary error occurred. Please try again. */
+            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Check `retry_likely_to_succeed`: a temporary error is worth retrying, a response that could not be interpreted is not, and carries `retry_hint: {"kind": "never"}`. */
             502: {
                 headers: {
                     [name: string]: unknown;
@@ -19583,7 +19597,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description This account does not have an active Core seat. */
+            /** @description Forbidden. NO_ACTIVE_SEAT: the account is not attached to an active seat. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -19622,7 +19636,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description A temporary error occurred. Please try again. */
+            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Check `retry_likely_to_succeed`: a temporary error is worth retrying, a response that could not be interpreted is not, and carries `retry_hint: {"kind": "never"}`. */
             502: {
                 headers: {
                     [name: string]: unknown;
@@ -20030,7 +20044,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. Either TIER_NOT_ACTIVE, the Curviate seat lacks the Recruiter add-on (carries required_tier:'recruiter'; upgrade the Curviate subscription), or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the connected LinkedIn account lacks an active Recruiter subscription. The code field distinguishes the two. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Recruiter subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -20248,7 +20262,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. Either TIER_NOT_ACTIVE, the Curviate seat lacks the Recruiter add-on (carries required_tier:'recruiter'; upgrade the Curviate subscription), or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the connected LinkedIn account lacks the Recruiter subscription (activate it on LinkedIn; reconnecting will not help). The code field distinguishes the two. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Recruiter subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -20561,7 +20575,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. TIER_NOT_ACTIVE, the Curviate seat lacks the Recruiter add-on, or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the LinkedIn account does not have an active Recruiter subscription. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Recruiter subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -20754,7 +20768,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. Either TIER_NOT_ACTIVE, the Curviate seat lacks the Recruiter add-on (carries required_tier:'recruiter'; upgrade the Curviate subscription), or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the connected LinkedIn account does not have an active Recruiter subscription. The code field distinguishes the two. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Recruiter subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -20988,7 +21002,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. TIER_NOT_ACTIVE, the Curviate seat lacks the Recruiter add-on, or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the LinkedIn account does not have an active Recruiter subscription. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Recruiter subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -21192,7 +21206,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. TIER_NOT_ACTIVE, the Curviate seat lacks the Recruiter add-on, or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the LinkedIn account does not have an active Recruiter subscription. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Recruiter subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -21350,7 +21364,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. TIER_NOT_ACTIVE, the Curviate seat lacks the Recruiter add-on, or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the LinkedIn account does not have an active Recruiter subscription. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Recruiter subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -21604,7 +21618,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. TIER_NOT_ACTIVE, the Curviate seat lacks the Recruiter add-on, or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the LinkedIn account does not have an active Recruiter subscription. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Recruiter subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -21912,7 +21926,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. TIER_NOT_ACTIVE, the Curviate seat lacks the Recruiter add-on, or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the LinkedIn account does not have an active Recruiter subscription. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Recruiter subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -22256,7 +22270,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. TIER_NOT_ACTIVE, the Curviate seat lacks the Recruiter add-on, or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the LinkedIn account does not have an active Recruiter subscription. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Recruiter subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -22436,7 +22450,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. TIER_NOT_ACTIVE, the Curviate seat lacks the Recruiter add-on, or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the LinkedIn account does not have an active Recruiter subscription. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Recruiter subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -22644,7 +22658,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. TIER_NOT_ACTIVE, the Curviate seat lacks the Recruiter add-on, or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the LinkedIn account does not have an active Recruiter subscription. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Recruiter subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -22799,7 +22813,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. TIER_NOT_ACTIVE, the Curviate seat lacks the Recruiter add-on, or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the LinkedIn account does not have an active Recruiter subscription. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Recruiter subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -22964,7 +22978,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. TIER_NOT_ACTIVE, the Curviate seat lacks the Recruiter add-on, or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the LinkedIn account does not have an active Recruiter subscription. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Recruiter subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -23172,7 +23186,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. TIER_NOT_ACTIVE, the Curviate seat lacks the Recruiter add-on, or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the LinkedIn account does not have an active Recruiter subscription. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Recruiter subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -23352,7 +23366,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. TIER_NOT_ACTIVE, the Curviate seat lacks the Recruiter add-on, or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the LinkedIn account does not have an active Recruiter subscription. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Recruiter subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -23560,7 +23574,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. TIER_NOT_ACTIVE, the Curviate seat lacks the Recruiter add-on, or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the LinkedIn account does not have an active Recruiter subscription. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Recruiter subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -23755,7 +23769,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. TIER_NOT_ACTIVE, the Curviate seat lacks the Recruiter add-on, or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the LinkedIn account does not have an active Recruiter subscription. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Recruiter subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -23893,7 +23907,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. TIER_NOT_ACTIVE, the Curviate seat lacks the Recruiter add-on, or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the LinkedIn account does not have an active Recruiter subscription. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Recruiter subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -24038,7 +24052,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. TIER_NOT_ACTIVE (no Recruiter seat) or LINKEDIN_FEATURE_NOT_SUBSCRIBED (no active LinkedIn Recruiter subscription). The code field distinguishes the two. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Recruiter subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -24370,7 +24384,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. TIER_NOT_ACTIVE, the Curviate seat lacks the Recruiter add-on, or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the LinkedIn account does not have an active Recruiter subscription. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Recruiter subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -24578,7 +24592,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. TIER_NOT_ACTIVE, the Curviate seat lacks the Recruiter add-on, or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the LinkedIn account does not have an active Recruiter subscription. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Recruiter subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -24700,7 +24714,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. TIER_NOT_ACTIVE, the Curviate seat lacks the Recruiter add-on, or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the LinkedIn account does not have an active Recruiter subscription. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Recruiter subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -24860,7 +24874,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. Either TIER_NOT_ACTIVE, the Curviate seat lacks the Sales Navigator add-on (carries required_tier:'sales_nav'; upgrade the Curviate subscription), or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the connected LinkedIn account lacks the Sales Navigator subscription (activate it on LinkedIn; reconnecting will not help). The code field distinguishes the two. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Sales Navigator subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -25175,7 +25189,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. Either TIER_NOT_ACTIVE, the Curviate seat lacks the Sales Navigator add-on (carries required_tier:'sales_nav'; upgrade the Curviate subscription), or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the connected LinkedIn account lacks the Sales Navigator subscription (activate it on LinkedIn; reconnecting will not help). The code field distinguishes the two. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Sales Navigator subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -25323,7 +25337,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. Either TIER_NOT_ACTIVE, the Curviate seat lacks the Sales Navigator add-on (carries required_tier:'sales_nav'; upgrade the Curviate subscription), or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the connected LinkedIn account lacks the Sales Navigator subscription (activate it on LinkedIn; reconnecting will not help). The code field distinguishes the two. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Sales Navigator subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -25480,7 +25494,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. Either TIER_NOT_ACTIVE, the Curviate seat lacks the Sales Navigator add-on (carries required_tier:'sales_nav'; upgrade the Curviate subscription), or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the connected LinkedIn account lacks the Sales Navigator subscription (activate it on LinkedIn; reconnecting will not help). The code field distinguishes the two. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Sales Navigator subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -25692,7 +25706,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. Either TIER_NOT_ACTIVE, the Curviate seat lacks the Sales Navigator add-on (carries required_tier:'sales_nav'; upgrade the Curviate subscription), or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the connected LinkedIn account lacks the Sales Navigator subscription (activate it on LinkedIn; reconnecting will not help). The code field distinguishes the two. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Sales Navigator subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -26078,7 +26092,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. Either TIER_NOT_ACTIVE, the Curviate seat lacks the Sales Navigator add-on (carries required_tier:'sales_nav'; upgrade the Curviate subscription), or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the connected LinkedIn account lacks the Sales Navigator subscription (activate it on LinkedIn; reconnecting will not help). The code field distinguishes the two. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Sales Navigator subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -26225,7 +26239,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. Either TIER_NOT_ACTIVE, the Curviate seat lacks the Sales Navigator add-on (carries required_tier:'sales_nav'; upgrade the Curviate subscription), or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the connected LinkedIn account lacks the Sales Navigator subscription (activate it on LinkedIn; reconnecting will not help). The code field distinguishes the two. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Sales Navigator subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -26372,7 +26386,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. Either TIER_NOT_ACTIVE, the Curviate seat lacks the Sales Navigator add-on (carries required_tier:'sales_nav'; upgrade the Curviate subscription), or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the connected LinkedIn account lacks the Sales Navigator subscription (activate it on LinkedIn; reconnecting will not help). The code field distinguishes the two. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Sales Navigator subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -26533,7 +26547,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. Either TIER_NOT_ACTIVE, the Curviate seat lacks the Sales Navigator add-on (carries required_tier:'sales_nav'; upgrade the Curviate subscription), or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the connected LinkedIn account lacks the Sales Navigator subscription (activate it on LinkedIn; reconnecting will not help). The code field distinguishes the two. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Sales Navigator subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -27014,7 +27028,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. Either TIER_NOT_ACTIVE, the Curviate seat lacks the Sales Navigator add-on (carries required_tier:'sales_nav'; upgrade the Curviate subscription), or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the connected LinkedIn account lacks the Sales Navigator subscription (activate it on LinkedIn; reconnecting will not help). The code field distinguishes the two. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Sales Navigator subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -27286,7 +27300,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. Either TIER_NOT_ACTIVE, the Curviate seat lacks the Sales Navigator add-on (carries required_tier:'sales_nav'; upgrade the Curviate subscription), or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the connected LinkedIn account lacks the Sales Navigator subscription (activate it on LinkedIn; reconnecting will not help). The code field distinguishes the two. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Sales Navigator subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -27687,7 +27701,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Forbidden. Either TIER_NOT_ACTIVE, the Curviate seat lacks the Sales Navigator add-on (carries required_tier:'sales_nav'; upgrade the Curviate subscription), or LINKEDIN_FEATURE_NOT_SUBSCRIBED; the connected LinkedIn account lacks the Sales Navigator subscription (activate it on LinkedIn; reconnecting will not help). The code field distinguishes the two. */
+            /** @description Forbidden. Either NO_ACTIVE_SEAT (the account is not attached to an active seat), or LINKEDIN_FEATURE_NOT_SUBSCRIBED (the connected LinkedIn account lacks the Sales Navigator subscription; activate it on LinkedIn, reconnecting will not help). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -27817,7 +27831,7 @@ interface operations {
                             seat_id?: string | null;
                             /** @description ISO-8601 UTC connection timestamp. */
                             connected_at?: string | null;
-                            /** @description The seat-derived connection scope this account was last connected with (e.g. ["classic","company","sales_navigator"]). Scope is derived from the account's seat; there is no products input. Null for accounts connected before this was recorded; not attachment truth for Company Pages. */
+                            /** @description The connection scope this account was last connected with (e.g. ["classic","company","sales_navigator","recruiter"]). A connect asks for every product and LinkedIn activates the ones the account actually has, so this is what was ASKED for, narrowed only by an explicit linkedin_premium on that connect. A linkedin_premium narrowing is not remembered between connects, so this shows what the LAST connect asked for and a reconnect that omits the field widens it again. Null for accounts connected before this was recorded; not attachment truth for Company Pages. */
                             requested_products?: ("classic" | "company" | "sales_navigator" | "recruiter")[] | null;
                             /** @description ISO-8601 UTC creation timestamp of the underlying LinkedIn account, distinct from connected_at. Null until the first background enrichment lands. */
                             substrate_created_at?: string | null;
@@ -27925,7 +27939,7 @@ interface operations {
                         last_checked_at?: string;
                         /** @description The seat this account occupies (null for an admin seatless account). */
                         seat_id?: string | null;
-                        /** @description The seat-derived connection scope this account was last connected with (e.g. ["classic","company","sales_navigator"]). Scope is derived from the account's seat; there is no products input. Null for accounts connected before this was recorded; not attachment truth for Company Pages. */
+                        /** @description The connection scope this account was last connected with (e.g. ["classic","company","sales_navigator","recruiter"]). A connect asks for every product and LinkedIn activates the ones the account actually has, so this is what was ASKED for, narrowed only by an explicit linkedin_premium on that connect. A linkedin_premium narrowing is not remembered between connects, so this shows what the LAST connect asked for and a reconnect that omits the field widens it again. Null for accounts connected before this was recorded; not attachment truth for Company Pages. */
                         requested_products?: ("classic" | "company" | "sales_navigator" | "recruiter")[] | null;
                         /** @description ISO-8601 UTC creation timestamp of the underlying LinkedIn account, distinct from connected_at. Null until the first background enrichment lands. */
                         substrate_created_at?: string | null;
@@ -28353,10 +28367,10 @@ interface operations {
                     /** @description Present = re-authenticate this existing account in place (reconnect); omit = connect a new account. */
                     account_id?: string;
                     /**
-                     * @description Free-trial seats only: which premium to enable for the trial (at most one). Ignored for paid seats. Defaults to none.
+                     * @description Optional. Which LinkedIn premium surface this connection should ask for: 'sales_navigator' or 'recruiter'. Omit it and the connection asks for every product, and LinkedIn activates whichever ones the account actually has. One LinkedIn account can hold only one of the two premium surfaces, and when both are asked for Sales Navigator takes precedence, so set this to 'recruiter' if the account holds both and you want the Recruiter surface. This applies per connection and is not remembered: state it on every connect and reconnect where Recruiter must win.
                      * @enum {string}
                      */
-                    trial_premium?: "none" | "sales_navigator" | "recruiter";
+                    linkedin_premium?: "sales_navigator" | "recruiter";
                     /** @description Managed proxy location hint as an ISO 3166-1 alpha-2 country code (e.g. US, DE). */
                     country?: string;
                     /** @description IPv4 address used to infer the managed proxy location. */
@@ -28386,7 +28400,7 @@ interface operations {
                         /** @description Maximum number of messages to sync per chat. */
                         messages?: number;
                     };
-                    /** @description Which Recruiter contract to bind this account to (Recruiter tier only). */
+                    /** @description Which Recruiter contract to bind this account to. Only meaningful when the LinkedIn account holds a Recruiter subscription. */
                     recruiter_contract_id?: string;
                 };
             };
@@ -28508,7 +28522,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Either LINKEDIN_FEATURE_NOT_SUBSCRIBED (the seat requested a premium product, Sales Navigator or Recruiter, that this LinkedIn account is not subscribed to; match the seat tier to the account's actual plan, or use a different seat), or ACCOUNT_RESTRICTED (LinkedIn has restricted this account; sign in to LinkedIn to see what it needs, resolve it there, then connect again). The code field distinguishes the two. */
+            /** @description Either LINKEDIN_FEATURE_NOT_SUBSCRIBED (this LinkedIn account is not subscribed to a premium product the connection asked for, Sales Navigator or Recruiter; activate that subscription on LinkedIn and connect again, or set linkedin_premium to the premium the account actually holds), or ACCOUNT_RESTRICTED (LinkedIn has restricted this account; sign in to LinkedIn to see what it needs, resolve it there, then connect again). The code field distinguishes the two. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -29975,11 +29989,6 @@ interface operations {
                                 description?: string;
                                 /** @description Present and true when the event carries LinkedIn-specific content. */
                                 linkedin_only?: boolean;
-                                /**
-                                 * @description Required add-on tier. Present only on tier-gated events.
-                                 * @enum {string}
-                                 */
-                                tier?: "recruiter" | "sales_nav";
                                 /**
                                  * @description Delivery timing. Omitted (equivalent to 'realtime') on every live-pushed event. 'no_longer_realtime' means no push exists for this event; 'not_realtime' means delivery is not guaranteed sub-second and may lag the underlying LinkedIn event, typically because it is detected by a poll rather than pushed, though a given event's own reference article may document an additional immediate path.
                                  * @enum {string}
@@ -30444,11 +30453,6 @@ interface operations {
                          * @enum {string}
                          */
                         limit_profile?: "basic" | "premium" | "sales_navigator" | "recruiter";
-                        /**
-                         * @description The Curviate seat tier attached to this account when it disagrees with `limit_profile`, and null when the two agree or the account holds no seat. A seat records what you bought from Curviate; `limit_profile` records what LinkedIn currently grants, and a lapsed subscription moves one and not the other. The detected product always wins the numbers, so this is a report, not a refusal: a `recruiter` seat here means you are paying for Recruiter on an account LinkedIn does not currently grant it to. `core` alongside `basic` or `premium` is agreement, not a mismatch: Premium is a LinkedIn product, not a Curviate tier. A free-trial seat never reports here, because a trial is not a purchase, and neither does a seat whose entitlement has not started yet or has already lapsed.
-                         * @enum {string|null}
-                         */
-                        seat_tier_mismatch?: "core" | "sn" | "recruiter" | null;
                         /**
                          * @description Where `limit_profile` came from. `detected`: Curviate read it from LinkedIn, at `limit_profile_detected_at`. `operator`: it was set through this operation and holds until the account next connects, or until you send `limit_profile_source: "default"` on this operation, which releases it. `default`: it has never been observed, so the value is the seeded `basic` and says nothing about the account; Curviate detects it on the account's next read or connect.
                          * @enum {string}
@@ -30709,8 +30713,6 @@ interface operations {
                     object?: unknown;
                     /** @description READ-ONLY. The account this document describes; the path names it. Sent back on a write it is accepted and ignored, so the whole document round-trips; it is never stored and never ledgered. */
                     account_id?: unknown;
-                    /** @description READ-ONLY. The Curviate seat tier that disagrees with `limit_profile`. Sent back on a write it is accepted and ignored, so the whole document round-trips; it is never stored and never ledgered. */
-                    seat_tier_mismatch?: unknown;
                     /**
                      * @description Where `limit_profile` came from: `default` (never observed), `detected` (read from LinkedIn) or `operator` (set through this operation). Sending `default` releases an operator override: the value is re-read from LinkedIn on the account's next read or connect. Sending `detected` or `operator` is accepted and ignored, so the whole document round-trips.
                      * @enum {string}
@@ -30749,11 +30751,6 @@ interface operations {
                          * @enum {string}
                          */
                         limit_profile?: "basic" | "premium" | "sales_navigator" | "recruiter";
-                        /**
-                         * @description The Curviate seat tier attached to this account when it disagrees with `limit_profile`, and null when the two agree or the account holds no seat. A seat records what you bought from Curviate; `limit_profile` records what LinkedIn currently grants, and a lapsed subscription moves one and not the other. The detected product always wins the numbers, so this is a report, not a refusal: a `recruiter` seat here means you are paying for Recruiter on an account LinkedIn does not currently grant it to. `core` alongside `basic` or `premium` is agreement, not a mismatch: Premium is a LinkedIn product, not a Curviate tier. A free-trial seat never reports here, because a trial is not a purchase, and neither does a seat whose entitlement has not started yet or has already lapsed.
-                         * @enum {string|null}
-                         */
-                        seat_tier_mismatch?: "core" | "sn" | "recruiter" | null;
                         /**
                          * @description Where `limit_profile` came from. `detected`: Curviate read it from LinkedIn, at `limit_profile_detected_at`. `operator`: it was set through this operation and holds until the account next connects, or until you send `limit_profile_source: "default"` on this operation, which releases it. `default`: it has never been observed, so the value is the seeded `basic` and says nothing about the account; Curviate detects it on the account's next read or connect.
                          * @enum {string}
@@ -31199,16 +31196,31 @@ declare class AuthResource {
      * account) rather than connecting a brand-new one; it is absent on a normal
      * connect.
      *
-     * Connection scope (which LinkedIn products are enabled: classic, company,
-     * a premium tier) is **seat-derived**: there is no products input on this
-     * body, and the recorded scope is readable back as `requested_products` on
-     * the account (`accounts.list()` / `accounts.get()`). A reconnect that
-     * would change scope must use `auth_method: "credentials"`, since a cookie
-     * replay cannot change scope and throws `CurviateError(code:
-     * "REAUTH_REQUIRED")` instead. A seat resolving to both individual-Premium
-     * tiers at once throws `CurviateError(code: "PREMIUM_CONFLICT")` (LinkedIn
-     * permits only one per profile). Pin a managed proxy with the optional
-     * `country`/`ip`, or supply `proxy` to override it entirely.
+     * Connection scope (which LinkedIn products are enabled) is not something
+     * you enumerate and it is NOT derived from the seat: the connect asks for
+     * every product (classic, company, sales_navigator, recruiter) and LinkedIn
+     * activates whichever ones the account actually holds. The recorded scope is
+     * readable back as `requested_products` on the account
+     * (`accounts.list()` / `accounts.get()`), and it is what was ASKED for, not
+     * proof of attachment.
+     *
+     * `linkedin_premium` (`"sales_navigator"` | `"recruiter"`) is the one
+     * optional narrowing. A LinkedIn account can hold only one of the two
+     * premium surfaces, and when both are asked for Sales Navigator wins, so set
+     * it to `"recruiter"` for an account that holds both and needs the Recruiter
+     * surface. **It applies to this connection only and is never remembered**:
+     * a later connect or reconnect that omits it widens the scope back to every
+     * product, so state it on every call where Recruiter must win. There is no
+     * account-level premium preference to set once.
+     *
+     * A reconnect that would change scope must use `auth_method: "credentials"`,
+     * since a cookie replay cannot change scope and throws
+     * `CurviateError(code: "REAUTH_REQUIRED")` instead. Asking for a premium the
+     * LinkedIn account does not hold throws
+     * `CurviateError(code: "LINKEDIN_FEATURE_NOT_SUBSCRIBED")` (403); the remedy
+     * is to activate the subscription on LinkedIn or to point `linkedin_premium`
+     * at the premium the account really has. Pin a managed proxy with the
+     * optional `country`/`ip`, or supply `proxy` to override it entirely.
      */
     intent(body: AuthIntentBody): Promise<AuthIntentResult>;
     /**
@@ -32072,7 +32084,9 @@ declare class FeedResource {
 }
 
 /**
- * Inboxes resource, 2 methods (Beta).
+ * Inboxes resource.
+ *
+ * @beta Every operation in this namespace is beta.
  *
  * Account-scoped: the bound context injects `account_id` as the leading
  * `/v1/` path segment on every request (account-first grammar), never a
@@ -32130,6 +32144,10 @@ declare class InboxesResource {
      * const companyPage = (items ?? []).find((i) => i.kind === "company");
      * console.log(companyPage?.id, companyPage?.name, hint);
      * // companyPage?.id is what you pass to listChats(), e.g. "COMPANY_83734124_PRIMARY"
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     list(params?: InboxListQuery): Promise<InboxListPage>;
     /**
@@ -32160,6 +32178,10 @@ declare class InboxesResource {
      *   or `"COMPANY_83734124_PRIMARY"`).
      * @param params - optional `limit` (1-25, default 20) and an opaque
      *   `cursor` for pagination.
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     listChats(inboxId: string, params?: InboxChatListQuery): Promise<InboxChatListPage>;
 }
@@ -32260,7 +32282,25 @@ declare class NotificationsResource {
 }
 
 /**
- * Sales Navigator resource: 12 methods (tier: sn).
+ * Sales Navigator resource.
+ *
+ * @beta Every operation in this namespace is beta. None of it has been
+ * exercised against a real LinkedIn Sales Navigator subscription yet, so
+ * response shapes may still move. While an operation is beta-GATED it refuses
+ * `BETA_NOT_ENABLED` (403) until a human enables beta for the tenant in
+ * Settings, or the request carries the `X-Curviate-Beta` header. The beta
+ * badge is a superset of the gate: a badged operation is not necessarily
+ * gated, so read the code on a refusal rather than inferring it from the
+ * badge.
+ *
+ * NO CURVIATE-SIDE ENTITLEMENT. There is no Sales Navigator product to buy
+ * from Curviate and no tier on a seat: one ordinary paid seat entitles every
+ * method here, and a tenant with no active seat covering the account refuses
+ * `NO_ACTIVE_SEAT` (403) exactly as it does on any other namespace. What this
+ * namespace does need is the LINKEDIN account's own Sales Navigator
+ * subscription; an account whose LinkedIn lacks it refuses
+ * `LINKEDIN_FEATURE_NOT_SUBSCRIBED` (403), and that remedy lives on LinkedIn,
+ * not in Curviate billing.
  *
  * Account-scoped: the bound context injects `account_id` as the leading
  * `/v1/` path segment on every request (account-first grammar), never a
@@ -32322,50 +32362,85 @@ declare class SalesNavigatorResource {
     /**
      * Search LinkedIn members using the full Sales Navigator filter set.
      * `POST /v1/{account_id}/sales-navigator/search/people`
-     * Requires tier `sn`. Returns `TIER_NOT_ACTIVE` (403) when the seat lacks it.
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     searchPeople(body: SNSearchPeopleBody, query?: Partial<SNSearchPeopleQuery>): Promise<SNSearchPeopleResult>;
     /**
      * Search LinkedIn companies using the full Sales Navigator company filter set.
      * `POST /v1/{account_id}/sales-navigator/search/companies`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     searchCompanies(body: SNSearchCompaniesBody, query?: Partial<SNSearchCompaniesQuery>): Promise<SNSearchCompaniesResult>;
     /**
      * Resolve human-readable terms to opaque Sales Navigator filter IDs.
      * `GET /v1/{account_id}/sales-navigator/search/parameters`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     getParameters(query: SNGetParametersQuery): Promise<SNGetParametersResult>;
     /**
      * Start a new Sales Navigator chat. `attachments[]`, when supplied, carry
      * base64-encoded file bytes, always sent as JSON, never multipart.
      * `POST /v1/{account_id}/sales-navigator/chats`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     startChat(body: SNStartChatBody): Promise<SNStartChatResult>;
     /**
      * Retrieve a LinkedIn profile with Sales Navigator enrichment.
      * `GET /v1/{account_id}/sales-navigator/profiles/{identifier}`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     getProfile(identifier: string, query?: Partial<SNGetProfileQuery>): Promise<SNGetProfileResult>;
     /**
      * List the saved-account (company) lists on the operator's Sales Navigator seat.
      * `GET /v1/{account_id}/sales-navigator/account-lists`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     accountLists(query?: Partial<SNAccountListsQuery>): Promise<SNAccountListsResult>;
     /**
      * List the saved-lead (member) lists on the operator's Sales Navigator seat.
      * `GET /v1/{account_id}/sales-navigator/lead-lists`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     leadLists(query?: Partial<SNLeadListsQuery>): Promise<SNLeadListsResult>;
     /**
      * Browse the saved accounts (companies) in one account list. Pass optional
      * `persona` / `filter` / `sort_by` / `sort_order` filters in the body.
      * `POST /v1/{account_id}/sales-navigator/account-lists/{list_id}`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     browseAccountList(listId: string, body?: SNBrowseAccountListBody, query?: Partial<SNBrowseAccountListQuery>): Promise<SNBrowseAccountListResult>;
     /**
      * Browse the saved leads (members) in one lead list. Pass optional
      * `spotlight` / `sort_by` / `sort_order` filters in the body.
      * `POST /v1/{account_id}/sales-navigator/lead-lists/{list_id}`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     browseLeadList(listId: string, body?: SNBrowseLeadListBody, query?: Partial<SNBrowseLeadListQuery>): Promise<SNBrowseLeadListResult>;
     /**
@@ -32375,12 +32450,20 @@ declare class SalesNavigatorResource {
      *
      * No `saved` boolean is invented; a `2xx` response body is the success
      * signal (the substrate returns no success flag).
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     saveAccount(input: SNSaveAccountInput): Promise<SNSaveAccountResult>;
     /**
      * Save a Sales Navigator member into a lead list. Body is just `{user_id}`;
      * `account_id` lives in the path, not the body.
      * `POST /v1/{account_id}/sales-navigator/lead-lists/{list_id}/save`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     saveLead(input: SNSaveLeadInput): Promise<SNSaveLeadResult>;
     /**
@@ -32388,12 +32471,33 @@ declare class SalesNavigatorResource {
      * `POST /v1/{account_id}/sales-navigator/search`
      * `url` is the only accepted body field. Response items are polymorphic,
      * each discriminated individually by its own `object`.
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     searchFromUrl(body: SNSearchFromUrlBody, query?: Partial<SNSearchFromUrlQuery>): Promise<SNSearchFromUrlResult>;
 }
 
 /**
- * Recruiter resource: 23 methods (tier: recruiter), project-centric rebuild.
+ * Recruiter resource, a project-centric rebuild.
+ *
+ * @beta Every operation in this namespace is beta. None of it has been
+ * exercised against a real LinkedIn Recruiter subscription yet, so response
+ * shapes may still move. While an operation is beta-GATED it refuses
+ * `BETA_NOT_ENABLED` (403) until a human enables beta for the tenant in
+ * Settings, or the request carries the `X-Curviate-Beta` header. The beta
+ * badge is a superset of the gate: a badged operation is not necessarily
+ * gated, so read the code on a refusal rather than inferring it from the
+ * badge.
+ *
+ * NO CURVIATE-SIDE ENTITLEMENT. There is no Recruiter product to buy from
+ * Curviate and no tier on a seat: one ordinary paid seat entitles every method
+ * here, and a tenant with no active seat covering the account refuses
+ * `NO_ACTIVE_SEAT` (403) exactly as it does on any other namespace. What this
+ * namespace does need is the LINKEDIN account's own Recruiter subscription; an
+ * account whose LinkedIn lacks it refuses `LINKEDIN_FEATURE_NOT_SUBSCRIBED`
+ * (403), and that remedy lives on LinkedIn, not in Curviate billing.
  *
  * Account-scoped: the bound context injects `account_id` as the leading
  * `/v1/` path segment on every request (account-first grammar), never a
@@ -32472,23 +32576,39 @@ declare class RecruiterResource {
      * target's public identifier, or a member id. Request specific profile
      * sections via `with_sections` (repeatable query param).
      * `GET /v1/{account_id}/recruiter/profiles/{user_id}`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     getProfile(identifier: string, params?: Partial<RecruiterGetProfileQuery>): Promise<RecruiterGetProfileResult>;
     /**
      * Start a Recruiter chat (InMail). JSON-only, `subject` and `signature`
      * are REQUIRED; optional attachments ride the body as base64-encoded
      * objects (no multipart). `POST /v1/{account_id}/recruiter/chats`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     startChat(body: RecruiterStartChatBody): Promise<RecruiterStartChatResult>;
     /**
      * Search LinkedIn members using Recruiter filters. `limit`/`cursor` stay
      * TOP-LEVEL query params. `POST /v1/{account_id}/recruiter/search/people`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     searchPeople(body: RecruiterSearchPeopleBody, params?: Partial<RecruiterSearchPeopleQuery>): Promise<RecruiterSearchPeopleResult>;
     /**
      * Resolve human-readable terms to opaque Recruiter filter ids. POST (was
      * GET): the body is a `source`-discriminated oneOf, `APPLICANTS`/`PIPELINE`
      * require `project_id`. `POST /v1/{account_id}/recruiter/search/parameters`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     searchParameters(body: RecruiterSearchParametersBody, params?: Partial<RecruiterSearchParametersQuery>): Promise<RecruiterSearchParametersResult>;
     /**
@@ -32496,6 +32616,10 @@ declare class RecruiterResource {
      * `RECRUITER_SEARCH` talent-pool channel) is REQUIRED. `limit`/`cursor` stay
      * TOP-LEVEL query params.
      * `POST /v1/{account_id}/recruiter/projects/{project_id}/talent-pool/search`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     searchTalentPool(projectId: string, body: RecruiterSearchTalentPoolBody, params?: Partial<RecruiterSearchTalentPoolQuery>): Promise<RecruiterSearchTalentPoolResult>;
     /**
@@ -32503,22 +32627,38 @@ declare class RecruiterResource {
      * nothing else in the body. The response is a 3-way oneOf (people-search,
      * job-applicant list, or pipeline-candidate list) keyed by the URL kind.
      * `POST /v1/{account_id}/recruiter/search`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     searchFromUrl(body: RecruiterSearchFromUrlBody, params?: Partial<RecruiterSearchFromUrlQuery>): Promise<RecruiterSearchFromUrlResult>;
     /**
      * List Recruiter hiring projects visible to the account.
      * `GET /v1/{account_id}/recruiter/projects`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     listProjects(params?: Partial<RecruiterListProjectsQuery>): Promise<RecruiterListProjectsResult>;
     /**
      * Get a single Recruiter hiring project (owner, metadata, talent_pool,
      * pipeline). `GET /v1/{account_id}/recruiter/projects/{project_id}`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     getProject(projectId: string): Promise<RecruiterGetProjectResult>;
     /**
      * Edit a Recruiter project's config: all fields optional; omitted fields
      * are left unchanged. Returns a thin acknowledgement only.
      * `PATCH /v1/{account_id}/recruiter/projects/{project_id}`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     updateProject(projectId: string, body: RecruiterUpdateProjectBody): Promise<RecruiterUpdateProjectResult>;
     /**
@@ -32526,35 +32666,59 @@ declare class RecruiterResource {
      * an all-optional filter set, no state mutates). `limit`/`cursor` stay
      * TOP-LEVEL query params.
      * `POST /v1/{account_id}/recruiter/projects/{project_id}/pipeline`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     listPipeline(projectId: string, body?: RecruiterListPipelineBody, params?: Partial<RecruiterListPipelineQuery>): Promise<RecruiterListPipelineResult>;
     /**
      * Get the single job posting attached to a Recruiter project (the surface
      * returns one posting, not a list; a project with no attached job 404s).
      * `GET /v1/{account_id}/recruiter/projects/{project_id}/jobs`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     getProjectJob(projectId: string): Promise<RecruiterProjectJob>;
     /**
      * Create a job-posting DRAFT attached to an EXISTING project, `project_name`
      * is not accepted (the project comes from the path). Never publishes, never
      * spends money. `POST /v1/{account_id}/recruiter/projects/{project_id}/jobs`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     createProjectJob(projectId: string, body: RecruiterCreateProjectJobBody): Promise<RecruiterCreateProjectJobResult>;
     /**
      * Get pricing to publish a project's job posting; price a publish before
      * committing any money.
      * `GET /v1/{account_id}/recruiter/projects/{project_id}/jobs/{job_id}/budget`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     getProjectJobBudget(projectId: string, jobId: string): Promise<RecruiterProjectJobBudget>;
     /**
      * Create a job-posting DRAFT together with a brand-new hiring project,
      * `project_name` is REQUIRED; `description` must be >= 200 characters. Never
      * publishes, never spends money. `POST /v1/{account_id}/recruiter/jobs`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     createJob(body: RecruiterCreateJobBody): Promise<RecruiterCreateJobResult>;
     /**
      * List Recruiter job postings. `limit`/`cursor` stay TOP-LEVEL query params.
      * `GET /v1/{account_id}/recruiter/jobs`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     listJobs(params?: Partial<RecruiterListJobsQuery>): Promise<RecruiterListJobsResult>;
     /**
@@ -32567,6 +32731,10 @@ declare class RecruiterResource {
      * client-side; the wire request always carries the numeric id. Throws
      * `CurviateError({ code: 'INVALID_REQUEST' })` synchronously if neither
      * form can be recognized.
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     getJob(jobIdOrUrl: string): Promise<RecruiterJobDetail>;
     /**
@@ -32574,6 +32742,10 @@ declare class RecruiterResource {
      * change. MONEY WARNING: editing an already-published (LISTED) posting
      * mutates a live, money-spending listing.
      * `PATCH /v1/{account_id}/recruiter/projects/{project_id}/jobs/{job_id}`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     updateProjectJob(projectId: string, jobId: string, body: RecruiterUpdateProjectJobBody): Promise<RecruiterUpdateProjectJobResult>;
     /**
@@ -32583,6 +32755,10 @@ declare class RecruiterResource {
      * the connected account's LinkedIn payment method; supplying `budget` IS the
      * explicit opt-in).
      * `POST /v1/{account_id}/recruiter/projects/{project_id}/jobs/{job_id}/publish`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     publishJob(projectId: string, jobId: string, body: RecruiterPublishJobBody): Promise<RecruiterPublishJobResult>;
     /**
@@ -32590,12 +32766,20 @@ declare class RecruiterResource {
      * (bodyless). Closing an already-published (LISTED) posting cannot be
      * undone; there is no re-open operation.
      * `POST /v1/{account_id}/recruiter/projects/{project_id}/jobs/{job_id}/close`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     closeJob(projectId: string, jobId: string): Promise<RecruiterCloseJobResult>;
     /**
      * Save a candidate (or user profile) to a project's pipeline at the given
      * stage, the sole surviving pipeline write.
      * `POST /v1/{account_id}/recruiter/projects/{project_id}/pipeline/candidate/save`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     saveCandidate(projectId: string, body: RecruiterSaveCandidateBody): Promise<RecruiterSaveCandidateResult>;
     /**
@@ -32603,17 +32787,29 @@ declare class RecruiterResource {
      * filters, no state mutates). `channel_id` (a `JOB_POSTING` talent-pool
      * channel) is REQUIRED. `limit`/`cursor` stay TOP-LEVEL query params.
      * `POST /v1/{account_id}/recruiter/projects/{project_id}/talent-pool/applicants`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     listApplicants(projectId: string, body: RecruiterListApplicantsBody, params?: Partial<RecruiterListApplicantsQuery>): Promise<RecruiterListApplicantsResult>;
     /**
      * Get full detail for one talent-pool applicant (profile guaranteed full,
      * includes PII). `GET /v1/{account_id}/recruiter/projects/{project_id}/talent-pool/applicants/{applicant_id}`
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     getApplicant(projectId: string, applicantId: string): Promise<RecruiterGetApplicantResult>;
     /**
      * Download a talent-pool applicant's résumé as raw binary.
      * `GET /v1/{account_id}/recruiter/projects/{project_id}/talent-pool/applicants/{applicant_id}/resume`
      * Returns `ArrayBuffer`; the SDK does not cache or store it.
+     *
+     * @beta Beta operation. See the namespace note above: while beta-gated it
+     * refuses `BETA_NOT_ENABLED` (403) until a human enables beta in Settings,
+     * or the request carries the `X-Curviate-Beta` header.
      */
     downloadResume(projectId: string, applicantId: string): Promise<ArrayBuffer>;
 }
@@ -32879,6 +33075,11 @@ declare class CompaniesResource {
      * never stored. Beta: single-page listing and termination are verified;
      * deep pagination (many pages / large cursor round-trips) is provisional
      * until validated against a busier inbox.
+     *
+     * @beta Beta operation. While beta-gated it refuses `BETA_NOT_ENABLED`
+     * (403) until a human enables beta in Settings, or the request carries the
+     * `X-Curviate-Beta` header. Sibling methods on this namespace are stable;
+     * the badge is per operation.
      */
     chats(identifier: string, params?: CompanyChatListQuery): Promise<CompanyChatListPage>;
     /**
@@ -32911,6 +33112,11 @@ declare class CompaniesResource {
      * and message content), a `topic` card, or `unread`-only; the three are
      * mutually exclusive and enforced server-side. The connected account must
      * administer the page. Beta: see `chats()`.
+     *
+     * @beta Beta operation. While beta-gated it refuses `BETA_NOT_ENABLED`
+     * (403) until a human enables beta in Settings, or the request carries the
+     * `X-Curviate-Beta` header. Sibling methods on this namespace are stable;
+     * the badge is per operation.
      */
     searchChats(identifier: string, params?: CompanyChatSearchQuery): Promise<CompanyChatSearchPage>;
     /**
@@ -33135,13 +33341,41 @@ declare class Curviate {
  * This mirrors the server's error taxonomy (the customer-observable subset).
  * The string literals are copied here intentionally; the SDK has no dependency
  * on any private package. Internal-only codes that never reach a caller (e.g.
- * `BANNED_ENV_PREFIX`, `ADMIN_BYPASS`, protected-account and substrate-internal
- * codes) are deliberately excluded.
+ * `BANNED_ENV_PREFIX`, protected-account and substrate-internal codes) are
+ * deliberately excluded.
+ *
+ * The test for "does a caller ever see it" is the DECODE PATH, not intuition:
+ * a code returned by any `/v1` route, the `/v1` catch-all, or a shared handler
+ * one of them calls reaches this transport, and anything missing from this
+ * array is erased to `INTERNAL` on the way out. Twenty-one codes were in that
+ * position and are now carried (see the block at the end of the array).
+ * `ADMIN_BYPASS` was even cited here as an example of an unreachable code
+ * while being constructed at nine sites inside the versioned billing
+ * endpoints, which is exactly the mistake the decode-path test avoids.
+ *
+ * What remains excluded are codes with no request to answer at all: the
+ * boot-time environment refusal (`BANNED_ENV_PREFIX`, raised before the
+ * process serves anything) and the browser-approval exchange the CLI's own
+ * `setup` command consumes directly, which is not on the documented REST
+ * surface and no SDK method reaches.
+ *
+ * The taxonomy tracks what deployments can actually emit, which is not the same
+ * as what the newest one emits. A code the API has stopped returning is removed
+ * eventually, because a dead code in the union tells a caller to branch on
+ * something that cannot arrive, but not in the release that stops returning
+ * it, because a client is pointed at a deployment, not at a changelog. Removing
+ * a code the caller's deployment still sends is worse than carrying a dead one:
+ * the refusal arrives as `INTERNAL` and reads as a server fault.
  *
- * The taxonomy is additive-only: new codes may be appended, existing ones are
- * never removed or renamed.
+ * So a retirement is two steps. First `@deprecated`, kept exported, with the
+ * replacement named. Then removed, in the first release after every deployment
+ * carries the new contract. `TIER_NOT_ACTIVE` and `PREMIUM_CONFLICT` took step
+ * one in 0.30.0 and step two in 0.31.0.
+ *
+ * A code the API NEVER emitted is a different case and goes immediately, since
+ * no deployment can be sending it: `RATE_LIMITED` went that way in 0.30.0.
  */
-declare const ERROR_CODES: readonly ["UNAUTHORIZED", "INVALID_REQUEST", "UNSUPPORTED_MEDIA_TYPE", "PAYLOAD_TOO_LARGE", "ACCOUNT_NOT_FOUND", "ACCOUNT_RESTRICTED", "ACCOUNT_ALREADY_LINKED", "RESOURCE_NOT_FOUND", "NOT_STORED", "RESOURCE_ACCESS_RESTRICTED", "FILTER_CANDIDATES_REQUIRED", "TIER_NOT_ACTIVE", "LINKEDIN_FEATURE_NOT_SUBSCRIBED", "RATE_LIMIT_ACCOUNT", "RATE_LIMIT_TENANT", "PLATFORM_RATE_LIMIT", "RATE_LIMITED", "BUDGET_EXHAUSTED", "PLATFORM_ERROR", "PLATFORM_NOT_IMPLEMENTED", "LINKEDIN_OPERATION_NOT_SUPPORTED", "CHECKPOINT_NOT_FOUND", "CHECKPOINT_EXPIRED", "CHECKPOINT_INVALID_CODE", "CHECKPOINT_MAX_ATTEMPTS", "CHECKPOINT_ALREADY_RESOLVED", "CHECKPOINT_UNSUPPORTED", "CONNECTION_IN_PROGRESS", "PREMIUM_CONFLICT", "REAUTH_REQUIRED", "LINKEDIN_AUTH_FAILED", "LINKEDIN_SESSION_EVICTED", "LINKEDIN_RATE_LIMITED", "LINKEDIN_COOKIE_INVALID", "LINKEDIN_SERVICE_UNAVAILABLE", "MESSAGE_WINDOW_EXPIRED", "RECIPIENT_UNREACHABLE", "CONNECTION_REQUEST_CONFLICT", "PAYMENT_REQUIRED", "PAYMENT_FAILED", "SUBSCRIPTION_BUSY", "SUBSCRIPTION_NOT_FOUND", "SEAT_NOT_FOUND", "SEAT_CANCELLED", "INTERNAL"];
+declare const ERROR_CODES: readonly ["UNAUTHORIZED", "INVALID_REQUEST", "UNSUPPORTED_MEDIA_TYPE", "PAYLOAD_TOO_LARGE", "ACCOUNT_NOT_FOUND", "ACCOUNT_RESTRICTED", "ACCOUNT_ALREADY_LINKED", "RESOURCE_NOT_FOUND", "NOT_STORED", "RESOURCE_ACCESS_RESTRICTED", "FILTER_CANDIDATES_REQUIRED", "NO_ACTIVE_SEAT", "LINKEDIN_FEATURE_NOT_SUBSCRIBED", "BETA_NOT_ENABLED", "RATE_LIMIT_ACCOUNT", "RATE_LIMIT_TENANT", "PLATFORM_RATE_LIMIT", "BUDGET_EXHAUSTED", "PLATFORM_ERROR", "PLATFORM_NOT_IMPLEMENTED", "LINKEDIN_OPERATION_NOT_SUPPORTED", "CHECKPOINT_NOT_FOUND", "CHECKPOINT_EXPIRED", "CHECKPOINT_INVALID_CODE", "CHECKPOINT_MAX_ATTEMPTS", "CHECKPOINT_ALREADY_RESOLVED", "CHECKPOINT_UNSUPPORTED", "CONNECTION_IN_PROGRESS", "REAUTH_REQUIRED", "LINKEDIN_AUTH_FAILED", "LINKEDIN_SESSION_EVICTED", "LINKEDIN_RATE_LIMITED", "LINKEDIN_COOKIE_INVALID", "LINKEDIN_SERVICE_UNAVAILABLE", "MESSAGE_WINDOW_EXPIRED", "RECIPIENT_UNREACHABLE", "CONNECTION_REQUEST_CONFLICT", "PAYMENT_REQUIRED", "PAYMENT_FAILED", "SUBSCRIPTION_BUSY", "SUBSCRIPTION_NOT_FOUND", "SEAT_NOT_FOUND", "SEAT_CANCELLED", "NOT_FOUND", "REACTION_NOT_FOUND", "SUBSTRATE_LINK_FAILED", "SUBSTRATE_CAP_REACHED", "BILLING_CHECKOUT_FAILED", "BILLING_PORTAL_UNAVAILABLE", "ACCOUNT_DISPUTED", "ACCOUNT_LINKING_DISABLED", "PERIOD_LOCKED", "SEAT_NOT_EMPTY", "SEAT_PROVISIONAL", "SUBSCRIPTION_ALREADY_EXISTS", "ALREADY_CANCELLED", "CANCELLATION_ALREADY_EFFECTIVE", "INVALID_CANCELLATION_SOURCE", "TRIAL_EXPIRED", "TRIAL_SEAT_LIMIT", "TRIAL_ACTIVE_SEAT_LIMIT", "TRIAL_IDENTITY_ALREADY_USED", "TRIAL_IDENTITY_UNRESOLVED", "ADMIN_BYPASS", "STRIPE_DRIFT_DETECTED", "INTERNAL"];
 /**
  * The complete set of error codes observable by API callers.
  *
@@ -33149,24 +33383,6 @@ declare const ERROR_CODES: readonly ["UNAUTHORIZED", "INVALID_REQUEST", "UNSUPPO
  * `switch (error.code)` without fear of unknown codes.
  */
 type ErrorCode = (typeof ERROR_CODES)[number];
-/**
- * The tiers a caller can be asked to upgrade to, surfaced on `TIER_NOT_ACTIVE`.
- * `sn` and `sales_nav` are both emitted by the API (internal flag key vs.
- * product-facing label).
- *
- * Single source of truth, mirroring {@link ERROR_CODES}: both the
- * {@link RequiredTier} type and the runtime {@link KNOWN_REQUIRED_TIERS}
- * membership set are derived from this one array, so the type a caller
- * narrows on and the set the transport validates a wire value against can
- * never drift apart.
- */
-declare const REQUIRED_TIERS: readonly ["core", "sn", "sales_nav", "recruiter"];
-/**
- * The product tier a caller needs, surfaced on `TIER_NOT_ACTIVE` so an agent
- * can route an upgrade without parsing the message. `sn` and `sales_nav` are
- * both emitted by the API (internal flag key vs. product-facing label).
- */
-type RequiredTier = (typeof REQUIRED_TIERS)[number];
 /** Structured retry guidance attached to retryable errors. */
 interface RetryHint {
     kind: "delay" | "backoff" | "never";
@@ -33207,8 +33423,6 @@ interface CurviateErrorInit {
     retryHint?: RetryHint | null;
     userFixable: boolean;
     retryLikelyToSucceed: boolean;
-    /** Present on `TIER_NOT_ACTIVE` only. */
-    requiredTier?: RequiredTier;
     /** Milliseconds to wait before retry, parsed from the `Retry-After` response header. */
     retryAfterMs?: number;
     /**
@@ -33281,7 +33495,6 @@ interface CurviateErrorJSON {
     retryHint: RetryHint | null;
     userFixable: boolean;
     retryLikelyToSucceed: boolean;
-    requiredTier?: RequiredTier;
     retryAfterMs?: number;
     budgetRow?: string;
     retryAfterSeconds?: number;
@@ -33309,7 +33522,6 @@ declare class CurviateError extends Error {
     readonly retryHint: RetryHint | null;
     readonly userFixable: boolean;
     readonly retryLikelyToSucceed: boolean;
-    readonly requiredTier: RequiredTier | undefined;
     readonly retryAfterMs: number | undefined;
     /** The budget row this response names. See {@link CurviateErrorInit.budgetRow}. */
     readonly budgetRow: string | undefined;
@@ -33619,4 +33831,4 @@ interface ConstructEventOptions {
  */
 declare function constructEvent(rawBody: string | Buffer, signatureHeader: string, secret: string, opts?: ConstructEventOptions): Promise<CurviateEvent>;
 
-export { type AccountListPage, type AccountListParams, type AccountPayload, type AccountScopedNamespaces, type ConnectionPayload, type ConstructEventOptions, Curviate, type CurviateConfig, CurviateError, type CurviateErrorInit, type CurviateErrorJSON, type CurviateEvent, type CurviateEventEnvelope, ERROR_CODES, type ErrorCode, type EventPayloadBase, type MessagePayload, type RequiredTier, type ResolvedConfig, type ResourceNamespaces, type RetryHint, type SafetyHint, type SafetyReason, WebhookSignatureError, type components, constructEvent, isCurviateError, type operations, type paths };
+export { type AccountListPage, type AccountListParams, type AccountPayload, type AccountScopedNamespaces, type ConnectionPayload, type ConstructEventOptions, Curviate, type CurviateConfig, CurviateError, type CurviateErrorInit, type CurviateErrorJSON, type CurviateEvent, type CurviateEventEnvelope, ERROR_CODES, type ErrorCode, type EventPayloadBase, type MessagePayload, type ResolvedConfig, type ResourceNamespaces, type RetryHint, type SafetyHint, type SafetyReason, WebhookSignatureError, type components, constructEvent, isCurviateError, type operations, type paths };