@signa-so/sdk 0.17.0 → 0.21.0

package/dist/generated/api-types.d.ts

@@ -384,7 +384,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** @description List the office event codes Signa has catalogued and the canonical `event_type` each maps to. The catalogue covers IP Australia (`AU`) and WIPO (`WO`) today; any other office returns an empty list, and its trademark events still carry their own `raw` code and label. `raw` is the office's verbatim code and label, as on a trademark event's `raw` (label null when we hold no verbatim office label for the code; every WIPO label is null because the catalogue's WIPO wording is Signa's). */
+        /** @description List the office event codes Signa has catalogued and the canonical `event_type` each maps to. The catalogue covers the USPTO (`US`), IP Australia (`AU`) and WIPO (`WO`) today; any other office returns an empty list, and its trademark events still carry their own `raw` code and label. `raw` is the office's verbatim code and label, as on a trademark event's `raw` (label null when we hold no verbatim office label for the code; every WIPO label is null because the catalogue's WIPO wording is Signa's). */
         get: operations["listEventTypes"];
         put?: never;
         post?: never;
@@ -891,7 +891,7 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * @description List related owners via GLEIF corporate hierarchy (parent/child relationships).
+         * @description List related owners via the GLEIF corporate hierarchy (parent/child relationships) of the `lei` GET /v1/owners/{id} shows: the owner's own first GLEIF LEI, else its entity's.
          *
          *     Credits: 1 per page.
          */
@@ -1164,7 +1164,7 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * @description List proceedings across all trademarks. At least one filter is required.
+         * @description List proceedings across all trademarks. At least one filter is required. Proceedings are served only for offices whose `capabilities.proceedings` on `GET /v1/offices` is `available`; an `office_code` naming any other live office returns 422 `capability_not_available` without running a query or charging credits.
          *
          *     Credits: 1 per page.
          */
@@ -1185,7 +1185,7 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * @description Retrieve a single proceeding by ID, including parent trademark summary.
+         * @description Retrieve a single proceeding by ID, including parent trademark summary. A proceeding on a mark of an office whose `capabilities.proceedings` is not `available` is not served (404).
          *
          *     Credits: 1 per record.
          */
@@ -1924,7 +1924,7 @@ export interface paths {
         get: operations["listWebhookEndpoints"];
         put?: never;
         /**
-         * @description Create a webhook endpoint. The signing secret is returned ONCE in the response — store it securely and verify HMAC signatures against it. Subsequent GET responses redact the secret. trademark.status_changed and office_action.issued are emitted only for marks in an organization portfolio; alert.created follows watch scope. An organization that monitors a mark only through watches receives alert.created, but no direct trademark event.
+         * @description Create a webhook endpoint. The signing secret is returned ONCE in the response. Store it securely and verify HMAC signatures against it. Subsequent GET responses redact the secret. trademark.status_changed, trademark.corrected and office_action.issued are emitted only for marks in an organization portfolio; alert.created follows watch scope. An organization that monitors a mark only through watches receives alert.created, but no direct trademark event. An endpoint subscribed to trademark.status_changed also receives trademark.corrected, a correction of a status Signa published earlier.
          *
          *     This operation requires an `Idempotency-Key` header (see parameter description for 24h replay and 409-conflict semantics).
          *
@@ -1957,7 +1957,7 @@ export interface paths {
         options?: never;
         head?: never;
         /**
-         * @description Update a webhook endpoint. trademark.status_changed and office_action.issued are emitted only for marks in an organization portfolio; alert.created follows watch scope. An organization that monitors a mark only through watches receives alert.created, but no direct trademark event.
+         * @description Update a webhook endpoint. trademark.status_changed, trademark.corrected and office_action.issued are emitted only for marks in an organization portfolio; alert.created follows watch scope. An organization that monitors a mark only through watches receives alert.created, but no direct trademark event. An endpoint subscribed to trademark.status_changed also receives trademark.corrected, a correction of a status Signa published earlier.
          *
          *     This operation requires an `Idempotency-Key` header (see parameter description for 24h replay and 409-conflict semantics).
          *
@@ -2422,7 +2422,7 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * @description Change the organization's live subscription to another plan or billing interval. Internal (dashboard BFF); requires organization:manage. An upgrade (or a longer interval) is invoiced now with proration and applied only once that invoice is paid — a declined payment leaves the current plan in place and returns the invoice to pay (`pending_payment`). A downgrade (or a shorter interval) is scheduled for the end of the current period (`scheduled`). Organizations without a live subscription subscribe through POST /v1/organization/billing/checkout instead.
+         * @description Change the organization's live subscription to another plan or billing interval. Internal (dashboard BFF); requires organization:manage. An upgrade (or a longer interval) is invoiced now with proration and applied only once that invoice is paid — a declined payment leaves the current plan in place and returns the invoice to pay (`pending_payment`). A downgrade (or a shorter interval) is scheduled for the end of the current period (`scheduled`). While a change made here is scheduled, requesting the current plan and interval undoes it (`applied`, nothing is charged), another period-end change replaces it, an upgrade is refused until it is undone, and repeating it answers the same `scheduled`. With `undo_scheduled_change`, the request only ever undoes that change and is refused once it is no longer pending. Organizations without a live subscription subscribe through POST /v1/organization/billing/checkout instead.
          *
          *     This operation requires an `Idempotency-Key` header (see parameter description for 24h replay and 409-conflict semantics).
          */
@@ -2636,6 +2636,29 @@ export interface components {
              */
             formatted: string | null;
         } | null;
+        DerivedTerm: {
+            /**
+             * @description Where the term on record stands at `as_of_date`. `in_term`: the term runs to `derived.expiry_date`, and its renewal is not past due (the due date itself, moved off a weekend or holiday, is still on time). `in_grace`: the term ended and the renewal can still be filed late, until `grace_expiry_date`. `in_restoration`: the grace period passed and the jurisdiction's restoration window is open, until `restoration_expiry_date`. `renewal_not_on_record`: the term end the office stated, its grace period and any restoration window have passed with no renewal of that term on record, so no later term is computed. The mark may have lapsed, or a renewal may not have reached the office record or Signa yet; `status` stays what the office reports. `not_applicable`: no registered term to assess: an application or another status that is not registered (`unknown` included), a dead mark, a record with no renewal rule (a US designation under the Madrid Protocol, renewed at WIPO), or no schedule computed. An `expired` mark is assessed only while it can still be renewed or restored, a `cancelled` one only while it can be restored. Treat the vocabulary as open.
+             * @example in_term
+             * @enum {string}
+             */
+            state: "in_term" | "in_grace" | "in_restoration" | "renewal_not_on_record" | "not_applicable";
+            /**
+             * @description The last day of the grace period of the term ending at `derived.expiry_date`, as its renewal row serves it. Null when `state` is `not_applicable`.
+             * @example 2035-07-20
+             */
+            grace_expiry_date: string | null;
+            /**
+             * @description The last day of the restoration window after that grace period, once the term has ended (`state` is `in_grace` or later), where the jurisdiction provides one (for example GB, EU, SG, JP, IN, IS). Null otherwise.
+             * @example null
+             */
+            restoration_expiry_date: string | null;
+            /**
+             * @description Whether a renewal on record began the term ending at `derived.expiry_date`, that is, renewed the term before it: the office states a term end past the first term, the office recorded that renewal (for the USPTO, accepted the renewal filing), or, for a Madrid designation, WIPO published an expiry for the international registration in a later term. False for the first term after registration, for a term computed on the statutory ladder with no renewal of the term before it on record (a renewal of an earlier term does not count), and when `state` is `not_applicable`.
+             * @example true
+             */
+            renewed: boolean;
+        };
         UnsupportedDeadlineRule: {
             /**
              * @description Slug of the declined rule. Same identity as `rule_id` on a computed row: join it to `GET /v1/deadline-rules` for the rule and its sources.
@@ -2661,7 +2684,7 @@ export interface components {
         };
         DeadlineRow: {
             /**
-             * @description Stable identity of this occurrence of the rule, unique within one trademark: `rule_id:cycle` (the statutory cycle, e.g. `us_renewal_s9:5`), or `rule_id:t<term>-<n>` (a cell on a fixed term grid) when the record has no statutory anchor date or the row is anchored on an office-stated expiry; `rule_id:1` for a rule that occurs once. A renewal or a date correction of a few days keeps the key.
+             * @description Stable identity of this occurrence of the rule, unique within one trademark: `rule_id:cycle` (the statutory cycle, e.g. `us_renewal_s9:5`), or `rule_id:t<term>-<n>` (a cell on a fixed term grid) when the record has no statutory anchor date or the row is anchored on an office-stated expiry; `rule_id:1` for a rule that occurs once; `rule_id:<action date>:<action code>` for a `post_registration_oa_response` row (one per office action, e.g. `uspto_post_registration_oa_response:2026-04-19:PRA8`). A renewal or a date correction of a few days keeps the key.
              * @example us_renewal_s9:5
              */
             occurrence_key: string;
@@ -2670,7 +2693,10 @@ export interface components {
              * @example us_renewal_s9
              */
             rule_id: string;
-            /** @example combined_renewal_and_use */
+            /**
+             * @description Deadline type: `renewal`, `declaration_of_use`, `combined_renewal_and_use`, `declaration_of_incontestability`, `restoration`, `international_renewal`, or `post_registration_oa_response` (USPTO: the response to a post-registration office action on a §8, §71 or §8+§9 filing, due six months from the action or at the end of the filing period, whichever is later; 37 CFR 2.163(b), 2.184(b)(1), 7.39(a)). New values may be added.
+             * @example combined_renewal_and_use
+             */
             type: string;
             /**
              * @description Rule jurisdiction (`WO` for the Madrid international renewal).
@@ -2680,7 +2706,7 @@ export interface components {
             /** @example 2025-01-20 */
             trigger_date: string;
             /**
-             * @description Which record date anchored the computation (filing_date, registration_date, grant_date, protection_grant_date, intl_registration_date), or reported_expiry / reported_renewal_due when the ladder is anchored on an office-stated date.
+             * @description Which record date anchored the computation (filing_date, registration_date, grant_date, protection_grant_date, intl_registration_date), reported_expiry / reported_renewal_due when the ladder is anchored on an office-stated date, or post_registration_action on a `post_registration_oa_response` row (the office action's date).
              * @example registration_date
              */
             trigger_field: string;
@@ -2712,6 +2738,11 @@ export interface components {
             is_optional: boolean;
             /** @example cancellation_and_expiration */
             consequence_if_missed: string;
+            /**
+             * @description Present only when the office record adds something the dates do not say. On a `post_registration_oa_response` row: the office action it answers (code and date), and any incomplete-response notice or missing filing history; when the record cannot settle the date, the row is served on the earliest defensible date and the note says to check TSDR. A post-registration action marked "no response required" with no response row to carry it is said on every row of the record while its petition period can run. When the office prosecution history could not be read, every row of the record says so here instead of reading as checked.
+             * @example PRA8 2026-04-19
+             */
+            note?: string;
         };
         DerivedOppositionWindow: {
             /** @enum {boolean} */
@@ -2771,10 +2802,11 @@ export interface components {
              */
             as_of_date: string;
             /**
-             * @description The rulebook's term end (the office-stated expiry when the office publishes one).
+             * @description The end of the term on record, before any weekend or holiday roll. Where the office publishes the expiry it is that date, moved forward only by a renewal on record: one the office recorded, or for a Madrid designation an expiry WIPO published for the international registration in a later term. Where the office publishes none (the USPTO) it is the statutory term end. Once an office-stated term has ended it stays here; `term.state` says whether it can still be renewed or restored, or that no renewal of it is on record. Null when no term applies (a dead mark once it can no longer be saved, a record with no renewal rule, or no schedule).
              * @example 2035-01-20
              */
             expiry_date: string | null;
+            term: components["schemas"]["DerivedTerm"];
             deadlines: {
                 /** @description False when no schedule could be computed; see `reason`. Mirrors POST /v1/deadlines/compute. */
                 supported: boolean;
@@ -2831,6 +2863,21 @@ export interface components {
                 /** @example /v1/trademarks/tm_7d4e1f2a-3b8c-4d0e-9f1a-2b3c4d5e6f70 */
                 href: string;
             } | null;
+            /**
+             * @description WIPO ST.3 code of the office that holds the designation record shown for this territory (the national office when Signa has its record, else WO).
+             * @example US
+             */
+            office_code: string | null;
+            /**
+             * @description That record's own application number at its office (for a US designation, the 79-series serial); null when the office states none.
+             * @example 79415041
+             */
+            application_number: string | null;
+            /**
+             * @description That record's own registration number at its office; null until registered or when the office states none.
+             * @example 7000001
+             */
+            registration_number: string | null;
         };
         DetailCoverageTerritory: components["schemas"]["CoverageTerritory"] & {
             /** @example United States of America */
@@ -3114,7 +3161,7 @@ export interface components {
             }[];
             has_media: boolean;
             /**
-             * @description Media-proxy URL for the primary mark image. Null when the mark has no media.
+             * @description Media-proxy URL for the primary mark image: the office-flagged image, else the first image. Always an image file, never a document, audio or video file. Null when the mark has no image.
              * @example https://api.signa.so/v1/trademarks/tm_abc/media/01234567-89ab-cdef-0123-456789abcdef
              */
             primary_image_url: string | null;
@@ -3156,6 +3203,14 @@ export interface components {
                 /** @example representative */
                 role: string;
                 address: components["schemas"]["Address"];
+                /**
+                 * @description On a Madrid international registration row: the designated territories whose record names this attorney, sorted. Empty when only the international registration itself names the attorney. Absent on other rows.
+                 * @example [
+                 *       "EU",
+                 *       "US"
+                 *     ]
+                 */
+                territory_codes?: string[];
             }[];
             text_variants: {
                 /** @example translation */
@@ -3424,7 +3479,7 @@ export interface components {
              */
             via: ("identifier" | "identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[];
             /**
-             * @description The mark_text operator values this hit satisfied, as the caller spelled them (operator order: is, word, starts_with, ends_with, contains, pattern). Empty when the request has no positive mark_text operator.
+             * @description With a q list: the q terms that reached this hit, in list order, as the caller spelled them. Otherwise the mark_text operator values this hit satisfied (operator order: is, word, starts_with, ends_with, contains, pattern). Empty when the request has neither.
              * @example []
              */
             terms: string[];
@@ -3438,16 +3493,32 @@ export interface components {
                  *     ]
                  */
                 lanes: string[];
-                /** @description The ranking factors applied to this hit's score. Under an explicit sort or a trademark-number q the length factor does not apply. */
+                /** @description The ranking factors applied to this hit's score. Under an explicit sort, a trademark-number q or a q list the length factor does not apply. */
                 factors: {
                     /** @example live_status */
                     factor: string;
                     /** @example 1.3 */
                     weight: number;
                 }[];
+                /** @description With a q list: each term that reached this hit, with its own tier and channels. */
+                terms?: {
+                    /** @example onyx */
+                    term: string;
+                    /**
+                     * @example identical
+                     * @enum {string|null}
+                     */
+                    tier: "identical" | "near_identical" | "similar" | "related" | null;
+                    /**
+                     * @example [
+                     *       "lookalike"
+                     *     ]
+                     */
+                    via: ("identifier" | "identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[];
+                }[];
             };
         };
-        /** @description Shape-identical to a /v1/trademarks summary row, minus relevance_score / match_explanation. */
+        /** @description Shape-identical to a /v1/trademarks summary row, minus relevance_score. */
         TrademarkSummaryV1: {
             /** @example tm_7d4e1f2a3b8c9d0e */
             id: string;
@@ -3609,7 +3680,7 @@ export interface components {
             }[];
             has_media: boolean;
             /**
-             * @description Media-proxy URL for the primary mark image. Null when the mark has no media.
+             * @description Media-proxy URL for the primary mark image: the office-flagged image, else the first image. Always an image file, never a document, audio or video file. Null when the mark has no image.
              * @example https://api.signa.so/v1/trademarks/tm_abc/media/01234567-89ab-cdef-0123-456789abcdef
              */
             primary_image_url: string | null;
@@ -3629,35 +3700,6 @@ export interface components {
              */
             relevance_score?: number | null;
             match?: components["schemas"]["TrademarkMatch"];
-            /** @description Deprecated (removed after the 90-day window): read `match`. Present on every hit when q is present; null for mark_text-only requests. */
-            match_explanation?: {
-                /**
-                 * @example [
-                 *       "exact",
-                 *       "fuzzy",
-                 *       "phonetic"
-                 *     ]
-                 */
-                strategies_matched: string[];
-                /**
-                 * @example [
-                 *       {
-                 *         "factor": "exact_match",
-                 *         "weight": 50
-                 *       },
-                 *       {
-                 *         "factor": "live_status",
-                 *         "weight": 1.3
-                 *       }
-                 *     ]
-                 */
-                boost_factors: {
-                    /** @example live_status */
-                    factor: string;
-                    /** @example 1.3 */
-                    weight: number;
-                }[];
-            } | null;
             /**
              * @description Search responses only: highlight fragments keyed by field name. Null when none were returned.
              * @example {
@@ -3669,13 +3711,6 @@ export interface components {
             highlights?: {
                 [key: string]: string[];
             } | null;
-            /**
-             * @description Deprecated (removed after the 90-day window): read `match.terms`. Present when the request has a positive mark_text operator.
-             * @example [
-             *       "limber"
-             *     ]
-             */
-            matched_terms?: string[];
         };
         ScreeningHit: {
             /** @enum {string} */
@@ -4469,6 +4504,12 @@ export interface components {
              * @enum {string}
              */
             citations: "available" | "in_progress" | "not_available" | "not_applicable";
+            /**
+             * @description Proceedings (oppositions, cancellations, appeals) availability. `available` = Signa ingests and serves this office's proceedings; `in_progress` = pipeline being built; `not_available` = Signa serves no proceedings for this office. `GET /v1/proceedings` returns proceedings only from `available` offices, and a request scoped by `office_code` to a live office that is not `available` returns 422 `capability_not_available` without running a query or charging credits.
+             * @example available
+             * @enum {string}
+             */
+            proceedings: "available" | "in_progress" | "not_available" | "not_applicable";
         };
         Office: {
             /** @example US */
@@ -4648,15 +4689,18 @@ export interface components {
             jurisdiction_code: string;
             /** @example Section 8 — Declaration of Use */
             name: string;
-            /** @example declaration_of_use */
+            /**
+             * @description Deadline type, the same vocabulary as `type` on computed rows. `post_registration_oa_response` is the USPTO response to a post-registration office action on a §8, §71 or §8+§9 filing.
+             * @example declaration_of_use
+             */
             type: string;
             /**
-             * @description Record date the rule is anchored on. For a `restoration` rule this is the parent renewal rule’s trigger — restoration is anchored off the renewal chain.
+             * @description Record date the rule is anchored on. For a `restoration` rule this is the parent renewal rule’s trigger — restoration is anchored off the renewal chain. For `post_registration_oa_response` it is `post_registration_action`, the date of the office action.
              * @example registration_date
              */
             trigger: string;
             /**
-             * @description Year of the term the rule falls due in. For a `restoration` rule this identifies the RENEWAL CYCLE the restoration attaches to (the cycle it rescues), not a restoration due date — the restoration window itself is given by `window_months` + `starts_from`.
+             * @description Year of the term the rule falls due in. For a `restoration` rule this identifies the RENEWAL CYCLE the restoration attaches to (the cycle it rescues), not a restoration due date — the restoration window itself is given by `window_months` + `starts_from`. 0 for `post_registration_oa_response`, which runs from an office action rather than a term year.
              * @example 6
              */
             due_year: number;
@@ -4682,7 +4726,7 @@ export interface components {
             /** @example 10 */
             renewal_period_years: number;
             /**
-             * @description Length of the restoration window in months. Non-null only on `type: "restoration"` rules.
+             * @description Length of the restoration window in months, or of the response period on a `post_registration_oa_response` rule (six months from the action, or to the end of the pre-grace filing period when that is later: 37 CFR 2.163(b), 2.184(b)(1), 7.39(a)). Null on every other rule.
              * @example null
              */
             window_months: number | null;
@@ -4796,7 +4840,7 @@ export interface components {
              */
             first_renewal_after_cutoff_opens_at_period_start: string | null;
             /**
-             * @description What a month- or year-counted period does when its end day does not exist in the target month (31 August + 6 months; 29 February + 1 year). `last_day` clamps to that month’s last day, the default and the behaviour of every office but Mexico. `first_business_day_of_following_month` runs the period into the next calendar month (MX, Reglamento LPI art. 4o, párrafo segundo). Applied to the due date and the grace expiry, never to `window_opens`. Like `holiday_calendar` and `grace_expiry_rolls_only`, this is resolved PER RULE: art. 4o is the designated office’s own convention, so a rule whose period belongs to the International Bureau reports `last_day` whatever its jurisdiction configures (Madrid Regulations Rule 4(1) and (2) clamp such a period to the month’s last day).
+             * @description What a month- or year-counted period does when its end day does not exist in the target month (31 August + 6 months; 29 February + 1 year). `last_day` clamps to that month’s last day, the default and the behaviour of every office but Mexico. `first_business_day_of_following_month` runs the period into the next calendar month (MX, Reglamento LFPPI art. 7, párrafo segundo). Applied to the due date and the grace expiry, never to `window_opens`. Like `holiday_calendar` and `grace_expiry_rolls_only`, this is resolved PER RULE: art. 7 is the designated office’s own convention, so a rule whose period belongs to the International Bureau reports `last_day` whatever its jurisdiction configures (Madrid Regulations Rule 4(1) and (2) clamp such a period to the month’s last day).
              * @example last_day
              * @enum {string}
              */
@@ -4863,6 +4907,12 @@ export interface components {
              * @enum {string}
              */
             window_starts_on: "date_of_publication" | "day_after" | "first_of_following_month";
+            /**
+             * @description When non-null, the CURRENT era’s window does not OPEN until the first day of the month after the publication month, although its close is still counted per `window_starts_on` (from the publication). Null for every rule but `cn_opposition_madrid`, whose window for a WIPO Gazette date on or after 2027-01-01 is provisional on CNIPA’s draft transitional measures: it opens on the later of two readings (the 1st of the following month) and closes on the earlier (two months from the publication).
+             * @example null
+             * @enum {string|null}
+             */
+            window_opens_on: "first_of_following_month" | null;
             /**
              * @description How the close is counted for the CURRENT era when it opens on the first of the following month with a month-based window. Null for every other rule AND for a rule that only opens that way in its earlier era — see `window_ends_on_before`.
              * @example null
@@ -4903,7 +4953,7 @@ export interface components {
              */
             window_ends_on_before: "corresponding_day_of_start" | "day_before_corresponding_day_of_start" | null;
             /**
-             * @description What a month-counted close date does when the publication's day number does not exist in the target month. `last_day` clamps to that month's last day, which is the default and what every office except Mexico does. `first_business_day_of_following_month` runs the period into the next calendar month and ends it on that month's first business day (Mexico, Reglamento LPI art. 4o, párrafo segundo). Never applies to a day-counted window.
+             * @description What a month-counted close date does when the publication's day number does not exist in the target month. `last_day` clamps to that month's last day, which is the default and what every office except Mexico does. `first_business_day_of_following_month` runs the period into the next calendar month and ends it on that month's first business day (Mexico, Reglamento LFPPI art. 7, párrafo segundo). Never applies to a day-counted window.
              * @example last_day
              * @enum {string}
              */
@@ -5306,25 +5356,10 @@ export interface components {
                 /** @example srch_abc123 */
                 search_id: string;
                 /**
-                 * @description Echo of the text query, or null for filter-only searches.
+                 * @description Echo of the text query, or null for filter-only searches and for a q list.
                  * @example SIGNA
                  */
                 query: string | null;
-                /**
-                 * @description Deprecated (removed after the 90-day window): read `similarity_applied`. The applied channels in the old strategy vocabulary.
-                 * @example [
-                 *       "exact",
-                 *       "fuzzy",
-                 *       "prefix"
-                 *     ]
-                 */
-                strategies_used: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
-                /**
-                 * @description Deprecated (removed after the 90-day window): the old `match` mode the request was translated from, else 'similar'.
-                 * @example similar
-                 * @enum {string}
-                 */
-                match: "similar" | "exact" | "starts_with" | "ends_with" | "contains";
                 /**
                  * @description The similarity channels q ran on (identical is always included). Empty without q.
                  * @example [
@@ -5387,7 +5422,7 @@ export interface components {
                     sunset: string;
                 }[];
                 /**
-                 * @description International registration presentation actually served. grouped = one row per mark/IR, coverage block present on IR rows; expanded = one row per Madrid designation.
+                 * @description International registration presentation actually served. grouped = one row per mark/IR, coverage block present on IR rows; expanded = one row per Madrid designation. A trademark number in q is served expanded: one row per record it names.
                  * @example grouped
                  * @enum {string}
                  */
@@ -5403,10 +5438,10 @@ export interface components {
                  * @enum {string}
                  */
                 territory_match: "protection" | "direct";
-                /** @description Coded search warnings: per-channel skip warnings (a REQUESTED similarity channel produced zero clauses for the query shape — e.g. similarity=phonetic on a query too short/high-collision), filter-coverage warnings (an applied filter, e.g. opposition_status or seniority_claims, has partial index coverage), `expanded_fallback` (a grouped request was served one row per record), and `result_window_reached` (the 10,000-row result window, not the data, ends this walk). Omitted when there is nothing to warn about. */
+                /** @description Coded search warnings: per-channel skip warnings (a REQUESTED similarity channel produced zero clauses for the query shape — e.g. similarity=phonetic on a query too short/high-collision), filter-coverage warnings (an applied filter, e.g. opposition_status or seniority_claims, has partial index coverage), `expanded_fallback` (a grouped request was served one row per record), `identifier_lookup` (q is a trademark number, served one row per record it names), and `result_window_reached` (the 10,000-row result window, not the data, ends this walk). Omitted when there is nothing to warn about. */
                 warnings?: {
                     /**
-                     * @description Stable warning code for client handling: `<channel>_skipped` (a requested similarity channel produced no clauses for this query; see `channel`), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `expanded_fallback` (a grouped request was served one row per record because the grouped view cannot serve a filter, sort or option; see `affected_filters` / `affected_option`), `result_window_reached` (more than 10,000 rows match and this page is the last one the 10,000-row result window lets a relevance or sorted walk reach), `mixed_script` (a mark_text operator value mixes Latin with Greek or Cyrillic letters, which the operators compare as written; see `affected_filter`).
+                     * @description Stable warning code for client handling: `<channel>_skipped` (a requested similarity channel produced no clauses for this query; see `channel`), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `expanded_fallback` (a grouped request was served one row per record because the grouped view cannot serve a filter, sort or option; see `affected_filters` / `affected_option`), `identifier_lookup` (`q` is a trademark number, so the response lists the records it names, one row per record), `result_window_reached` (more than 10,000 rows match and this page is the last one the 10,000-row result window lets a relevance or sorted walk reach), `mixed_script` (a mark_text operator value mixes Latin with Greek or Cyrillic letters, which the operators compare as written; see `affected_filter`).
                      * @example phonetic_skipped
                      */
                     code: string;
@@ -6091,30 +6126,33 @@ export interface components {
              * @example ent_a1b2c3d4
              */
             entity_id: string | null;
-            /** @description Whether the (possibly entity-inherited) company set includes an active SEC company with a ticker. */
+            /** @description Whether the owner's company links include an active SEC company with a ticker. For an owner linked to an entity, the entity's `publicly_traded`: any active SEC company with a ticker across members, or the entity itself is listed or a subsidiary of a listed company. */
             publicly_traded: boolean;
             /**
-             * @description First SEC ticker across the (possibly inherited) company set. null when none.
+             * @description The owner's own first SEC ticker. When it has none and is linked to an entity, the entity's `ticker`, which can be a ticker inherited from a listed ancestor. null when none.
              * @example AAPL
              */
             ticker: string | null;
             /**
-             * @description First GLEIF LEI across the (possibly inherited) company set. null when none.
+             * @description The owner's own first GLEIF LEI, uppercased. When it has none and is linked to an entity, the entity's `lei`: its own LEI when set, else the first GLEIF LEI across members. null when none.
              * @example HWUPKR0MPOU8FGXBT394
              */
             lei: string | null;
-            /** @description Whether any GLEIF LEI is present across the (possibly inherited) company set. */
+            /** @description Whether the owner's company links include a GLEIF LEI. For an owner linked to an entity, the entity's `has_lei`: its own LEI, or any GLEIF LEI across members. */
             has_lei: boolean;
             /**
-             * @description `entity` when company facts are inherited across entity members; `direct` for an unlinked singleton.
+             * @description `entity` when company facts are inherited across entity members; `direct` when the owner is not linked, or its entity is no longer served (GET /v1/entities/{id} returns 404), and the facts are its own links only.
              * @example entity
              * @enum {string}
              */
             companies_source: "entity" | "direct";
-            /** @example 1024 */
+            /**
+             * @description Distinct marks (mark grain): a Madrid IR and its designations count once, matching the default grouped trademark listings. 0 when stats are not yet computed.
+             * @example 1024
+             */
             trademark_count: number;
             /**
-             * @description Count of ACTIVE trademarks (registered + pending). Always present; 0 when stats are not yet computed. Same mark grain as trademark_count.
+             * @description Distinct marks (mark grain) that are registered or still in prosecution. Always present; 0 when stats are not yet computed.
              * @example 640
              */
             active_count: number;
@@ -6130,7 +6168,7 @@ export interface components {
                 identifier: string;
                 identifier_type: string;
             }[];
-            /** @description Omitted entirely when empty. When the owner is linked to an entity this is the union of all members' company links (served through the entity); the owner's own links are included. */
+            /** @description Omitted entirely when empty. When the owner is linked to an entity this is the union of all members' company links (served through the entity), the owner's own links first. */
             companies?: {
                 /** @example sec */
                 source: string;
@@ -6157,23 +6195,34 @@ export interface components {
                 verified_by?: string | null;
             }[];
             stats: {
+                /** @description Distinct marks (mark grain): a Madrid IR and its designations count once, matching the default grouped trademark listings. 0 when stats are not yet computed. */
                 trademark_count: number;
+                /** @description Office records (record grain) at this status stage. A Madrid IR counts once per designation record, so the status counts can sum to more than trademark_count. Records at a stage outside the five buckets (for example unknown or opposition_period) are counted in none. */
                 registered_count: number;
+                /** @description Office records (record grain) at this status stage. A Madrid IR counts once per designation record, so the status counts can sum to more than trademark_count. Records at a stage outside the five buckets (for example unknown or opposition_period) are counted in none. */
                 pending_count: number;
+                /** @description Office records (record grain) at this status stage. A Madrid IR counts once per designation record, so the status counts can sum to more than trademark_count. Records at a stage outside the five buckets (for example unknown or opposition_period) are counted in none. */
                 expired_count: number;
+                /** @description Office records (record grain) at this status stage. A Madrid IR counts once per designation record, so the status counts can sum to more than trademark_count. Records at a stage outside the five buckets (for example unknown or opposition_period) are counted in none. Includes surrendered and invalidated records. */
                 cancelled_count: number;
+                /** @description Office records (record grain) at this status stage. A Madrid IR counts once per designation record, so the status counts can sum to more than trademark_count. Records at a stage outside the five buckets (for example unknown or opposition_period) are counted in none. Includes withdrawn and refused records. */
                 abandoned_count: number;
                 /**
                  * @deprecated
-                 * @description Deprecated: use grant_rate — same value; registration_rate is a misnomer (it is the share of concluded prosecutions that were ever granted, not the share currently registered).
+                 * @description Deprecated: use grant_rate. Same value; registration_rate is a misnomer (it is the share of concluded prosecutions that were ever granted, not the share currently registered).
                  */
                 registration_rate: number | null;
-                /** @description Share of concluded prosecutions (registered + expired + cancelled) that were ever granted. Same value as the deprecated registration_rate. */
+                /** @description Share of concluded prosecutions (registered + expired + cancelled) that were ever granted, over office records (record grain). Same value as the deprecated registration_rate. */
                 grant_rate: number | null;
+                /** @description Share of concluded prosecutions (record grain) that ended abandoned, withdrawn or refused: abandoned / (registered + expired + cancelled + abandoned). */
                 abandonment_rate: number | null;
+                /** @description Distinct offices among the records. A Madrid IR's designations recorded by WIPO count as one office. */
                 jurisdiction_count: number;
+                /** @description Earliest filing_date over the records (YYYY-MM-DD). */
                 earliest_filing_date: string | null;
+                /** @description Latest filing_date over the records (YYYY-MM-DD). */
                 latest_filing_date: string | null;
+                /** @description When this stats row was last recomputed. The row only changes when a value changes, so an unchanged portfolio keeps its earlier stamp. */
                 computed_at: string | null;
             } | null;
             created_at: string;
@@ -6194,8 +6243,9 @@ export interface components {
              * @example corporation
              */
             legal_form: string | null;
+            /** @description Distinct marks (mark grain): a Madrid IR and its designations count once, matching the default grouped trademark listings. 0 when stats are not yet computed. */
             trademark_count: number;
-            /** @description Count of ACTIVE trademarks (registered + pending). Always present; 0 when stats not yet computed. */
+            /** @description Distinct marks (mark grain) that are registered or still in prosecution. Always present; 0 when stats are not yet computed. */
             active_count: number;
             /**
              * @description The resolved entity this owner is linked into. null when the owner is not linked to an entity.
@@ -6229,25 +6279,10 @@ export interface components {
                 /** @example srch_abc123 */
                 search_id: string;
                 /**
-                 * @description Echo of the text query, or null for filter-only searches.
+                 * @description Echo of the text query, or null for filter-only searches and for a q list.
                  * @example SIGNA
                  */
                 query: string | null;
-                /**
-                 * @description Deprecated (removed after the 90-day window): read `similarity_applied`. The applied channels in the old strategy vocabulary.
-                 * @example [
-                 *       "exact",
-                 *       "fuzzy",
-                 *       "prefix"
-                 *     ]
-                 */
-                strategies_used: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
-                /**
-                 * @description Deprecated (removed after the 90-day window): the old `match` mode the request was translated from, else 'similar'.
-                 * @example similar
-                 * @enum {string}
-                 */
-                match: "similar" | "exact" | "starts_with" | "ends_with" | "contains";
                 /**
                  * @description The similarity channels q ran on (identical is always included). Empty without q.
                  * @example [
@@ -6310,7 +6345,7 @@ export interface components {
                     sunset: string;
                 }[];
                 /**
-                 * @description International registration presentation actually served. grouped = one row per mark/IR, coverage block present on IR rows; expanded = one row per Madrid designation.
+                 * @description International registration presentation actually served. grouped = one row per mark/IR, coverage block present on IR rows; expanded = one row per Madrid designation. A trademark number in q is served expanded: one row per record it names.
                  * @example grouped
                  * @enum {string}
                  */
@@ -6326,10 +6361,10 @@ export interface components {
                  * @enum {string}
                  */
                 territory_match: "protection" | "direct";
-                /** @description Coded search warnings: per-channel skip warnings (a REQUESTED similarity channel produced zero clauses for the query shape — e.g. similarity=phonetic on a query too short/high-collision), filter-coverage warnings (an applied filter, e.g. opposition_status or seniority_claims, has partial index coverage), `expanded_fallback` (a grouped request was served one row per record), and `result_window_reached` (the 10,000-row result window, not the data, ends this walk). Omitted when there is nothing to warn about. */
+                /** @description Coded search warnings: per-channel skip warnings (a REQUESTED similarity channel produced zero clauses for the query shape — e.g. similarity=phonetic on a query too short/high-collision), filter-coverage warnings (an applied filter, e.g. opposition_status or seniority_claims, has partial index coverage), `expanded_fallback` (a grouped request was served one row per record), `identifier_lookup` (q is a trademark number, served one row per record it names), and `result_window_reached` (the 10,000-row result window, not the data, ends this walk). Omitted when there is nothing to warn about. */
                 warnings?: {
                     /**
-                     * @description Stable warning code for client handling: `<channel>_skipped` (a requested similarity channel produced no clauses for this query; see `channel`), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `expanded_fallback` (a grouped request was served one row per record because the grouped view cannot serve a filter, sort or option; see `affected_filters` / `affected_option`), `result_window_reached` (more than 10,000 rows match and this page is the last one the 10,000-row result window lets a relevance or sorted walk reach), `mixed_script` (a mark_text operator value mixes Latin with Greek or Cyrillic letters, which the operators compare as written; see `affected_filter`).
+                     * @description Stable warning code for client handling: `<channel>_skipped` (a requested similarity channel produced no clauses for this query; see `channel`), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `expanded_fallback` (a grouped request was served one row per record because the grouped view cannot serve a filter, sort or option; see `affected_filters` / `affected_option`), `identifier_lookup` (`q` is a trademark number, so the response lists the records it names, one row per record), `result_window_reached` (more than 10,000 rows match and this page is the last one the 10,000-row result window lets a relevance or sorted walk reach), `mixed_script` (a mark_text operator value mixes Latin with Greek or Cyrillic letters, which the operators compare as written; see `affected_filter`).
                      * @example phonetic_skipped
                      */
                     code: string;
@@ -6451,12 +6486,17 @@ export interface components {
             /** @example US */
             country_code: string | null;
             /**
-             * @description Total trademarks where this attorney is representative (mark grain). 0 when stats not yet computed.
+             * @description WIPO ST.3 code of the office whose records this attorney row comes from. Attorney records are per office: the same person appears once per office they file at.
+             * @example US
+             */
+            source_office_code: string | null;
+            /**
+             * @description Distinct marks (mark grain): a Madrid IR and its designations count once, matching the default grouped trademark listings. 0 when stats are not yet computed.
              * @example 512
              */
             trademark_count: number;
             /**
-             * @description Count of ACTIVE trademarks (registered + pending). Always present; 0 when stats not yet computed.
+             * @description Distinct marks (mark grain) that are registered or still in prosecution. Always present; 0 when stats are not yet computed.
              * @example 300
              */
             active_count: number;
@@ -6474,24 +6514,36 @@ export interface components {
                 identifier_type: string;
             }[];
             stats: {
+                /** @description Distinct marks (mark grain): a Madrid IR and its designations count once, matching the default grouped trademark listings. 0 when stats are not yet computed. */
                 trademark_count: number;
+                /** @description Office records (record grain) at this status stage. A Madrid IR counts once per designation record, so the status counts can sum to more than trademark_count. Records at a stage outside the five buckets (for example unknown or opposition_period) are counted in none. */
                 registered_count: number;
+                /** @description Office records (record grain) at this status stage. A Madrid IR counts once per designation record, so the status counts can sum to more than trademark_count. Records at a stage outside the five buckets (for example unknown or opposition_period) are counted in none. */
                 pending_count: number;
+                /** @description Office records (record grain) at this status stage. A Madrid IR counts once per designation record, so the status counts can sum to more than trademark_count. Records at a stage outside the five buckets (for example unknown or opposition_period) are counted in none. */
                 expired_count: number;
+                /** @description Office records (record grain) at this status stage. A Madrid IR counts once per designation record, so the status counts can sum to more than trademark_count. Records at a stage outside the five buckets (for example unknown or opposition_period) are counted in none. Includes surrendered and invalidated records. */
                 cancelled_count: number;
+                /** @description Office records (record grain) at this status stage. A Madrid IR counts once per designation record, so the status counts can sum to more than trademark_count. Records at a stage outside the five buckets (for example unknown or opposition_period) are counted in none. Includes withdrawn and refused records. */
                 abandoned_count: number;
                 /**
                  * @deprecated
-                 * @description Deprecated: use grant_rate — same value; registration_rate is a misnomer (it is the share of concluded prosecutions that were ever granted, not the share currently registered).
+                 * @description Deprecated: use grant_rate. Same value; registration_rate is a misnomer (it is the share of concluded prosecutions that were ever granted, not the share currently registered).
                  */
                 registration_rate: number | null;
-                /** @description Share of concluded prosecutions (registered + expired + cancelled) that were ever granted. Same value as the deprecated registration_rate. */
+                /** @description Share of concluded prosecutions (registered + expired + cancelled) that were ever granted, over office records (record grain). Same value as the deprecated registration_rate. */
                 grant_rate: number | null;
+                /** @description Share of concluded prosecutions (record grain) that ended abandoned, withdrawn or refused: abandoned / (registered + expired + cancelled + abandoned). */
                 abandonment_rate: number | null;
+                /** @description Distinct offices among the records. A Madrid IR's designations recorded by WIPO count as one office. */
                 jurisdiction_count: number;
+                /** @description Earliest filing_date over the records (YYYY-MM-DD). */
                 earliest_filing_date: string | null;
+                /** @description Latest filing_date over the records (YYYY-MM-DD). */
                 latest_filing_date: string | null;
+                /** @description Mean days from filing_date to registration_date over records with both dates (record grain). null when no record has both. */
                 avg_prosecution_days: number | null;
+                /** @description When this stats row was last recomputed. The row only changes when a value changes, so an unchanged portfolio keeps its earlier stamp. */
                 computed_at: string | null;
             } | null;
             created_at: string;
@@ -6508,8 +6560,14 @@ export interface components {
             canonical_name: string;
             firm_name: string | null;
             country_code: string | null;
+            /**
+             * @description WIPO ST.3 code of the office whose records this attorney row comes from. Attorney records are per office: the same person appears once per office they file at.
+             * @example US
+             */
+            source_office_code: string | null;
+            /** @description Distinct marks (mark grain): a Madrid IR and its designations count once, matching the default grouped trademark listings. 0 when stats are not yet computed. */
             trademark_count: number;
-            /** @description Count of ACTIVE trademarks (registered + pending). Always present; 0 when stats not yet computed. */
+            /** @description Distinct marks (mark grain) that are registered or still in prosecution. Always present; 0 when stats are not yet computed. */
             active_count: number;
         };
         AttorneyListResponse: {
@@ -6538,25 +6596,10 @@ export interface components {
                 /** @example srch_abc123 */
                 search_id: string;
                 /**
-                 * @description Echo of the text query, or null for filter-only searches.
+                 * @description Echo of the text query, or null for filter-only searches and for a q list.
                  * @example SIGNA
                  */
                 query: string | null;
-                /**
-                 * @description Deprecated (removed after the 90-day window): read `similarity_applied`. The applied channels in the old strategy vocabulary.
-                 * @example [
-                 *       "exact",
-                 *       "fuzzy",
-                 *       "prefix"
-                 *     ]
-                 */
-                strategies_used: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
-                /**
-                 * @description Deprecated (removed after the 90-day window): the old `match` mode the request was translated from, else 'similar'.
-                 * @example similar
-                 * @enum {string}
-                 */
-                match: "similar" | "exact" | "starts_with" | "ends_with" | "contains";
                 /**
                  * @description The similarity channels q ran on (identical is always included). Empty without q.
                  * @example [
@@ -6619,7 +6662,7 @@ export interface components {
                     sunset: string;
                 }[];
                 /**
-                 * @description International registration presentation actually served. grouped = one row per mark/IR, coverage block present on IR rows; expanded = one row per Madrid designation.
+                 * @description International registration presentation actually served. grouped = one row per mark/IR, coverage block present on IR rows; expanded = one row per Madrid designation. A trademark number in q is served expanded: one row per record it names.
                  * @example grouped
                  * @enum {string}
                  */
@@ -6635,10 +6678,10 @@ export interface components {
                  * @enum {string}
                  */
                 territory_match: "protection" | "direct";
-                /** @description Coded search warnings: per-channel skip warnings (a REQUESTED similarity channel produced zero clauses for the query shape — e.g. similarity=phonetic on a query too short/high-collision), filter-coverage warnings (an applied filter, e.g. opposition_status or seniority_claims, has partial index coverage), `expanded_fallback` (a grouped request was served one row per record), and `result_window_reached` (the 10,000-row result window, not the data, ends this walk). Omitted when there is nothing to warn about. */
+                /** @description Coded search warnings: per-channel skip warnings (a REQUESTED similarity channel produced zero clauses for the query shape — e.g. similarity=phonetic on a query too short/high-collision), filter-coverage warnings (an applied filter, e.g. opposition_status or seniority_claims, has partial index coverage), `expanded_fallback` (a grouped request was served one row per record), `identifier_lookup` (q is a trademark number, served one row per record it names), and `result_window_reached` (the 10,000-row result window, not the data, ends this walk). Omitted when there is nothing to warn about. */
                 warnings?: {
                     /**
-                     * @description Stable warning code for client handling: `<channel>_skipped` (a requested similarity channel produced no clauses for this query; see `channel`), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `expanded_fallback` (a grouped request was served one row per record because the grouped view cannot serve a filter, sort or option; see `affected_filters` / `affected_option`), `result_window_reached` (more than 10,000 rows match and this page is the last one the 10,000-row result window lets a relevance or sorted walk reach), `mixed_script` (a mark_text operator value mixes Latin with Greek or Cyrillic letters, which the operators compare as written; see `affected_filter`).
+                     * @description Stable warning code for client handling: `<channel>_skipped` (a requested similarity channel produced no clauses for this query; see `channel`), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `expanded_fallback` (a grouped request was served one row per record because the grouped view cannot serve a filter, sort or option; see `affected_filters` / `affected_option`), `identifier_lookup` (`q` is a trademark number, so the response lists the records it names, one row per record), `result_window_reached` (more than 10,000 rows match and this page is the last one the 10,000-row result window lets a relevance or sorted walk reach), `mixed_script` (a mark_text operator value mixes Latin with Greek or Cyrillic letters, which the operators compare as written; see `affected_filter`).
                      * @example phonetic_skipped
                      */
                     code: string;
@@ -6749,9 +6792,10 @@ export interface components {
             canonical_name: string;
             country_code: string | null;
             attorney_count: number;
+            /** @description Distinct marks (mark grain): a Madrid IR and its designations count once, matching the default grouped trademark listings. 0 when stats are not yet computed. */
             trademark_count: number;
             /**
-             * @description Count of ACTIVE trademarks (registered + pending). Always present; 0 when stats not yet computed.
+             * @description Distinct marks (mark grain) that are registered or still in prosecution. Always present; 0 when stats are not yet computed.
              * @example 300
              */
             active_count: number;
@@ -6785,8 +6829,9 @@ export interface components {
             canonical_name: string;
             country_code: string | null;
             attorney_count: number;
+            /** @description Distinct marks (mark grain): a Madrid IR and its designations count once, matching the default grouped trademark listings. 0 when stats are not yet computed. */
             trademark_count: number;
-            /** @description Count of ACTIVE trademarks (registered + pending). Always present; 0 when stats not yet computed. */
+            /** @description Distinct marks (mark grain) that are registered or still in prosecution. Always present; 0 when stats are not yet computed. */
             active_count: number;
             /**
              * @deprecated
@@ -6818,6 +6863,7 @@ export interface components {
             canonical_name: string;
             firm_name: string | null;
             country_code: string | null;
+            /** @description Distinct marks (mark grain): a Madrid IR and its designations count once, matching the default grouped trademark listings. 0 when stats are not yet computed. */
             trademark_count: number;
             /**
              * @deprecated
@@ -6856,25 +6902,10 @@ export interface components {
                 /** @example srch_abc123 */
                 search_id: string;
                 /**
-                 * @description Echo of the text query, or null for filter-only searches.
+                 * @description Echo of the text query, or null for filter-only searches and for a q list.
                  * @example SIGNA
                  */
                 query: string | null;
-                /**
-                 * @description Deprecated (removed after the 90-day window): read `similarity_applied`. The applied channels in the old strategy vocabulary.
-                 * @example [
-                 *       "exact",
-                 *       "fuzzy",
-                 *       "prefix"
-                 *     ]
-                 */
-                strategies_used: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
-                /**
-                 * @description Deprecated (removed after the 90-day window): the old `match` mode the request was translated from, else 'similar'.
-                 * @example similar
-                 * @enum {string}
-                 */
-                match: "similar" | "exact" | "starts_with" | "ends_with" | "contains";
                 /**
                  * @description The similarity channels q ran on (identical is always included). Empty without q.
                  * @example [
@@ -6937,7 +6968,7 @@ export interface components {
                     sunset: string;
                 }[];
                 /**
-                 * @description International registration presentation actually served. grouped = one row per mark/IR, coverage block present on IR rows; expanded = one row per Madrid designation.
+                 * @description International registration presentation actually served. grouped = one row per mark/IR, coverage block present on IR rows; expanded = one row per Madrid designation. A trademark number in q is served expanded: one row per record it names.
                  * @example grouped
                  * @enum {string}
                  */
@@ -6953,10 +6984,10 @@ export interface components {
                  * @enum {string}
                  */
                 territory_match: "protection" | "direct";
-                /** @description Coded search warnings: per-channel skip warnings (a REQUESTED similarity channel produced zero clauses for the query shape — e.g. similarity=phonetic on a query too short/high-collision), filter-coverage warnings (an applied filter, e.g. opposition_status or seniority_claims, has partial index coverage), `expanded_fallback` (a grouped request was served one row per record), and `result_window_reached` (the 10,000-row result window, not the data, ends this walk). Omitted when there is nothing to warn about. */
+                /** @description Coded search warnings: per-channel skip warnings (a REQUESTED similarity channel produced zero clauses for the query shape — e.g. similarity=phonetic on a query too short/high-collision), filter-coverage warnings (an applied filter, e.g. opposition_status or seniority_claims, has partial index coverage), `expanded_fallback` (a grouped request was served one row per record), `identifier_lookup` (q is a trademark number, served one row per record it names), and `result_window_reached` (the 10,000-row result window, not the data, ends this walk). Omitted when there is nothing to warn about. */
                 warnings?: {
                     /**
-                     * @description Stable warning code for client handling: `<channel>_skipped` (a requested similarity channel produced no clauses for this query; see `channel`), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `expanded_fallback` (a grouped request was served one row per record because the grouped view cannot serve a filter, sort or option; see `affected_filters` / `affected_option`), `result_window_reached` (more than 10,000 rows match and this page is the last one the 10,000-row result window lets a relevance or sorted walk reach), `mixed_script` (a mark_text operator value mixes Latin with Greek or Cyrillic letters, which the operators compare as written; see `affected_filter`).
+                     * @description Stable warning code for client handling: `<channel>_skipped` (a requested similarity channel produced no clauses for this query; see `channel`), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `expanded_fallback` (a grouped request was served one row per record because the grouped view cannot serve a filter, sort or option; see `affected_filters` / `affected_option`), `identifier_lookup` (`q` is a trademark number, so the response lists the records it names, one row per record), `result_window_reached` (more than 10,000 rows match and this page is the last one the 10,000-row result window lets a relevance or sorted walk reach), `mixed_script` (a mark_text operator value mixes Latin with Greek or Cyrillic letters, which the operators compare as written; see `affected_filter`).
                      * @example phonetic_skipped
                      */
                     code: string;
@@ -7152,11 +7183,11 @@ export interface components {
              */
             tickers: string[];
             /**
-             * @description Survivorship LEI (first aggregated GLEIF LEI, else the entity row LEI).
+             * @description Survivorship LEI, uppercased: the entity's own LEI when set, else the first GLEIF LEI across member companies. null when none.
              * @example HWUPKR0MPOU8FGXBT394
              */
             lei: string | null;
-            /** @description Whether any GLEIF LEI is present across member companies. */
+            /** @description Whether the entity has an LEI: its own, or any GLEIF LEI across member companies. */
             has_lei: boolean;
             /** @description COUNT(DISTINCT trademark) across all member owners (co-owned marks counted once). `null` when the count could not be computed within the read-path timeout for a very large entity (fail-open — the rest of the detail is still served). */
             trademark_count: number | null;
@@ -7225,25 +7256,10 @@ export interface components {
                 /** @example srch_abc123 */
                 search_id: string;
                 /**
-                 * @description Echo of the text query, or null for filter-only searches.
+                 * @description Echo of the text query, or null for filter-only searches and for a q list.
                  * @example SIGNA
                  */
                 query: string | null;
-                /**
-                 * @description Deprecated (removed after the 90-day window): read `similarity_applied`. The applied channels in the old strategy vocabulary.
-                 * @example [
-                 *       "exact",
-                 *       "fuzzy",
-                 *       "prefix"
-                 *     ]
-                 */
-                strategies_used: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
-                /**
-                 * @description Deprecated (removed after the 90-day window): the old `match` mode the request was translated from, else 'similar'.
-                 * @example similar
-                 * @enum {string}
-                 */
-                match: "similar" | "exact" | "starts_with" | "ends_with" | "contains";
                 /**
                  * @description The similarity channels q ran on (identical is always included). Empty without q.
                  * @example [
@@ -7306,7 +7322,7 @@ export interface components {
                     sunset: string;
                 }[];
                 /**
-                 * @description International registration presentation actually served. grouped = one row per mark/IR, coverage block present on IR rows; expanded = one row per Madrid designation.
+                 * @description International registration presentation actually served. grouped = one row per mark/IR, coverage block present on IR rows; expanded = one row per Madrid designation. A trademark number in q is served expanded: one row per record it names.
                  * @example grouped
                  * @enum {string}
                  */
@@ -7322,10 +7338,10 @@ export interface components {
                  * @enum {string}
                  */
                 territory_match: "protection" | "direct";
-                /** @description Coded search warnings: per-channel skip warnings (a REQUESTED similarity channel produced zero clauses for the query shape — e.g. similarity=phonetic on a query too short/high-collision), filter-coverage warnings (an applied filter, e.g. opposition_status or seniority_claims, has partial index coverage), `expanded_fallback` (a grouped request was served one row per record), and `result_window_reached` (the 10,000-row result window, not the data, ends this walk). Omitted when there is nothing to warn about. */
+                /** @description Coded search warnings: per-channel skip warnings (a REQUESTED similarity channel produced zero clauses for the query shape — e.g. similarity=phonetic on a query too short/high-collision), filter-coverage warnings (an applied filter, e.g. opposition_status or seniority_claims, has partial index coverage), `expanded_fallback` (a grouped request was served one row per record), `identifier_lookup` (q is a trademark number, served one row per record it names), and `result_window_reached` (the 10,000-row result window, not the data, ends this walk). Omitted when there is nothing to warn about. */
                 warnings?: {
                     /**
-                     * @description Stable warning code for client handling: `<channel>_skipped` (a requested similarity channel produced no clauses for this query; see `channel`), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `expanded_fallback` (a grouped request was served one row per record because the grouped view cannot serve a filter, sort or option; see `affected_filters` / `affected_option`), `result_window_reached` (more than 10,000 rows match and this page is the last one the 10,000-row result window lets a relevance or sorted walk reach), `mixed_script` (a mark_text operator value mixes Latin with Greek or Cyrillic letters, which the operators compare as written; see `affected_filter`).
+                     * @description Stable warning code for client handling: `<channel>_skipped` (a requested similarity channel produced no clauses for this query; see `channel`), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `expanded_fallback` (a grouped request was served one row per record because the grouped view cannot serve a filter, sort or option; see `affected_filters` / `affected_option`), `identifier_lookup` (`q` is a trademark number, so the response lists the records it names, one row per record), `result_window_reached` (more than 10,000 rows match and this page is the last one the 10,000-row result window lets a relevance or sorted walk reach), `mixed_script` (a mark_text operator value mixes Latin with Greek or Cyrillic letters, which the operators compare as written; see `affected_filter`).
                      * @example phonetic_skipped
                      */
                     code: string;
@@ -7425,7 +7441,10 @@ export interface components {
             object: "proceeding";
             /** @example opposition */
             proceeding_type: string;
-            /** @example 91234567 */
+            /**
+             * @description The office's identifier for the proceeding, when it issues one. For CIPO, proceeding_number is the office's per-record sequence identifier (1, 2, …), not a Board docket number.
+             * @example 91234567
+             */
             proceeding_number: string | null;
             /** @example decided_rejected */
             status: string | null;
@@ -7670,9 +7689,13 @@ export interface components {
             base_source: "rule_period" | "stated_deadline" | "rule_absolute_cap" | null;
             /** @description A stated due date the engine REJECTED for exceeding the rule's absolute cap, kept as structured provenance. */
             rejected_stated_due_date: string | null;
+            /** @description The fact that retired this deadline. Null when nothing retired it, and on a closed `post_registration_oa_response` row, whose closing entry (named in `notes`) is not one of the record's facts. */
             closed_by_fact_id: string | null;
-            /** @enum {string|null} */
-            closed_by: "response" | "abandonment" | "sou" | null;
+            /**
+             * @description What retired this deadline. `acceptance` (only on `post_registration_oa_response`): the office accepted the filing the post-registration action examined, so no response is due.
+             * @enum {string|null}
+             */
+            closed_by: "response" | "abandonment" | "sou" | "acceptance" | null;
             /** @description For `outcome: "stated"`: the `stated_deadline` fact that carried the date. */
             stated_by_fact_id: string | null;
             /**
@@ -7696,12 +7719,12 @@ export interface components {
             filing_route: "national" | "regional" | "madrid";
             supported: boolean;
             /**
-             * @description Why no MAINTENANCE schedule was computed; null when `supported` is true. `unsupported_jurisdiction`: no rules are modeled for the jurisdiction. `requires_office_date`: the record does not carry the input the statute needs (Australian direct marks filed before 1996-01-01, Singapore direct marks filed before 1999-01-15, a Madrid designation with no international-registration date, or a Swedish, Icelandic, Norwegian or Finnish direct filing made before the renewal-anchor reform of its office (SE 2019-01-01, IS 2020-09-01, NO 2010-07-01, FI 2019-05-01) with no `registration_date`, since the old-regime term runs from registration, or a record where every rule it owes lacks the date it runs from (for example a registered mark with no registration date where the rules run from registration, or a Swedish mark registered on or after 2019-01-01 with no filing date)) and no `expiry_date` was supplied to anchor on; supply the office-stated `expiry_date` and the schedule is computed from it. The engine declines to guess.
+             * @description Why no MAINTENANCE schedule was computed; null when `supported` is true. `unsupported_jurisdiction`: no rules are modeled for the jurisdiction. `requires_office_date`: the record does not carry the input the statute needs (Australian direct marks filed before 1996-01-01, Singapore direct marks filed before 1999-01-15, a Madrid designation with no international-registration date, or a Swedish, Icelandic, Norwegian or Finnish direct filing made before the renewal-anchor reform of its office (SE 2019-01-01, IS 2020-09-01, NO 2010-07-01, FI 2019-05-01) with no `registration_date`, since the old-regime term runs from registration, or a record where every rule it owes lacks the date it runs from (for example a registered or expired mark with no registration date where the rules run from registration, or a Swedish mark registered on or after 2019-01-01 with no filing date; a cancelled mark owes only a renewal that opens a modelled restoration window, as in Japan, so elsewhere it is supported with no deadlines, unless `include_missed` asks for its missed rows too, which it then owes)) and no `expiry_date` was supplied to anchor on; supply the office-stated `expiry_date` and the schedule is computed from it. The engine declines to guess. In a jurisdiction with modeled rules, never `requires_office_date` for a mark whose status ends every obligation (abandoned, withdrawn, surrendered, invalidated, or refused other than a WIPO international registration record, which keeps its renewal): it is supported with no deadlines.
              * @enum {string|null}
              */
             reason: "unsupported_jurisdiction" | "requires_office_date" | null;
             deadlines: components["schemas"]["ComputedDeadline"][];
-            /** @description Rules that apply to this mark but were declined because it lacks the date the statute anchors them on. `deadlines` has no row for them, so without this list the obligation would be silently absent. Always present: `[]` when nothing was declined, and `[]` when `supported` is false (`reason` already covers every rule). A rule is declined when the date it runs from is owed but absent: a filing date, an international registration date, the Philippine statement of grant (`protection_grant_date`, for the fifth-year declaration of use of a Madrid designation), or, once the mark is registered, its registration or grant date. A registration-anchored rule on an application not yet registered is not declined: nothing is due yet. Supply the missing field to get the row. */
+            /** @description Rules that apply to this mark but were declined because it lacks the date the statute anchors them on. `deadlines` has no row for them, so without this list the obligation would be silently absent. Always present: `[]` when nothing was declined, and `[]` when `supported` is false (`reason` already covers every rule). A rule is declined when the date it runs from is owed but absent: a filing date, an international registration date, the Philippine statement of grant (`protection_grant_date`, for the fifth-year declaration of use of a Madrid designation), or, once the mark is registered (an expired or cancelled mark was), its registration or grant date. The Mexican third-year declaration covers grants from 10 August 2018 only, so a national mark registered before then is not asked for its grant date; a Madrid designation is, since its statement of grant can come years after its international registration. A registration-anchored rule on an application not yet registered is not declined: nothing is due yet. An expired mark names every rule whose miss costs something (its status serves a rule while the window of that rule is open), except, without `include_missed`, a one-off rule of a national mark (a declaration due once, such as US Section 8, the Philippine third- and fifth-year declarations or the Mexican third-year declaration): its window closed before the term ended, so the date would compute nothing to act on; a Madrid designation granted late in the term of its international registration still names it. A cancelled mark names only a renewal that opens a modelled restoration window: its status serves nothing else. With `include_missed`, both name every rule they owe that would return a row, missed or current, as of the computation date for some date the mark could carry, since its missed row would be returned too: a mark cancelled three years after filing is not asked for a registration date, because no Section 8 or 9 window can have closed yet. Supply the missing field and the rule is computed; whether a row is returned then depends on its window, `horizon_years` and `include_missed`, and for an expired mark on that window being open, as for any computed rule. */
             unsupported_rules: components["schemas"]["UnsupportedDeadlineRule"][];
             /**
              * @description Statutory sources of the jurisdiction configuration this computation used. Provenance is per jurisdiction configuration, not per rule: every rule in a jurisdiction shares this one source list, so it is carried once per item rather than on each row. For per-rule detail, join a row's `rule_id` to `GET /v1/deadline-rules`. Empty only when no configuration exists for the jurisdiction.
@@ -8109,7 +8132,7 @@ export interface components {
              */
             grant_date?: string | null;
             /**
-             * @description Office-stated end of the current term. When provided, renewal deadlines anchor on it (trigger_field "reported_expiry") unless the statutory ladder from the trigger date already passes through it. An office-stated renewal-due date (renewal_due_date_basis "reported") anchors the same way when no expiry is stored (trigger_field "reported_renewal_due").
+             * @description Office-stated end of the current term. When provided, renewal deadlines anchor on it (trigger_field "reported_expiry") unless the statutory ladder from the trigger date already passes through it. An office-stated renewal-due date (renewal_due_date_basis "reported") anchors the same way when no expiry is stored (trigger_field "reported_renewal_due"). When it (or the renewal-due date anchoring in its place) has passed, together with its grace period and any restoration window, and no supplied `last_renewal_date` renewed that cycle, the term ended there and no row of a later cycle (renewal, declaration or restoration) is returned.
              * @example null
              */
             expiry_date?: string | null;
@@ -8205,7 +8228,7 @@ export interface components {
              * @enum {string|null}
              */
             reason: "unsupported_jurisdiction" | "requires_office_date" | null;
-            /** @description Rules declined for want of their statutory anchor, as on POST /v1/deadlines/compute. `[]` when `supported` is false. */
+            /** @description Rules declined for want of their statutory anchor, as on POST /v1/deadlines/compute: without `include_missed`, or with it when the list is filtered to `urgency=missed` (the only filter that serves missed rows). `[]` when `supported` is false. */
             unsupported_rules: components["schemas"]["UnsupportedDeadlineRule"][];
         };
         DeadlineListResponse: {
@@ -8218,7 +8241,7 @@ export interface components {
                 total_count?: number;
                 total_count_approximate?: boolean;
             };
-            /** @description Marks in the requested scope whose deadlines could not be computed (they have no rows) or were computed only in part (some rules declined), sorted by `trademark_id`. A mark whose status ends every obligation (`abandoned`, `withdrawn`, `surrendered`, `invalidated`, or `refused` other than a WIPO international registration) is never listed: it is owed no deadlines in any jurisdiction. Covers the whole portfolio or trademark, not just this page, and ignores the `type`, `urgency` and `due_before` filters. Reported on the first page (a request without `cursor`); `null` on every continuation page, because the cursor pins the computation date and the first page already answered for the whole chain. `[]` on a first page means every mark in scope that is owed deadlines was fully computed. */
+            /** @description Marks in the requested scope whose deadlines could not be computed (they have no rows) or were computed only in part (some rules declined), sorted by `trademark_id`. A mark whose status ends every obligation (`abandoned`, `withdrawn`, `surrendered`, `invalidated`, or `refused` other than a WIPO international registration) is never listed: it is owed no deadlines in any jurisdiction. Covers the whole portfolio or trademark, not just this page, and ignores the `type` and `due_before` filters and every `urgency` value but `missed`, which also names the rules declined for missed rows. Reported on the first page (a request without `cursor`); `null` on every continuation page, because the cursor pins the computation date and the first page already answered for the whole chain. `[]` on a first page means every mark in scope that is owed deadlines was fully computed. */
             unsupported_marks: components["schemas"]["DeadlineUnsupportedMark"][] | null;
             request_id: string;
         };
@@ -8449,7 +8472,7 @@ export interface components {
             common_extension: components["schemas"]["OppositionCommonExtension"];
             source: components["schemas"]["OppositionWindowSource"];
             /**
-             * @description Why the window is unsupported or degraded, as a snake_case code; null on every normal window. With `supported: false`: `unsupported_office` (no rule reaches this office, route and publication date) or `window_not_computable` (a rule resolved but no window could be produced). With `supported: true`, a degraded window: `publication_date_kind_mismatch`, meaning the `publication_date_kind` you sent is not the publication the matched Madrid rule runs from, including the explicit `unknown`. A plain missing `publication_date` stays reason-less: `status: "unknown"` with a null `publication_date` already says that. Treat the vocabulary as open — new codes may be added, so branch on the codes you know and fall through on the rest.
+             * @description Why the window is unsupported or degraded, as a snake_case code; null on every normal window. With `supported: false`: `unsupported_office` (no rule exists for this office and route), `before_commencement` (a rule exists, but the publication date, or a sent `filing_date`, falls before the date it applies from; `rule_id` names it and `effective_from` the boundary) or `window_not_computable` (a rule resolved but no window could be produced). With `supported: true`, a degraded window: `publication_date_kind_mismatch`, meaning the `publication_date_kind` you sent is not the publication the matched Madrid rule runs from, including the explicit `unknown`. A plain missing `publication_date` stays reason-less: `status: "unknown"` with a null `publication_date` already says that. Treat the vocabulary as open — new codes may be added, so branch on the codes you know and fall through on the rest.
              * @example null
              */
             reason: string | null;
@@ -8484,7 +8507,7 @@ export interface components {
              */
             publication_date?: string;
             /**
-             * @description Application filing calendar date. Read only by rules whose era pivot is keyed on the filing date (TR: SMK geçici m. 1/1 gives applications filed before 2017-01-10 the former 3-month window even when published later). Omit it and such a rule falls back to the publication date, which yields the shorter modern window; every other rule ignores it.
+             * @description Application filing calendar date. Read only by rules whose era pivot is keyed on the filing date (TR: SMK geçici m. 1/1 gives applications filed before 2017-01-10 the former 3-month window even when published later). Omit it and such a rule falls back to the publication date, which yields the shorter modern window. Also read by a rule that excludes marks already filed when its opposition procedure commenced (CH: filed before 1993-04-01; PL: filed before 2016-04-15), which then has no window; omit it and only the publication date is tested against the commencement. Every other rule ignores it.
              * @example 2026-01-15
              */
             filing_date?: string;
@@ -8540,7 +8563,7 @@ export interface components {
             filing_route: "national" | "regional" | "madrid";
             supported: boolean;
             /**
-             * @description Why no maintenance schedule was computed; null when `supported` is true. Same vocabulary as POST /v1/deadlines/compute.
+             * @description Why no maintenance schedule was computed; null when `supported` is true. Same vocabulary and verdict as POST /v1/deadlines/compute with `include_missed: true`: reconcile reads missed cycles too.
              * @enum {string|null}
              */
             reason: "unsupported_jurisdiction" | "requires_office_date" | null;
@@ -8558,6 +8581,8 @@ export interface components {
             computed_at: string;
             /** @example 10 */
             horizon_years: number;
+            /** @description Rules that apply to the record but were declined because it lacks the date the statute anchors them on, as on POST /v1/deadlines/compute with `include_missed: true` (an expired or cancelled record also names the rules whose missed cycles it cannot date), so a docketed deadline of such a rule has no computed value. `[]` when none, and `[]` when `supported` is false. */
+            unsupported_rules: components["schemas"]["UnsupportedDeadlineRule"][];
         };
         ReconcileComputedProvenance: {
             /** @example us_renewal_s9 */
@@ -10204,6 +10229,14 @@ export interface components {
              * @example 2026-08-14
              */
             source_date?: string | null;
+            /** @description trademark.corrected only: why this status change is a correction of a status Signa published earlier. The rest of the body is the trademark.status_changed shape. */
+            correction?: {
+                /**
+                 * @description status: Signa published a wrong status and this event reverses it. late_office_record: office records reached Signa late and show the mark lapsing or a dead mark returning.
+                 * @enum {string}
+                 */
+                kind: "status" | "late_office_record";
+            };
             /** @description Portfolios this mark belonged to when the event was recorded, with the external_ref you set on the membership. Frozen at record time, so later membership or reference edits never rewrite an event you already received; null external_ref means unknown or unset. Empty when the mark was in no portfolio. Absent on alert.created. */
             portfolios?: {
                 /** @example ptf_9aB2xY */
@@ -10217,7 +10250,7 @@ export interface components {
             created_at: string;
             request_id: string;
         };
-        /** @description The organization's subscription as Signa mirrors it (status, scheduled cancellation, open dunning record of the live subscription). Present only when the API key holds billing:read (or admin); absent otherwise. */
+        /** @description The organization's subscription as Signa mirrors it (status, scheduled cancellation, open dunning record of the live subscription, plan change scheduled for the period end). Present only when the API key holds billing:read (or admin); absent otherwise. */
         SubscriptionSummary: {
             /**
              * @description The organization's Stripe subscription status as mirrored (`active`, `trialing`, `past_due`, `unpaid`, `paused`, `canceled`, ...). Null when the organization has no subscription.
@@ -10235,6 +10268,25 @@ export interface components {
                 /** @description Stripe-hosted page to pay the open invoice or update the payment method. */
                 invoice_url: string | null;
             } | null;
+            /** @description A downgrade or a switch to monthly billing made through POST /v1/organization/billing/plan-change that waits for the end of the current period; null when none is pending. Requesting the current plan and interval from that endpoint undoes it. Null once it takes effect, and once the subscription is cancelled or the change is released in Stripe. */
+            scheduled_change?: {
+                /**
+                 * @description The plan the subscription changes to (canonical name).
+                 * @example starter
+                 */
+                plan: string;
+                /**
+                 * @description The billing interval it changes to.
+                 * @example monthly
+                 * @enum {string}
+                 */
+                interval: "monthly" | "annual";
+                /**
+                 * @description When the change takes effect: the end of the current billing period (ISO 8601).
+                 * @example 2026-11-02T00:00:00.000Z
+                 */
+                effective_at: string;
+            } | null;
         };
         Identity: {
             /** @enum {string} */
@@ -10718,7 +10770,7 @@ export interface components {
         };
         StripePlanChangeResponse: {
             /**
-             * @description applied: Stripe applied the change (the proration invoice was paid, or nothing was owed); the plan and credits follow through the webhooks within seconds. pending_payment: the proration payment failed or needs authentication, so nothing changed yet — the customer pays hosted_invoice_url; paying applies the change, and after about 23 hours unpaid Stripe voids the invoice and drops it. scheduled: a downgrade or a shorter interval takes effect at the current period end (effective_at); nothing is charged now.
+             * @description applied: Stripe applied the change (the proration invoice was paid, or nothing was owed); the plan and credits follow through the webhooks within seconds. Also the answer when the request undid a change scheduled here (the current plan and interval were requested): the schedule is released and nothing is charged. pending_payment: the proration payment failed or needs authentication, so nothing changed yet — the customer pays hosted_invoice_url; paying applies the change, and after about 23 hours unpaid Stripe voids the invoice and drops it. scheduled: a downgrade or a shorter interval takes effect at the current period end (effective_at); nothing is charged now.
              * @enum {string}
              */
             outcome: "applied" | "pending_payment" | "scheduled";
@@ -12511,8 +12563,11 @@ export interface operations {
         requestBody?: {
             content: {
                 "application/json": {
-                    /** @description Search text, ranked through the similarity channels: 1-500 characters, at least 2 after case and accent folding (one CJK character is enough). Always literal; filter on the mark text with the mark_text operators. A trademark number in q (1939139, US 5123456, tm_...) is also looked up and its records lead the page. Optional for a filtered listing. */
-                    q?: string;
+                    /**
+                     * @description Search text, ranked through the similarity channels: 1-500 characters, at least 2 after case and accent folding (one CJK character is enough). Always literal; filter on the mark text with the mark_text operators. A trademark number in q (1939139, US 5123456, tm_...) is also looked up and its records lead the page. Optional for a filtered listing. A list of 1-100 terms (each up to 200 characters, e.g. spelling variants) runs every term through the same similarity channels in one search: a hit ranks by its best term and match.terms names the terms that reached it. A list over 10 terms needs similarity limited to identical and lookalike; with fuzzy, embedded or phonetic a list takes 10 terms and 30 words in total. A list is never read as a trademark number.
+                     * @example SIGNA
+                     */
+                    q?: string | string[];
                     /** @description Similarity channels for q: identical, fuzzy, embedded, phonetic, lookalike. Default identical, fuzzy, embedded, lookalike; identical is always on. Requires q. */
                     similarity?: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[];
                     exclude?: components["schemas"]["SearchExclude"];
@@ -12669,7 +12724,7 @@ export interface operations {
                     limit?: number;
                     cursor?: string;
                     /**
-                     * @description International registration presentation. Default grouped → one row per mark/IR, with coverage on IR rows. Use expanded for one row per Madrid designation.
+                     * @description International registration presentation. Default grouped → one row per mark/IR, with coverage on IR rows; a trademark number in q returns one row per record it names. Use expanded for one row per Madrid designation.
                      * @example grouped
                      * @enum {string}
                      */
@@ -15168,7 +15223,7 @@ export interface operations {
                     "application/json": components["schemas"]["ProceedingListResponse"];
                 };
             };
-            /** @description Missing filter or invalid params */
+            /** @description Missing filter or invalid params, including an unknown or planned (not live) `office_code` */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -15195,7 +15250,7 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Entity too large. `error.reason` is `member_owners_too_large` (`?party_entity_id=`/`?entity_id=` resolved to more member owners than the cap; carries `member_count`/`member_count_limit`). */
+            /** @description Two cases, told apart by `error.type`. `capability_not_available`: `office_code` names a live office whose proceedings Signa does not serve (`capabilities.proceedings` on `GET /v1/offices` is not `available`); the error carries `capability`, `capability_state` and `office_code`, no query is run and no credits are charged. `entity_too_large`: `error.reason` is `member_owners_too_large` (`?party_entity_id=`/`?entity_id=` resolved to more member owners than the cap; carries `member_count`/`member_count_limit`). */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -15527,7 +15582,7 @@ export interface operations {
     listDeadlines: {
         parameters: {
             query?: {
-                type?: ("renewal" | "declaration_of_use" | "combined_renewal_and_use" | "declaration_of_incontestability" | "restoration" | "international_renewal")[] | null;
+                type?: ("renewal" | "declaration_of_use" | "combined_renewal_and_use" | "declaration_of_incontestability" | "restoration" | "international_renewal" | "post_registration_oa_response")[] | null;
                 due_before?: string;
                 urgency?: "critical" | "upcoming" | "routine" | "in_grace" | "missed";
                 limit?: number;
@@ -16791,7 +16846,7 @@ export interface operations {
     listPortfolioDeadlines: {
         parameters: {
             query?: {
-                type?: ("renewal" | "declaration_of_use" | "combined_renewal_and_use" | "declaration_of_incontestability" | "restoration" | "international_renewal")[] | null;
+                type?: ("renewal" | "declaration_of_use" | "combined_renewal_and_use" | "declaration_of_incontestability" | "restoration" | "international_renewal" | "post_registration_oa_response")[] | null;
                 due_before?: string;
                 urgency?: "critical" | "upcoming" | "routine" | "in_grace" | "missed";
                 limit?: number;
@@ -16964,6 +17019,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     retrieveAlert: {
@@ -16986,6 +17050,15 @@ export interface operations {
                     "application/json": components["schemas"]["Alert"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -17030,6 +17103,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -17156,6 +17238,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     listWatches: {
@@ -17180,6 +17271,15 @@ export interface operations {
                     "application/json": components["schemas"]["WatchList"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     createWatch: {
@@ -17199,7 +17299,7 @@ export interface operations {
                     /** @enum {string} */
                     watch_type: "mark" | "portfolio" | "owner" | "class" | "similarity";
                     /**
-                     * @description Watch query JSON (max 50,000 bytes serialized, depth 5 — larger bodies are 400 `validation_error`). `version` is required: `v1`, `v2` and `v3` are accepted, and a new or changed query is stored as a v3 similarity watch whatever `version` it sends (`version` is set to `v3`) unless it uses the deprecated keys below: `q` (string), optional `similarity` (the search channels: `identical`, `fuzzy`, `embedded`, `phonetic`, `lookalike`; default `identical,fuzzy,embedded,lookalike`, `identical` always on), optional `min_tier` (the weakest similarity tier that alerts: `identical`, `near_identical`, `similar`, `related`; default `related`, everything through), `filters`, and optional `trigger_events` (default: `trademark.created`, `trademark.updated`, `trademark.status_changed`; `trademark.retracted` / `trademark.corrected` are opt-in). The search text filters (`mark_text_*`) and exclusions (`exclude`, `*_not`) are not accepted on watches. Deprecated until 2026-12-28: `strategies` (replaced by `similarity`) and `min_match_tier` (replaced by `min_tier`). A write that uses them is kept as a legacy watch with its original matching until it is re-saved without them, and each is reported in the response `deprecations`; sending old and new keys together is 400 `conflicting_params`. Stored watches keep the matching they were saved with; a PATCH whose query equals the stored one changes nothing, one that differs only where a write normalises it (such as offices added from jurisdictions, or code and ID casing) is saved in that form with the same matching, and a PATCH that changes it re-saves it under these rules. `filters.offices` takes WIPO ST.3 codes (`US`, `EM`, …; legacy `uspto`/`euipo`/`EU` accepted); `filters.jurisdictions` without `filters.offices` is auto-translated to the live offices for those jurisdictions and is rejected with 400 `no_live_office` when none resolves. `score_threshold` is NOT accepted on write (400) — match scores are informational via `match.score` on alerts — and is never echoed on read.
+                     * @description Watch query JSON (max 50,000 bytes serialized, depth 5; larger bodies are 400 `validation_error`). `version` is required: `v1`, `v2` and `v3` are accepted, and a new or changed query is stored as a v3 similarity watch whatever `version` it sends (`version` is set to `v3`) unless it uses the deprecated keys below: `q` (string), optional `similarity` (the search channels: `identical`, `fuzzy`, `embedded`, `phonetic`, `lookalike`; default `identical,fuzzy,embedded,lookalike`, `identical` always on), optional `min_tier` (the weakest similarity tier that alerts: `identical`, `near_identical`, `similar`, `related`; default `related`, everything through), `filters`, and optional `trigger_events` (default: `trademark.created`, `trademark.updated`, `trademark.status_changed`; `trademark.retracted` / `trademark.corrected` are opt-in; `trademark.corrected` also covers a status Signa corrected, including a lapse or a reversal shown by office records that reached Signa late, which then never arrives as `trademark.status_changed` / `trademark.updated`). The search text filters (`mark_text_*`) and exclusions (`exclude`, `*_not`) are not accepted on watches. Deprecated until 2026-12-28: `strategies` (replaced by `similarity`) and `min_match_tier` (replaced by `min_tier`). A write that uses them is kept as a legacy watch with its original matching until it is re-saved without them, and each is reported in the response `deprecations`; sending old and new keys together is 400 `conflicting_params`. Stored watches keep the matching they were saved with; a PATCH whose query equals the stored one changes nothing, one that differs only where a write normalises it (such as offices added from jurisdictions, or code and ID casing) is saved in that form and not migrated (a legacy watch stays legacy), though the saved form can change what it matches (a jurisdictions-only watch is evaluated once offices are added), and a PATCH that changes it re-saves it under these rules. `filters.offices` takes WIPO ST.3 codes (`US`, `EM`, …; legacy `uspto`/`euipo`/`EU` accepted); `filters.jurisdictions` without `filters.offices` is auto-translated to the live offices for those jurisdictions and is rejected with 400 `no_live_office` when none resolves. `score_threshold` is NOT accepted on write (400), since match scores are informational via `match.score` on alerts, and is never echoed on read.
                      * @example {
                      *       "version": "v3",
                      *       "q": "acme",
@@ -17254,6 +17354,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Insufficient credits — `insufficient_credits_for_watch`: the pooled credit balance cannot fund the minimum monitoring window for a new watch (charged plans only). Extensions carry `credit_balance`, `credit_required`, `monitoring_daily_cost`, `required_days`. */
             402: {
                 headers: {
@@ -17321,6 +17430,15 @@ export interface operations {
                     "application/json": components["schemas"]["Watch"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -17362,6 +17480,15 @@ export interface operations {
                     };
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -17426,6 +17553,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Insufficient credits to fund the minimum monitoring window for newly added distinct trademarks. */
             402: {
                 headers: {
@@ -17495,6 +17631,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -17531,6 +17676,15 @@ export interface operations {
                     "application/pdf": string;
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -17583,6 +17737,15 @@ export interface operations {
                     "application/json": components["schemas"]["Watch"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -17617,6 +17780,15 @@ export interface operations {
                     "application/json": components["schemas"]["Watch"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -17694,6 +17866,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Payload too large — the 256KB service-level query cap. NOT reachable over HTTP: the 50,000-byte / depth-5 bounded-JSON check on `query` runs first and answers 400 `validation_error`; only service/MCP callers can observe this status. */
             413: {
                 headers: {
@@ -17761,7 +17942,7 @@ export interface operations {
                         /** @enum {string} */
                         watch_type: "mark" | "portfolio" | "owner" | "class" | "similarity";
                         /**
-                         * @description Watch query JSON (max 50,000 bytes serialized, depth 5 — larger bodies are 400 `validation_error`). `version` is required: `v1`, `v2` and `v3` are accepted, and a new or changed query is stored as a v3 similarity watch whatever `version` it sends (`version` is set to `v3`) unless it uses the deprecated keys below: `q` (string), optional `similarity` (the search channels: `identical`, `fuzzy`, `embedded`, `phonetic`, `lookalike`; default `identical,fuzzy,embedded,lookalike`, `identical` always on), optional `min_tier` (the weakest similarity tier that alerts: `identical`, `near_identical`, `similar`, `related`; default `related`, everything through), `filters`, and optional `trigger_events` (default: `trademark.created`, `trademark.updated`, `trademark.status_changed`; `trademark.retracted` / `trademark.corrected` are opt-in). The search text filters (`mark_text_*`) and exclusions (`exclude`, `*_not`) are not accepted on watches. Deprecated until 2026-12-28: `strategies` (replaced by `similarity`) and `min_match_tier` (replaced by `min_tier`). A write that uses them is kept as a legacy watch with its original matching until it is re-saved without them, and each is reported in the response `deprecations`; sending old and new keys together is 400 `conflicting_params`. Stored watches keep the matching they were saved with; a PATCH whose query equals the stored one changes nothing, one that differs only where a write normalises it (such as offices added from jurisdictions, or code and ID casing) is saved in that form with the same matching, and a PATCH that changes it re-saves it under these rules. `filters.offices` takes WIPO ST.3 codes (`US`, `EM`, …; legacy `uspto`/`euipo`/`EU` accepted); `filters.jurisdictions` without `filters.offices` is auto-translated to the live offices for those jurisdictions and is rejected with 400 `no_live_office` when none resolves. `score_threshold` is NOT accepted on write (400) — match scores are informational via `match.score` on alerts — and is never echoed on read.
+                         * @description Watch query JSON (max 50,000 bytes serialized, depth 5; larger bodies are 400 `validation_error`). `version` is required: `v1`, `v2` and `v3` are accepted, and a new or changed query is stored as a v3 similarity watch whatever `version` it sends (`version` is set to `v3`) unless it uses the deprecated keys below: `q` (string), optional `similarity` (the search channels: `identical`, `fuzzy`, `embedded`, `phonetic`, `lookalike`; default `identical,fuzzy,embedded,lookalike`, `identical` always on), optional `min_tier` (the weakest similarity tier that alerts: `identical`, `near_identical`, `similar`, `related`; default `related`, everything through), `filters`, and optional `trigger_events` (default: `trademark.created`, `trademark.updated`, `trademark.status_changed`; `trademark.retracted` / `trademark.corrected` are opt-in; `trademark.corrected` also covers a status Signa corrected, including a lapse or a reversal shown by office records that reached Signa late, which then never arrives as `trademark.status_changed` / `trademark.updated`). The search text filters (`mark_text_*`) and exclusions (`exclude`, `*_not`) are not accepted on watches. Deprecated until 2026-12-28: `strategies` (replaced by `similarity`) and `min_match_tier` (replaced by `min_tier`). A write that uses them is kept as a legacy watch with its original matching until it is re-saved without them, and each is reported in the response `deprecations`; sending old and new keys together is 400 `conflicting_params`. Stored watches keep the matching they were saved with; a PATCH whose query equals the stored one changes nothing, one that differs only where a write normalises it (such as offices added from jurisdictions, or code and ID casing) is saved in that form and not migrated (a legacy watch stays legacy), though the saved form can change what it matches (a jurisdictions-only watch is evaluated once offices are added), and a PATCH that changes it re-saves it under these rules. `filters.offices` takes WIPO ST.3 codes (`US`, `EM`, …; legacy `uspto`/`euipo`/`EU` accepted); `filters.jurisdictions` without `filters.offices` is auto-translated to the live offices for those jurisdictions and is rejected with 400 `no_live_office` when none resolves. `score_threshold` is NOT accepted on write (400), since match scores are informational via `match.score` on alerts, and is never echoed on read.
                          * @example {
                          *       "version": "v3",
                          *       "q": "acme",
@@ -17890,6 +18071,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Insufficient credits — `insufficient_credits_for_watch`: the pooled credit balance cannot fund the minimum monitoring window for a new watch (charged plans only). Extensions carry `credit_balance`, `credit_required`, `monitoring_daily_cost`, `required_days`. */
             402: {
                 headers: {
@@ -17955,6 +18145,15 @@ export interface operations {
                     "application/json": components["schemas"]["MonitoringStatus"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     listWebhookEndpoints: {
@@ -17987,6 +18186,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     createWebhookEndpoint: {
@@ -18004,7 +18212,7 @@ export interface operations {
                 "application/json": {
                     url: string;
                     description?: string;
-                    /** @description Events delivered to this endpoint. Accepted values: alert.created, trademark.status_changed, office_action.issued. trademark.status_changed and office_action.issued are delivered only for marks in one of the organization's portfolios. alert.created follows watch scope. */
+                    /** @description Events delivered to this endpoint. Accepted values: alert.created, trademark.status_changed, trademark.corrected, office_action.issued. trademark.status_changed, trademark.corrected and office_action.issued are delivered only for marks in one of the organization's portfolios; trademark.status_changed also delivers trademark.corrected. alert.created follows watch scope. */
                     enabled_events: string[];
                     /** @description Limit this endpoint to events on marks in this portfolio (ptf_*). Applies to every event type, alert.created included: an alert is delivered only when its matched mark was a member of the portfolio at event time. */
                     portfolio_id?: string | null;
@@ -18033,6 +18241,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Portfolio not found */
             404: {
                 headers: {
@@ -18064,6 +18281,15 @@ export interface operations {
                     "application/json": components["schemas"]["WebhookEndpoint"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -18105,6 +18331,15 @@ export interface operations {
                     };
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -18133,7 +18368,7 @@ export interface operations {
                 "application/json": {
                     url?: string;
                     description?: string | null;
-                    /** @description Events delivered to this endpoint. Accepted values: alert.created, trademark.status_changed, office_action.issued. trademark.status_changed and office_action.issued are delivered only for marks in one of the organization's portfolios. alert.created follows watch scope. */
+                    /** @description Events delivered to this endpoint. Accepted values: alert.created, trademark.status_changed, trademark.corrected, office_action.issued. trademark.status_changed, trademark.corrected and office_action.issued are delivered only for marks in one of the organization's portfolios; trademark.status_changed also delivers trademark.corrected. alert.created follows watch scope. */
                     enabled_events?: string[];
                     /** @description Limit this endpoint to events on marks in this portfolio (ptf_*), or null to clear. Applies to every event type, alert.created included: an alert is delivered only when its matched mark was a member of the portfolio at event time. */
                     portfolio_id?: string | null;
@@ -18164,6 +18399,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -18200,6 +18444,15 @@ export interface operations {
                     "application/json": components["schemas"]["WebhookEndpoint"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -18248,6 +18501,15 @@ export interface operations {
                     };
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -18301,6 +18563,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -18333,6 +18604,15 @@ export interface operations {
                     "application/json": components["schemas"]["WebhookDelivery"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -18373,6 +18653,15 @@ export interface operations {
                     };
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -18439,6 +18728,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Missing events:read scope */
             403: {
                 headers: {
@@ -18497,6 +18795,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Missing events:read scope */
             403: {
                 headers: {
@@ -19755,6 +20062,11 @@ export interface operations {
                      * @enum {string}
                      */
                     interval?: "monthly" | "annual";
+                    /**
+                     * @description Undo only: `plan` and `interval` name the current plan, and the request may only cancel the change scheduled here (`applied`, nothing charged). If no such change is pending (it already took effect or was cancelled), the request is refused 409 `plan_change_blocked` (`scheduled_change_not_pending`) and nothing is changed or charged. Omitted or false: an ordinary plan change.
+                     * @example true
+                     */
+                    undo_scheduled_change?: boolean;
                 };
             };
         };
@@ -19804,7 +20116,7 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The organization has no live subscription to change (type `no_live_subscription`; subscribe through checkout); the subscription cannot take the change (type `plan_change_blocked`, with `reason`: `cancelling` — set to cancel; `scheduled` — a change is already scheduled; `no_period_end`; `not_self_serve` — an enterprise contract; `unresolved_price`; `pending_payment` — a different change is parked awaiting its payment; a repeat of the SAME parked change answers 200 pending_payment with the same invoice); or billing changes are paused while a payment dispute is open or after it was lost (type `billing_hold`; contact support); or the organization is suspended for an unpaid subscription invoice (type `billing_suspended`; the plan comes back when the invoice is paid). A past-due organization whose plan is still paid for can change plan. */
+            /** @description The organization has no live subscription to change (type `no_live_subscription`; subscribe through checkout); the subscription cannot take the change (type `plan_change_blocked`, with `reason`: `cancelling` — set to cancel; `scheduled` — the subscription is managed by a schedule Signa did not set up (contact support); `no_period_end`; `not_self_serve` — an enterprise contract; `unresolved_price`; `pending_payment` — a different change is parked awaiting its payment; a repeat of the SAME parked change answers 200 pending_payment with the same invoice; `scheduled_change_pending` — an upgrade (or a longer interval) while a change made here is scheduled: undo it first by requesting the current plan and interval; `scheduled_change_not_pending` — `undo_scheduled_change` was set but no change made here is pending, nothing was changed or charged); or billing changes are paused while a payment dispute is open or after it was lost (type `billing_hold`; contact support); or the organization is suspended for an unpaid subscription invoice (type `billing_suspended`; the plan comes back when the invoice is paid). A past-due organization whose plan is still paid for can change plan. */
             409: {
                 headers: {
                     [name: string]: unknown;