@signa-so/sdk 0.16.0 → 0.17.0

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

@@ -541,14 +541,14 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * @description GET variant of trademark search/list. Same multi-strategy search as POST, with flat query params.
+         * @description GET variant of trademark search/list. Same search as POST, with flat query params.
          *
          *     Credits: 10 per page.
          */
         get: operations["listTrademarks"];
         put?: never;
         /**
-         * @description Multi-strategy text and phonetic search with faceted aggregations and relevance scoring. When query is omitted, acts as a filtered list (requires at least one filter). When sort is specified with query, relevance_score is null and rescore is disabled.
+         * @description Trademark search: q ranks marks through the similarity channels, filters (filters.mark_text included) decide which marks qualify, exclude removes marks, with faceted aggregations. Without q, acts as a filtered list (requires a filter or a mark_text operator). relevance_score is present on every hit whenever there is a q, whatever the sort.
          *
          *     Credits: 10 per page.
          */
@@ -1122,7 +1122,7 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * @description List an entity's trademarks (summary tier) across ALL member owners, with full Appendix A filter support. Identical to GET /v1/owners/{id}/trademarks per-member, fanned across the entity's members. Rate class: search.
+         * @description List an entity's trademarks (summary tier): every mark whose owner is linked to the entity, with full Appendix A filter support. Scoped exactly like GET /v1/trademarks?entity_id= (the same resolved entity ids, no member-owner cap), so both return the same set for the same entity; the difference is that a missing entity is a 404 here and an empty page there. Rate class: search.
          *
          *     Credits: 10 per page.
          */
@@ -2557,6 +2557,12 @@ export interface components {
              */
             stage: string;
             reason: string | null;
+            /**
+             * @description Pending challenges against the record. On an IR family row, the de-duplicated union across its designations.
+             * @example [
+             *       "opposition_pending"
+             *     ]
+             */
             challenges: string[];
             /**
              * @description Office-reported date when the current status took effect, when available.
@@ -3176,7 +3182,23 @@ export interface components {
                 /** @example image/jpeg */
                 mime_type: string | null;
                 url: string;
+                /** @description Exactly one item is primary when `primary_image_url` is set: the item that URL points at. */
                 is_primary: boolean;
+                /**
+                 * @description Signa's classification of the office's document type for a document item (office_action, certificate, correspondence, filed_form, other), the same value `GET /v1/trademarks/{id}/documents` serves; null for images.
+                 * @example office_action
+                 */
+                document_kind: string | null;
+                /**
+                 * @description The office's date on the document (mailing or issue date), as published; null when none.
+                 * @example 2025-02-03
+                 */
+                official_date: string | null;
+                /**
+                 * @description Page count of a document item, as published by the office; null when none.
+                 * @example 4
+                 */
+                page_count: number | null;
             }[];
             priority_claims: {
                 /** @example paris */
@@ -3386,6 +3408,45 @@ export interface components {
              */
             matched_via_kind: "direct" | "regional_membership";
         };
+        /** @description Why the hit is in the result set. Search responses only; on a metadata-only listing (no q, no positive mark_text operator) tier is null and via and terms are empty. */
+        TrademarkMatch: {
+            /**
+             * @description The strongest similarity tier of the lanes this hit matched: identical, near_identical, similar or related. Tiers are retrieval categories, not measured edit distances. Null for rows matched only by a trademark number in q, and for rows of a request without q.
+             * @example near_identical
+             * @enum {string|null}
+             */
+            tier: "identical" | "near_identical" | "similar" | "related" | null;
+            /**
+             * @description The similarity channels that matched this hit, plus `identifier` when q was read as a trademark number. Empty without q.
+             * @example [
+             *       "fuzzy"
+             *     ]
+             */
+            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.
+             * @example []
+             */
+            terms: string[];
+            /** @description Only with include=match_details. */
+            details?: {
+                /**
+                 * @description Internal retrieval lane names that matched.
+                 * @example [
+                 *       "fuzzy_1",
+                 *       "phonetic_strong"
+                 *     ]
+                 */
+                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. */
+                factors: {
+                    /** @example live_status */
+                    factor: string;
+                    /** @example 1.3 */
+                    weight: number;
+                }[];
+            };
+        };
         /** @description Shape-identical to a /v1/trademarks summary row, minus relevance_score / match_explanation. */
         TrademarkSummaryV1: {
             /** @example tm_7d4e1f2a3b8c9d0e */
@@ -3563,11 +3624,12 @@ export interface components {
             /** @description Search responses only, when a jurisdictions filter is active under the default protection mode: why this hit satisfied it. */
             territory_matches?: components["schemas"]["TerritoryMatch"][];
             /**
-             * @description Search responses only: relevance (0–100) for the ranked `similar` mode. Null when ranking is bypassed (explicit sort or a deterministic match mode); absent without a text query.
+             * @description Search responses only: how well the hit matches q (0–100), for ordering only, not a likelihood of confusion. Present on every hit when q is present, whatever the sort (under a sort the length factor does not apply). Null for rows matched only by a trademark number, for mark_text-only requests, and on metadata-only listings.
              * @example 87
              */
             relevance_score?: number | null;
-            /** @description Search responses only. Null when ranking is bypassed; absent without a text query. */
+            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 [
@@ -3608,7 +3670,7 @@ export interface components {
                 [key: string]: string[];
             } | null;
             /**
-             * @description List searches only (q sent as a list): the terms (as the caller spelled them) this hit is an exact match for.
+             * @description Deprecated (removed after the 90-day window): read `match.terms`. Present when the request has a positive mark_text operator.
              * @example [
              *       "limber"
              *     ]
@@ -5249,21 +5311,81 @@ export interface components {
                  */
                 query: string | null;
                 /**
-                 * @description Public search strategies used for the served result set. Empty for deterministic match modes.
+                 * @description Deprecated (removed after the 90-day window): read `similarity_applied`. The applied channels in the old strategy vocabulary.
                  * @example [
                  *       "exact",
-                 *       "phonetic",
                  *       "fuzzy",
                  *       "prefix"
                  *     ]
                  */
                 strategies_used: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
                 /**
-                 * @description How the query matched the mark text. 'similar' runs the ranked ladder; exact/starts_with/ends_with/contains are deterministic (relevance_score is null on every row).
+                 * @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 [
+                 *       "identical",
+                 *       "fuzzy",
+                 *       "embedded",
+                 *       "lookalike"
+                 *     ]
+                 */
+                similarity_applied: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[];
+                /**
+                 * @description Version of the ranking that ordered this response. Cursors are bound to it: a new version restarts pagination (400 `cursor_invalid`).
+                 * @example v12
+                 */
+                ranking_version: string;
+                /**
+                 * @description The order applied: `relevance` (q present), `mark_text_fit` (text order for a mark_text-only request), `filing_date` (newest filing first), or the explicit `sort` string.
+                 * @example relevance
+                 */
+                order: string;
+                /**
+                 * @description False only when the search hit its time limit or lost a shard and the request set allow_partial; the page may then be missing matches. Without allow_partial such a search returns 503.
+                 * @example true
+                 */
+                complete: boolean;
+                /**
+                 * @description Why `complete` is false. Omitted when complete.
+                 * @example timeout
+                 * @enum {string}
+                 */
+                incomplete_reason?: "timeout" | "shard_failure";
+                /** @description Present when q was read as a trademark number: those records are looked up besides the ranked text match and listed first. */
+                identifier?: {
+                    /**
+                     * @description WIPO ST.3 code when q names or implies one office; null for a bare number.
+                     * @example US
+                     */
+                    office: string | null;
+                    /**
+                     * @example number
+                     * @enum {string}
+                     */
+                    kind: "application" | "registration" | "ir" | "signa_id" | "number";
+                    /**
+                     * @description The number in the office's stored form (a tm_ id for signa_id).
+                     * @example 1939139
+                     */
+                    number: string;
+                };
+                /** @description The deprecated parameters this request used, each with its replacement. Omitted when none. */
+                deprecations?: {
+                    /** @example strategies */
+                    param: string;
+                    /** @example similarity */
+                    replacement: string;
+                    /**
+                     * @description Date (UTC) from which the deprecated parameter is rejected.
+                     * @example 2026-12-28
+                     */
+                    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.
                  * @example grouped
@@ -5281,24 +5403,24 @@ export interface components {
                  * @enum {string}
                  */
                 territory_match: "protection" | "direct";
-                /** @description Coded search warnings: per-strategy skip warnings (a REQUESTED strategy produced zero clauses for the query shape — e.g. strategies=[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), 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: `<strategy>_skipped` (a requested strategy produced no clauses), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `partial_results` (the search hit its time limit or lost a shard; the page may be missing matches), `strategies_reduced` (OpenSearch rejected the full query and it was retried with fewer strategies; see `dropped_strategies`), `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 `q` term, or a term of a `q` list, under a deterministic `match` mode mixes Latin with Greek or Cyrillic letters, which that mode compares 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`), `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;
                     /**
                      * @description Human-readable explanation of the warning.
-                     * @example phonetic_skipped: the phonetic strategy produced no clauses for this query.
+                     * @example phonetic_skipped: the phonetic similarity channel produced no clauses for this query.
                      */
                     message: string;
                     /**
-                     * @description For strategy-skip warnings, the requested strategy that produced no clauses.
+                     * @description For `<channel>_skipped` warnings, the requested similarity channel that produced no clauses.
                      * @example phonetic
                      * @enum {string}
                      */
-                    strategy?: "exact" | "phonetic" | "fuzzy" | "prefix";
+                    channel?: "identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike";
                     /**
                      * @description Warning severity (filter-coverage warnings).
                      * @example warning
@@ -5317,13 +5439,6 @@ export interface components {
                      *     ]
                      */
                     affected_offices?: string[];
-                    /**
-                     * @description For `strategies_reduced` warnings, the requested strategies the retry dropped.
-                     * @example [
-                     *       "fuzzy"
-                     *     ]
-                     */
-                    dropped_strategies?: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
                     /**
                      * @description For `expanded_fallback` warnings, the filter(s) the grouped view could not serve. Two entries mean the pair could hold on different designations of one mark.
                      * @example [
@@ -5356,6 +5471,33 @@ export interface components {
             aggregation_metadata?: components["schemas"]["AggregationMetadata"];
             request_id: string;
         };
+        /** @description Mark text operators. Values within one operator are OR; operators are AND. Up to 100 values of 200 characters each. */
+        MarkTextFilters: {
+            /** @description Whole-mark equality (case, accents, punctuation, spacing and trademark notices ignored). */
+            is?: string[];
+            /** @description The value appears as a whole word, or consecutive words, of the mark. */
+            word?: string[];
+            /** @description The folded mark begins with the value. */
+            starts_with?: string[];
+            /** @description The folded mark ends with the value. At least 3 characters. */
+            ends_with?: string[];
+            /** @description The value appears anywhere in the folded mark. At least 3 characters. */
+            contains?: string[];
+            /** @description `*` any run, `?` one character, `\` escapes the next character; everything else literal. */
+            pattern?: string[];
+        };
+        /** @description Exclusions: rows matching any value are removed. Never affects ranking. */
+        SearchExclude: {
+            mark_text?: components["schemas"]["MarkTextFilters"];
+            /** @description Exclude marks whose owners are linked to these entities (ent_...). */
+            entity_id?: string[];
+            /** @description Exclude marks linked to any entity in these entities' corporate families (ent_...). */
+            entity_group?: string[];
+            /** @description Exclude marks held by these owners (own_...). */
+            owner_id?: string[];
+            /** @description Exclude these trademarks (tm_...); on the grouped view, the family row containing them. */
+            trademark_ids?: string[];
+        };
         TrademarkEvent: {
             /** @example hst_7d4e1f2a-3b8c-4d0e-9f1a-2b3c4d5e6f70 */
             id: string;
@@ -6092,21 +6234,81 @@ export interface components {
                  */
                 query: string | null;
                 /**
-                 * @description Public search strategies used for the served result set. Empty for deterministic match modes.
+                 * @description Deprecated (removed after the 90-day window): read `similarity_applied`. The applied channels in the old strategy vocabulary.
                  * @example [
                  *       "exact",
-                 *       "phonetic",
                  *       "fuzzy",
                  *       "prefix"
                  *     ]
                  */
                 strategies_used: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
                 /**
-                 * @description How the query matched the mark text. 'similar' runs the ranked ladder; exact/starts_with/ends_with/contains are deterministic (relevance_score is null on every row).
+                 * @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 [
+                 *       "identical",
+                 *       "fuzzy",
+                 *       "embedded",
+                 *       "lookalike"
+                 *     ]
+                 */
+                similarity_applied: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[];
+                /**
+                 * @description Version of the ranking that ordered this response. Cursors are bound to it: a new version restarts pagination (400 `cursor_invalid`).
+                 * @example v12
+                 */
+                ranking_version: string;
+                /**
+                 * @description The order applied: `relevance` (q present), `mark_text_fit` (text order for a mark_text-only request), `filing_date` (newest filing first), or the explicit `sort` string.
+                 * @example relevance
+                 */
+                order: string;
+                /**
+                 * @description False only when the search hit its time limit or lost a shard and the request set allow_partial; the page may then be missing matches. Without allow_partial such a search returns 503.
+                 * @example true
+                 */
+                complete: boolean;
+                /**
+                 * @description Why `complete` is false. Omitted when complete.
+                 * @example timeout
+                 * @enum {string}
+                 */
+                incomplete_reason?: "timeout" | "shard_failure";
+                /** @description Present when q was read as a trademark number: those records are looked up besides the ranked text match and listed first. */
+                identifier?: {
+                    /**
+                     * @description WIPO ST.3 code when q names or implies one office; null for a bare number.
+                     * @example US
+                     */
+                    office: string | null;
+                    /**
+                     * @example number
+                     * @enum {string}
+                     */
+                    kind: "application" | "registration" | "ir" | "signa_id" | "number";
+                    /**
+                     * @description The number in the office's stored form (a tm_ id for signa_id).
+                     * @example 1939139
+                     */
+                    number: string;
+                };
+                /** @description The deprecated parameters this request used, each with its replacement. Omitted when none. */
+                deprecations?: {
+                    /** @example strategies */
+                    param: string;
+                    /** @example similarity */
+                    replacement: string;
+                    /**
+                     * @description Date (UTC) from which the deprecated parameter is rejected.
+                     * @example 2026-12-28
+                     */
+                    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.
                  * @example grouped
@@ -6124,24 +6326,24 @@ export interface components {
                  * @enum {string}
                  */
                 territory_match: "protection" | "direct";
-                /** @description Coded search warnings: per-strategy skip warnings (a REQUESTED strategy produced zero clauses for the query shape — e.g. strategies=[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), 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: `<strategy>_skipped` (a requested strategy produced no clauses), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `partial_results` (the search hit its time limit or lost a shard; the page may be missing matches), `strategies_reduced` (OpenSearch rejected the full query and it was retried with fewer strategies; see `dropped_strategies`), `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 `q` term, or a term of a `q` list, under a deterministic `match` mode mixes Latin with Greek or Cyrillic letters, which that mode compares 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`), `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;
                     /**
                      * @description Human-readable explanation of the warning.
-                     * @example phonetic_skipped: the phonetic strategy produced no clauses for this query.
+                     * @example phonetic_skipped: the phonetic similarity channel produced no clauses for this query.
                      */
                     message: string;
                     /**
-                     * @description For strategy-skip warnings, the requested strategy that produced no clauses.
+                     * @description For `<channel>_skipped` warnings, the requested similarity channel that produced no clauses.
                      * @example phonetic
                      * @enum {string}
                      */
-                    strategy?: "exact" | "phonetic" | "fuzzy" | "prefix";
+                    channel?: "identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike";
                     /**
                      * @description Warning severity (filter-coverage warnings).
                      * @example warning
@@ -6160,13 +6362,6 @@ export interface components {
                      *     ]
                      */
                     affected_offices?: string[];
-                    /**
-                     * @description For `strategies_reduced` warnings, the requested strategies the retry dropped.
-                     * @example [
-                     *       "fuzzy"
-                     *     ]
-                     */
-                    dropped_strategies?: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
                     /**
                      * @description For `expanded_fallback` warnings, the filter(s) the grouped view could not serve. Two entries mean the pair could hold on different designations of one mark.
                      * @example [
@@ -6348,21 +6543,81 @@ export interface components {
                  */
                 query: string | null;
                 /**
-                 * @description Public search strategies used for the served result set. Empty for deterministic match modes.
+                 * @description Deprecated (removed after the 90-day window): read `similarity_applied`. The applied channels in the old strategy vocabulary.
                  * @example [
                  *       "exact",
-                 *       "phonetic",
                  *       "fuzzy",
                  *       "prefix"
                  *     ]
                  */
                 strategies_used: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
                 /**
-                 * @description How the query matched the mark text. 'similar' runs the ranked ladder; exact/starts_with/ends_with/contains are deterministic (relevance_score is null on every row).
+                 * @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 [
+                 *       "identical",
+                 *       "fuzzy",
+                 *       "embedded",
+                 *       "lookalike"
+                 *     ]
+                 */
+                similarity_applied: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[];
+                /**
+                 * @description Version of the ranking that ordered this response. Cursors are bound to it: a new version restarts pagination (400 `cursor_invalid`).
+                 * @example v12
+                 */
+                ranking_version: string;
+                /**
+                 * @description The order applied: `relevance` (q present), `mark_text_fit` (text order for a mark_text-only request), `filing_date` (newest filing first), or the explicit `sort` string.
+                 * @example relevance
+                 */
+                order: string;
+                /**
+                 * @description False only when the search hit its time limit or lost a shard and the request set allow_partial; the page may then be missing matches. Without allow_partial such a search returns 503.
+                 * @example true
+                 */
+                complete: boolean;
+                /**
+                 * @description Why `complete` is false. Omitted when complete.
+                 * @example timeout
+                 * @enum {string}
+                 */
+                incomplete_reason?: "timeout" | "shard_failure";
+                /** @description Present when q was read as a trademark number: those records are looked up besides the ranked text match and listed first. */
+                identifier?: {
+                    /**
+                     * @description WIPO ST.3 code when q names or implies one office; null for a bare number.
+                     * @example US
+                     */
+                    office: string | null;
+                    /**
+                     * @example number
+                     * @enum {string}
+                     */
+                    kind: "application" | "registration" | "ir" | "signa_id" | "number";
+                    /**
+                     * @description The number in the office's stored form (a tm_ id for signa_id).
+                     * @example 1939139
+                     */
+                    number: string;
+                };
+                /** @description The deprecated parameters this request used, each with its replacement. Omitted when none. */
+                deprecations?: {
+                    /** @example strategies */
+                    param: string;
+                    /** @example similarity */
+                    replacement: string;
+                    /**
+                     * @description Date (UTC) from which the deprecated parameter is rejected.
+                     * @example 2026-12-28
+                     */
+                    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.
                  * @example grouped
@@ -6380,24 +6635,24 @@ export interface components {
                  * @enum {string}
                  */
                 territory_match: "protection" | "direct";
-                /** @description Coded search warnings: per-strategy skip warnings (a REQUESTED strategy produced zero clauses for the query shape — e.g. strategies=[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), 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: `<strategy>_skipped` (a requested strategy produced no clauses), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `partial_results` (the search hit its time limit or lost a shard; the page may be missing matches), `strategies_reduced` (OpenSearch rejected the full query and it was retried with fewer strategies; see `dropped_strategies`), `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 `q` term, or a term of a `q` list, under a deterministic `match` mode mixes Latin with Greek or Cyrillic letters, which that mode compares 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`), `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;
                     /**
                      * @description Human-readable explanation of the warning.
-                     * @example phonetic_skipped: the phonetic strategy produced no clauses for this query.
+                     * @example phonetic_skipped: the phonetic similarity channel produced no clauses for this query.
                      */
                     message: string;
                     /**
-                     * @description For strategy-skip warnings, the requested strategy that produced no clauses.
+                     * @description For `<channel>_skipped` warnings, the requested similarity channel that produced no clauses.
                      * @example phonetic
                      * @enum {string}
                      */
-                    strategy?: "exact" | "phonetic" | "fuzzy" | "prefix";
+                    channel?: "identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike";
                     /**
                      * @description Warning severity (filter-coverage warnings).
                      * @example warning
@@ -6416,13 +6671,6 @@ export interface components {
                      *     ]
                      */
                     affected_offices?: string[];
-                    /**
-                     * @description For `strategies_reduced` warnings, the requested strategies the retry dropped.
-                     * @example [
-                     *       "fuzzy"
-                     *     ]
-                     */
-                    dropped_strategies?: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
                     /**
                      * @description For `expanded_fallback` warnings, the filter(s) the grouped view could not serve. Two entries mean the pair could hold on different designations of one mark.
                      * @example [
@@ -6613,21 +6861,81 @@ export interface components {
                  */
                 query: string | null;
                 /**
-                 * @description Public search strategies used for the served result set. Empty for deterministic match modes.
+                 * @description Deprecated (removed after the 90-day window): read `similarity_applied`. The applied channels in the old strategy vocabulary.
                  * @example [
                  *       "exact",
-                 *       "phonetic",
                  *       "fuzzy",
                  *       "prefix"
                  *     ]
                  */
                 strategies_used: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
                 /**
-                 * @description How the query matched the mark text. 'similar' runs the ranked ladder; exact/starts_with/ends_with/contains are deterministic (relevance_score is null on every row).
+                 * @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 [
+                 *       "identical",
+                 *       "fuzzy",
+                 *       "embedded",
+                 *       "lookalike"
+                 *     ]
+                 */
+                similarity_applied: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[];
+                /**
+                 * @description Version of the ranking that ordered this response. Cursors are bound to it: a new version restarts pagination (400 `cursor_invalid`).
+                 * @example v12
+                 */
+                ranking_version: string;
+                /**
+                 * @description The order applied: `relevance` (q present), `mark_text_fit` (text order for a mark_text-only request), `filing_date` (newest filing first), or the explicit `sort` string.
+                 * @example relevance
+                 */
+                order: string;
+                /**
+                 * @description False only when the search hit its time limit or lost a shard and the request set allow_partial; the page may then be missing matches. Without allow_partial such a search returns 503.
+                 * @example true
+                 */
+                complete: boolean;
+                /**
+                 * @description Why `complete` is false. Omitted when complete.
+                 * @example timeout
+                 * @enum {string}
+                 */
+                incomplete_reason?: "timeout" | "shard_failure";
+                /** @description Present when q was read as a trademark number: those records are looked up besides the ranked text match and listed first. */
+                identifier?: {
+                    /**
+                     * @description WIPO ST.3 code when q names or implies one office; null for a bare number.
+                     * @example US
+                     */
+                    office: string | null;
+                    /**
+                     * @example number
+                     * @enum {string}
+                     */
+                    kind: "application" | "registration" | "ir" | "signa_id" | "number";
+                    /**
+                     * @description The number in the office's stored form (a tm_ id for signa_id).
+                     * @example 1939139
+                     */
+                    number: string;
+                };
+                /** @description The deprecated parameters this request used, each with its replacement. Omitted when none. */
+                deprecations?: {
+                    /** @example strategies */
+                    param: string;
+                    /** @example similarity */
+                    replacement: string;
+                    /**
+                     * @description Date (UTC) from which the deprecated parameter is rejected.
+                     * @example 2026-12-28
+                     */
+                    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.
                  * @example grouped
@@ -6645,24 +6953,24 @@ export interface components {
                  * @enum {string}
                  */
                 territory_match: "protection" | "direct";
-                /** @description Coded search warnings: per-strategy skip warnings (a REQUESTED strategy produced zero clauses for the query shape — e.g. strategies=[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), 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: `<strategy>_skipped` (a requested strategy produced no clauses), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `partial_results` (the search hit its time limit or lost a shard; the page may be missing matches), `strategies_reduced` (OpenSearch rejected the full query and it was retried with fewer strategies; see `dropped_strategies`), `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 `q` term, or a term of a `q` list, under a deterministic `match` mode mixes Latin with Greek or Cyrillic letters, which that mode compares 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`), `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;
                     /**
                      * @description Human-readable explanation of the warning.
-                     * @example phonetic_skipped: the phonetic strategy produced no clauses for this query.
+                     * @example phonetic_skipped: the phonetic similarity channel produced no clauses for this query.
                      */
                     message: string;
                     /**
-                     * @description For strategy-skip warnings, the requested strategy that produced no clauses.
+                     * @description For `<channel>_skipped` warnings, the requested similarity channel that produced no clauses.
                      * @example phonetic
                      * @enum {string}
                      */
-                    strategy?: "exact" | "phonetic" | "fuzzy" | "prefix";
+                    channel?: "identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike";
                     /**
                      * @description Warning severity (filter-coverage warnings).
                      * @example warning
@@ -6681,13 +6989,6 @@ export interface components {
                      *     ]
                      */
                     affected_offices?: string[];
-                    /**
-                     * @description For `strategies_reduced` warnings, the requested strategies the retry dropped.
-                     * @example [
-                     *       "fuzzy"
-                     *     ]
-                     */
-                    dropped_strategies?: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
                     /**
                      * @description For `expanded_fallback` warnings, the filter(s) the grouped view could not serve. Two entries mean the pair could hold on different designations of one mark.
                      * @example [
@@ -6929,21 +7230,81 @@ export interface components {
                  */
                 query: string | null;
                 /**
-                 * @description Public search strategies used for the served result set. Empty for deterministic match modes.
+                 * @description Deprecated (removed after the 90-day window): read `similarity_applied`. The applied channels in the old strategy vocabulary.
                  * @example [
                  *       "exact",
-                 *       "phonetic",
                  *       "fuzzy",
                  *       "prefix"
                  *     ]
                  */
                 strategies_used: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
                 /**
-                 * @description How the query matched the mark text. 'similar' runs the ranked ladder; exact/starts_with/ends_with/contains are deterministic (relevance_score is null on every row).
+                 * @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 [
+                 *       "identical",
+                 *       "fuzzy",
+                 *       "embedded",
+                 *       "lookalike"
+                 *     ]
+                 */
+                similarity_applied: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[];
+                /**
+                 * @description Version of the ranking that ordered this response. Cursors are bound to it: a new version restarts pagination (400 `cursor_invalid`).
+                 * @example v12
+                 */
+                ranking_version: string;
+                /**
+                 * @description The order applied: `relevance` (q present), `mark_text_fit` (text order for a mark_text-only request), `filing_date` (newest filing first), or the explicit `sort` string.
+                 * @example relevance
+                 */
+                order: string;
+                /**
+                 * @description False only when the search hit its time limit or lost a shard and the request set allow_partial; the page may then be missing matches. Without allow_partial such a search returns 503.
+                 * @example true
+                 */
+                complete: boolean;
+                /**
+                 * @description Why `complete` is false. Omitted when complete.
+                 * @example timeout
+                 * @enum {string}
+                 */
+                incomplete_reason?: "timeout" | "shard_failure";
+                /** @description Present when q was read as a trademark number: those records are looked up besides the ranked text match and listed first. */
+                identifier?: {
+                    /**
+                     * @description WIPO ST.3 code when q names or implies one office; null for a bare number.
+                     * @example US
+                     */
+                    office: string | null;
+                    /**
+                     * @example number
+                     * @enum {string}
+                     */
+                    kind: "application" | "registration" | "ir" | "signa_id" | "number";
+                    /**
+                     * @description The number in the office's stored form (a tm_ id for signa_id).
+                     * @example 1939139
+                     */
+                    number: string;
+                };
+                /** @description The deprecated parameters this request used, each with its replacement. Omitted when none. */
+                deprecations?: {
+                    /** @example strategies */
+                    param: string;
+                    /** @example similarity */
+                    replacement: string;
+                    /**
+                     * @description Date (UTC) from which the deprecated parameter is rejected.
+                     * @example 2026-12-28
+                     */
+                    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.
                  * @example grouped
@@ -6961,24 +7322,24 @@ export interface components {
                  * @enum {string}
                  */
                 territory_match: "protection" | "direct";
-                /** @description Coded search warnings: per-strategy skip warnings (a REQUESTED strategy produced zero clauses for the query shape — e.g. strategies=[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), 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: `<strategy>_skipped` (a requested strategy produced no clauses), `partial_opposition_coverage` / `partial_seniority_coverage` (filter coverage), `partial_results` (the search hit its time limit or lost a shard; the page may be missing matches), `strategies_reduced` (OpenSearch rejected the full query and it was retried with fewer strategies; see `dropped_strategies`), `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 `q` term, or a term of a `q` list, under a deterministic `match` mode mixes Latin with Greek or Cyrillic letters, which that mode compares 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`), `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;
                     /**
                      * @description Human-readable explanation of the warning.
-                     * @example phonetic_skipped: the phonetic strategy produced no clauses for this query.
+                     * @example phonetic_skipped: the phonetic similarity channel produced no clauses for this query.
                      */
                     message: string;
                     /**
-                     * @description For strategy-skip warnings, the requested strategy that produced no clauses.
+                     * @description For `<channel>_skipped` warnings, the requested similarity channel that produced no clauses.
                      * @example phonetic
                      * @enum {string}
                      */
-                    strategy?: "exact" | "phonetic" | "fuzzy" | "prefix";
+                    channel?: "identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike";
                     /**
                      * @description Warning severity (filter-coverage warnings).
                      * @example warning
@@ -6997,13 +7358,6 @@ export interface components {
                      *     ]
                      */
                     affected_offices?: string[];
-                    /**
-                     * @description For `strategies_reduced` warnings, the requested strategies the retry dropped.
-                     * @example [
-                     *       "fuzzy"
-                     *     ]
-                     */
-                    dropped_strategies?: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
                     /**
                      * @description For `expanded_fallback` warnings, the filter(s) the grouped view could not serve. Two entries mean the pair could hold on different designations of one mark.
                      * @example [
@@ -9140,11 +9494,16 @@ export interface components {
                     /** @description Present and `true` when the change diff was bounded (entries dropped past the max count, or an over-long from/to value replaced with a sentinel, or a byte-budget cap hit). Absent when the diff is complete. */
                     diff_truncated?: boolean;
                 };
-                /** @description Match metadata (why/how the mark matched the watch). Null for pure-filter / pre-v2 alerts that carry no match scoring. */
+                /** @description Match metadata (why/how the mark matched the watch). Null for pure-filter / pre-v2 alerts that carry no match scoring. `score` is the engine score for the watch query, not the 0-100 search `relevance_score`. */
                 match: {
                     reason: string | null;
                     score: number | null;
                     score_basis: string | null;
+                    /**
+                     * @description Similarity tier of the matched mark, the same label a search hit carries as `match.tier` (identical, near_identical, similar, related). A retrieval category, not a measured edit distance. Null for filter-only watches, marks found only by their number, and alerts emitted before the field existed.
+                     * @enum {string|null}
+                     */
+                    tier: "identical" | "near_identical" | "similar" | "related" | null;
                 } | null;
                 trademark: components["schemas"]["AlertTrademark"];
                 deadline: {
@@ -9219,11 +9578,16 @@ export interface components {
                 /** @description Present and `true` when the change diff was bounded (entries dropped past the max count, or an over-long from/to value replaced with a sentinel, or a byte-budget cap hit). Absent when the diff is complete. */
                 diff_truncated?: boolean;
             };
-            /** @description Match metadata (why/how the mark matched the watch). Null for pure-filter / pre-v2 alerts that carry no match scoring. */
+            /** @description Match metadata (why/how the mark matched the watch). Null for pure-filter / pre-v2 alerts that carry no match scoring. `score` is the engine score for the watch query, not the 0-100 search `relevance_score`. */
             match: {
                 reason: string | null;
                 score: number | null;
                 score_basis: string | null;
+                /**
+                 * @description Similarity tier of the matched mark, the same label a search hit carries as `match.tier` (identical, near_identical, similar, related). A retrieval category, not a measured edit distance. Null for filter-only watches, marks found only by their number, and alerts emitted before the field existed.
+                 * @enum {string|null}
+                 */
+                tier: "identical" | "near_identical" | "similar" | "related" | null;
             } | null;
             trademark: components["schemas"]["AlertTrademark"];
             deadline: {
@@ -9268,6 +9632,17 @@ export interface components {
             };
             request_id: string;
         };
+        WatchDeprecation: {
+            /** @example query.strategies */
+            param: string;
+            /** @example query.similarity */
+            replacement: string;
+            /**
+             * @description Date the deprecated key stops being accepted (YYYY-MM-DD).
+             * @example 2026-12-28
+             */
+            sunset: string;
+        };
         Watch: {
             /** @example wat_01HK... */
             id: string;
@@ -9334,6 +9709,8 @@ export interface components {
             };
             created_at: string;
             updated_at: string;
+            /** @description Present on create, update and bulk responses when the written query used a deprecated key: `strategies` (replaced by `similarity`) or `min_match_tier` (replaced by `min_tier`). The watch is kept as a legacy watch with its original matching until it is re-saved without them. Each entry names the key, its replacement and the date the old key stops being accepted. */
+            deprecations?: components["schemas"]["WatchDeprecation"][];
             request_id: string;
         };
         WatchList: {
@@ -9405,6 +9782,8 @@ export interface components {
                 };
                 created_at: string;
                 updated_at: string;
+                /** @description Present on create, update and bulk responses when the written query used a deprecated key: `strategies` (replaced by `similarity`) or `min_match_tier` (replaced by `min_tier`). The watch is kept as a legacy watch with its original matching until it is re-saved without them. Each entry names the key, its replacement and the date the old key stops being accepted. */
+                deprecations?: components["schemas"]["WatchDeprecation"][];
             }[];
             has_more: boolean;
             pagination: {
@@ -9427,6 +9806,13 @@ export interface components {
             score_threshold: number | null;
             /** @enum {string|null} */
             min_match_tier: "exact" | "normalized" | "fuzzy" | "phonetic" | null;
+            /** @description The similarity channels the watch query runs. Null without q, and for a legacy watch (stored with the deprecated keys, or before v3 and not re-saved since). */
+            similarity_applied: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[] | null;
+            /**
+             * @description The weakest similarity tier that alerts. Null for a legacy watch (stored with the deprecated keys, or before v3 and not re-saved since), which reports min_match_tier.
+             * @enum {string|null}
+             */
+            min_tier: "identical" | "near_identical" | "similar" | "related" | null;
             alert_fired: boolean;
             reason: string;
             /** @enum {string|null} */
@@ -11944,9 +12330,24 @@ export interface operations {
             query?: {
                 q?: string;
                 sort?: string;
-                strategies?: ("exact" | "phonetic" | "fuzzy" | "prefix")[] | null;
-                match?: "similar" | "exact" | "starts_with" | "ends_with" | "contains";
-                mark_text_not_contains?: string;
+                similarity?: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[] | null;
+                mark_text_is?: string[] | null;
+                mark_text_word?: string[] | null;
+                mark_text_starts_with?: string[] | null;
+                mark_text_ends_with?: string[] | null;
+                mark_text_contains?: string[] | null;
+                mark_text_pattern?: string[] | null;
+                mark_text_not_is?: string[] | null;
+                mark_text_not_word?: string[] | null;
+                mark_text_not_starts_with?: string[] | null;
+                mark_text_not_ends_with?: string[] | null;
+                mark_text_not_contains?: string[] | null;
+                mark_text_not_pattern?: string[] | null;
+                entity_id_not?: string[] | null;
+                entity_group_not?: string[] | null;
+                owner_id_not?: string[] | null;
+                trademark_ids_not?: string[] | null;
+                allow_partial?: boolean | null;
                 status_primary?: ("pending" | "active" | "inactive" | "unknown" | "mixed")[] | null;
                 status_stage?: ("filed" | "examining" | "pending_publication" | "published" | "opposition_period" | "pending_opposition" | "pending_cancellation" | "pending_issuance" | "registered" | "allowed" | "abandoned" | "withdrawn" | "surrendered" | "refused" | "cancelled" | "invalidated" | "expired" | "unknown" | "mixed")[] | null;
                 status_reason?: ("refused" | "withdrawn" | "abandoned" | "cancelled" | "invalidated" | "expired" | "surrendered" | "revoked" | "other")[] | null;
@@ -12032,7 +12433,7 @@ export interface operations {
                 is_retracted?: boolean | null;
                 is_series_mark?: boolean | null;
                 international_registrations?: "grouped" | "expanded";
-                include?: "full_goods_services"[] | null;
+                include?: ("full_goods_services" | "match_details")[] | null;
                 fields?: string[] | null;
                 owner_publicly_traded?: boolean | null;
                 owner_has_lei?: boolean | null;
@@ -12110,24 +12511,13 @@ export interface operations {
         requestBody?: {
             content: {
                 "application/json": {
-                    /**
-                     * @description Search query: one term as a string, or a list of exact terms. A list returns every mark that is an exact match under match=exact rules (case, accents, punctuation and spacing) for ANY of its terms, and each hit carries matched_terms[]. A list takes 1-100 terms of up to 200 characters; terms that differ only in case or accents are sent once under the first spelling, and matched_terms lists the kept spellings a hit matches. A list runs match=exact (the default for a list; any other match, or strategies, is a 400). One page costs the same as any search page regardless of term count. A string needs 2 characters for match=similar and 1 for the deterministic match modes. Optional for filtered listing.
-                     * @example SIGNA
-                     */
-                    query?: string | string[];
-                    /** @description Alias for `query` (parity with GET /v1/trademarks). Pass one or the other, not both. */
-                    q?: string | string[];
-                    /** @description Sort field(s), comma-separated, - prefix for desc. Valid: filing_date, registration_date, expiry_date, renewal_due_date, updated_at, publication_date, termination_date, office_code, jurisdiction_code, mark_text, owner_name. Max 3. Default: -filing_date when no query. Note: sort=office_code orders by the stored office identifier, which can differ from the alphabetical order of the ST.3 codes shown in office_code. */
+                    /** @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 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"];
+                    /** @description Sort field(s), comma-separated, - prefix for desc. Default: relevance with q, mark text order with a mark_text filter and no q, otherwise -filing_date. relevance_score stays on every hit under any sort when q is present. sort=office_code orders by the ST.3 code shown in office_code. Valid: filing_date, registration_date, expiry_date, renewal_due_date, updated_at, publication_date, termination_date, office_code, jurisdiction_code, mark_text, owner_name. Max 3. */
                     sort?: string;
-                    /** @description Search strategies (match=similar only). Defaults to exact + fuzzy for text queries. Only the strategies passed run: exact = whole-mark match (plus serial/registration numbers); synonym and phrase matching are part of fuzzy. */
-                    strategies?: ("exact" | "phonetic" | "fuzzy" | "prefix")[];
-                    /**
-                     * @description How the query matches the mark text: similar (default, ranked) | exact | starts_with | ends_with | contains. Deterministic modes require a query and disallow strategies.
-                     * @enum {string}
-                     */
-                    match?: "similar" | "exact" | "starts_with" | "ends_with" | "contains";
-                    /** @description Exclude marks whose text contains this substring (case/accent-insensitive). Composable with any match mode. */
-                    mark_text_not_contains?: string;
                     /**
                      * @description How filters.jurisdictions matches: protection (default — includes regional rights whose membership covers the requested territory, e.g. a EUTM for jurisdictions=[FR]) or direct (literal territory legs only).
                      * @enum {string}
@@ -12258,6 +12648,7 @@ export interface operations {
                         /** @description Filter by exact LEI (uppercased server-side). */
                         owner_lei?: string;
                         trademark_ids?: string[];
+                        mark_text?: components["schemas"]["MarkTextFilters"];
                     };
                     options?: {
                         aggregations?: ("status_stage" | "office_code" | "jurisdiction_code" | "nice_classes" | "filing_year" | "mark_feature_type" | "mark_legal_category" | "filing_route" | "right_kind" | "scope_kind" | "firm_id" | "attorney_id" | "owner_country" | "owner_id" | "entity_id" | "owner_count" | "entity_count")[];
@@ -12268,9 +12659,11 @@ export interface operations {
                         aggregation_mode?: "filtered" | "exclude_own_filter";
                         aggregations_only?: boolean;
                         include_total?: boolean;
-                        /** @description If true, includes highlight snippets under the default similar match mode. In deterministic match modes, highlights is inert. */
+                        /** @description If true, includes highlight snippets for a ranked q. */
                         highlights?: boolean;
                         include_timing?: boolean;
+                        /** @description Return 200 with search_meta.complete=false when the engine times out or a shard fails, instead of 503. Default false. */
+                        allow_partial?: boolean;
                     };
                     /** @default 20 */
                     limit?: number;
@@ -12282,12 +12675,12 @@ export interface operations {
                      */
                     international_registrations?: "grouped" | "expanded";
                     /**
-                     * @description Optional row projections. `full_goods_services` returns full classifications[].goods_services_text; default rows truncate long G&S text to about 280 characters.
+                     * @description Optional row projections. `full_goods_services` returns full classifications[].goods_services_text; default rows truncate long G&S text to about 280 characters. `match_details` adds match.details (the matched lanes and the ranking factors applied) to each hit.
                      * @example [
                      *       "full_goods_services"
                      *     ]
                      */
-                    include?: "full_goods_services"[];
+                    include?: ("full_goods_services" | "match_details")[];
                     /**
                      * @description Sparse top-level field projection. id and object are always retained.
                      * @example [
@@ -13308,7 +13701,24 @@ export interface operations {
         parameters: {
             query?: {
                 q?: string;
-                strategies?: ("exact" | "phonetic" | "fuzzy" | "prefix")[] | null;
+                similarity?: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[] | null;
+                mark_text_is?: string[] | null;
+                mark_text_word?: string[] | null;
+                mark_text_starts_with?: string[] | null;
+                mark_text_ends_with?: string[] | null;
+                mark_text_contains?: string[] | null;
+                mark_text_pattern?: string[] | null;
+                mark_text_not_is?: string[] | null;
+                mark_text_not_word?: string[] | null;
+                mark_text_not_starts_with?: string[] | null;
+                mark_text_not_ends_with?: string[] | null;
+                mark_text_not_contains?: string[] | null;
+                mark_text_not_pattern?: string[] | null;
+                entity_id_not?: string[] | null;
+                entity_group_not?: string[] | null;
+                owner_id_not?: string[] | null;
+                trademark_ids_not?: string[] | null;
+                allow_partial?: boolean | null;
                 sort?: string;
                 status_primary?: ("pending" | "active" | "inactive" | "unknown" | "mixed")[] | null;
                 status_stage?: ("filed" | "examining" | "pending_publication" | "published" | "opposition_period" | "pending_opposition" | "pending_cancellation" | "pending_issuance" | "registered" | "allowed" | "abandoned" | "withdrawn" | "surrendered" | "refused" | "cancelled" | "invalidated" | "expired" | "unknown" | "mixed")[] | null;
@@ -13392,10 +13802,8 @@ export interface operations {
                 is_retracted?: boolean | null;
                 is_series_mark?: boolean | null;
                 international_registrations?: "grouped" | "expanded";
-                include?: "full_goods_services"[] | null;
+                include?: ("full_goods_services" | "match_details")[] | null;
                 fields?: string[] | null;
-                match?: "similar" | "exact" | "starts_with" | "ends_with" | "contains";
-                mark_text_not_contains?: string;
                 owner_publicly_traded?: boolean | null;
                 owner_has_lei?: boolean | null;
                 owner_ticker?: string;
@@ -13683,7 +14091,24 @@ export interface operations {
         parameters: {
             query?: {
                 q?: string;
-                strategies?: ("exact" | "phonetic" | "fuzzy" | "prefix")[] | null;
+                similarity?: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[] | null;
+                mark_text_is?: string[] | null;
+                mark_text_word?: string[] | null;
+                mark_text_starts_with?: string[] | null;
+                mark_text_ends_with?: string[] | null;
+                mark_text_contains?: string[] | null;
+                mark_text_pattern?: string[] | null;
+                mark_text_not_is?: string[] | null;
+                mark_text_not_word?: string[] | null;
+                mark_text_not_starts_with?: string[] | null;
+                mark_text_not_ends_with?: string[] | null;
+                mark_text_not_contains?: string[] | null;
+                mark_text_not_pattern?: string[] | null;
+                entity_id_not?: string[] | null;
+                entity_group_not?: string[] | null;
+                owner_id_not?: string[] | null;
+                trademark_ids_not?: string[] | null;
+                allow_partial?: boolean | null;
                 sort?: string;
                 status_primary?: ("pending" | "active" | "inactive" | "unknown" | "mixed")[] | null;
                 status_stage?: ("filed" | "examining" | "pending_publication" | "published" | "opposition_period" | "pending_opposition" | "pending_cancellation" | "pending_issuance" | "registered" | "allowed" | "abandoned" | "withdrawn" | "surrendered" | "refused" | "cancelled" | "invalidated" | "expired" | "unknown" | "mixed")[] | null;
@@ -13767,10 +14192,8 @@ export interface operations {
                 is_retracted?: boolean | null;
                 is_series_mark?: boolean | null;
                 international_registrations?: "grouped" | "expanded";
-                include?: "full_goods_services"[] | null;
+                include?: ("full_goods_services" | "match_details")[] | null;
                 fields?: string[] | null;
-                match?: "similar" | "exact" | "starts_with" | "ends_with" | "contains";
-                mark_text_not_contains?: string;
                 owner_publicly_traded?: boolean | null;
                 owner_has_lei?: boolean | null;
                 owner_ticker?: string;
@@ -14130,7 +14553,24 @@ export interface operations {
         parameters: {
             query?: {
                 q?: string;
-                strategies?: ("exact" | "phonetic" | "fuzzy" | "prefix")[] | null;
+                similarity?: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[] | null;
+                mark_text_is?: string[] | null;
+                mark_text_word?: string[] | null;
+                mark_text_starts_with?: string[] | null;
+                mark_text_ends_with?: string[] | null;
+                mark_text_contains?: string[] | null;
+                mark_text_pattern?: string[] | null;
+                mark_text_not_is?: string[] | null;
+                mark_text_not_word?: string[] | null;
+                mark_text_not_starts_with?: string[] | null;
+                mark_text_not_ends_with?: string[] | null;
+                mark_text_not_contains?: string[] | null;
+                mark_text_not_pattern?: string[] | null;
+                entity_id_not?: string[] | null;
+                entity_group_not?: string[] | null;
+                owner_id_not?: string[] | null;
+                trademark_ids_not?: string[] | null;
+                allow_partial?: boolean | null;
                 sort?: string;
                 status_primary?: ("pending" | "active" | "inactive" | "unknown" | "mixed")[] | null;
                 status_stage?: ("filed" | "examining" | "pending_publication" | "published" | "opposition_period" | "pending_opposition" | "pending_cancellation" | "pending_issuance" | "registered" | "allowed" | "abandoned" | "withdrawn" | "surrendered" | "refused" | "cancelled" | "invalidated" | "expired" | "unknown" | "mixed")[] | null;
@@ -14214,10 +14654,8 @@ export interface operations {
                 is_retracted?: boolean | null;
                 is_series_mark?: boolean | null;
                 international_registrations?: "grouped" | "expanded";
-                include?: "full_goods_services"[] | null;
+                include?: ("full_goods_services" | "match_details")[] | null;
                 fields?: string[] | null;
-                match?: "similar" | "exact" | "starts_with" | "ends_with" | "contains";
-                mark_text_not_contains?: string;
                 owner_publicly_traded?: boolean | null;
                 owner_has_lei?: boolean | null;
                 owner_ticker?: string;
@@ -14438,7 +14876,24 @@ export interface operations {
         parameters: {
             query?: {
                 q?: string;
-                strategies?: ("exact" | "phonetic" | "fuzzy" | "prefix")[] | null;
+                similarity?: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[] | null;
+                mark_text_is?: string[] | null;
+                mark_text_word?: string[] | null;
+                mark_text_starts_with?: string[] | null;
+                mark_text_ends_with?: string[] | null;
+                mark_text_contains?: string[] | null;
+                mark_text_pattern?: string[] | null;
+                mark_text_not_is?: string[] | null;
+                mark_text_not_word?: string[] | null;
+                mark_text_not_starts_with?: string[] | null;
+                mark_text_not_ends_with?: string[] | null;
+                mark_text_not_contains?: string[] | null;
+                mark_text_not_pattern?: string[] | null;
+                entity_id_not?: string[] | null;
+                entity_group_not?: string[] | null;
+                owner_id_not?: string[] | null;
+                trademark_ids_not?: string[] | null;
+                allow_partial?: boolean | null;
                 sort?: string;
                 status_primary?: ("pending" | "active" | "inactive" | "unknown" | "mixed")[] | null;
                 status_stage?: ("filed" | "examining" | "pending_publication" | "published" | "opposition_period" | "pending_opposition" | "pending_cancellation" | "pending_issuance" | "registered" | "allowed" | "abandoned" | "withdrawn" | "surrendered" | "refused" | "cancelled" | "invalidated" | "expired" | "unknown" | "mixed")[] | null;
@@ -14522,10 +14977,8 @@ export interface operations {
                 is_retracted?: boolean | null;
                 is_series_mark?: boolean | null;
                 international_registrations?: "grouped" | "expanded";
-                include?: "full_goods_services"[] | null;
+                include?: ("full_goods_services" | "match_details")[] | null;
                 fields?: string[] | null;
-                match?: "similar" | "exact" | "starts_with" | "ends_with" | "contains";
-                mark_text_not_contains?: string;
                 owner_publicly_traded?: boolean | null;
                 owner_has_lei?: boolean | null;
                 owner_ticker?: string;
@@ -14599,7 +15052,7 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Entity too large. `error.reason` discriminates: `member_owners_too_large` (the entity resolved to more member owners than the cap; carries `member_count`/`member_count_limit`) or `family_graph_too_large` (the GLEIF family-graph walk exceeded its bound, fired by `?include_family=true`; carries `related_entity_limit`/`depth_limit`). */
+            /** @description Family graph too large: `?include_family=true` walked a family-tree larger than the bound (`error.reason` `family_graph_too_large`; carries `related_entity_limit`/`depth_limit`). There is no member-owner cap: an entity of any size lists without `include_family`. */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -16637,11 +17090,16 @@ export interface operations {
                                 /** @description Present and `true` when the change diff was bounded (entries dropped past the max count, or an over-long from/to value replaced with a sentinel, or a byte-budget cap hit). Absent when the diff is complete. */
                                 diff_truncated?: boolean;
                             };
-                            /** @description Match metadata (why/how the mark matched the watch). Null for pure-filter / pre-v2 alerts that carry no match scoring. */
+                            /** @description Match metadata (why/how the mark matched the watch). Null for pure-filter / pre-v2 alerts that carry no match scoring. `score` is the engine score for the watch query, not the 0-100 search `relevance_score`. */
                             match: {
                                 reason: string | null;
                                 score: number | null;
                                 score_basis: string | null;
+                                /**
+                                 * @description Similarity tier of the matched mark, the same label a search hit carries as `match.tier` (identical, near_identical, similar, related). A retrieval category, not a measured edit distance. Null for filter-only watches, marks found only by their number, and alerts emitted before the field existed.
+                                 * @enum {string|null}
+                                 */
+                                tier: "identical" | "near_identical" | "similar" | "related" | null;
                             } | null;
                             trademark: components["schemas"]["AlertTrademark"];
                             deadline: {
@@ -16741,15 +17199,16 @@ 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`). Similarity watches use `version: "v2"`, `q` (string), optional public-search `strategies` (`exact`, `phonetic`, `fuzzy`, `prefix`), optional `min_match_tier` (`exact`, `normalized`, `fuzzy`, `phonetic`), `filters`, and optional `trigger_events` (default: `trademark.created`, `trademark.updated`, `trademark.status_changed`; `trademark.retracted` / `trademark.corrected` are opt-in). `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). 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.
                      * @example {
-                     *       "version": "v2",
+                     *       "version": "v3",
                      *       "q": "acme",
-                     *       "strategies": [
-                     *         "exact",
-                     *         "fuzzy"
+                     *       "similarity": [
+                     *         "identical",
+                     *         "fuzzy",
+                     *         "phonetic"
                      *       ],
-                     *       "min_match_tier": "fuzzy",
+                     *       "min_tier": "similar",
                      *       "filters": {
                      *         "offices": [
                      *           "US"
@@ -17200,6 +17659,15 @@ export interface operations {
                         object: "watch_preview";
                         estimated_match_count: number;
                         trial_window_days: number;
+                        /** @description The similarity channels the text query ran (identical always included). Null when the query has no q, and for a query that uses the deprecated keys (previewed as the legacy watch a create would keep). */
+                        similarity_applied: ("identical" | "fuzzy" | "embedded" | "phonetic" | "lookalike")[] | null;
+                        /**
+                         * @description The weakest similarity tier that alerts (`related` admits everything). Null for a query that uses the deprecated keys, which keeps its `min_match_tier`.
+                         * @enum {string|null}
+                         */
+                        min_tier: "identical" | "near_identical" | "similar" | "related" | null;
+                        /** @description Present when the previewed query used a deprecated key (`strategies`, `min_match_tier`); the preview ran it as the legacy watch a create would keep. */
+                        deprecations?: components["schemas"]["WatchDeprecation"][];
                         /**
                          * @description Present only when estimated_match_count is not an exact count. `query_upper_bound`: the time budget ran out after the search but before the change check; the count is the marks that matched the query in the window plus the marks changed in the last 6 hours that the search index may not reflect yet, so it can only be too high. `lower_bound`: the search timed out or lost a shard, more than 10,000 marks matched the query in the window, the change check timed out, or the re-check of marks changed in the last 6 hours (which the search index may not reflect yet) could not finish; the count is the verified matches (0 if none), so it can only be too low. `candidacy_upper_bound`: a watch without a text query could not be fully evaluated (search unreachable, a very large change set, or the budget ran out); the count is the number of changed marks in the window.
                          * @enum {string}
@@ -17293,15 +17761,16 @@ 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`). Similarity watches use `version: "v2"`, `q` (string), optional public-search `strategies` (`exact`, `phonetic`, `fuzzy`, `prefix`), optional `min_match_tier` (`exact`, `normalized`, `fuzzy`, `phonetic`), `filters`, and optional `trigger_events` (default: `trademark.created`, `trademark.updated`, `trademark.status_changed`; `trademark.retracted` / `trademark.corrected` are opt-in). `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). 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.
                          * @example {
-                         *       "version": "v2",
+                         *       "version": "v3",
                          *       "q": "acme",
-                         *       "strategies": [
-                         *         "exact",
-                         *         "fuzzy"
+                         *       "similarity": [
+                         *         "identical",
+                         *         "fuzzy",
+                         *         "phonetic"
                          *       ],
-                         *       "min_match_tier": "fuzzy",
+                         *       "min_tier": "similar",
                          *       "filters": {
                          *         "offices": [
                          *           "US"
@@ -17405,6 +17874,8 @@ export interface operations {
                             };
                             created_at: string;
                             updated_at: string;
+                            /** @description Present on create, update and bulk responses when the written query used a deprecated key: `strategies` (replaced by `similarity`) or `min_match_tier` (replaced by `min_tier`). The watch is kept as a legacy watch with its original matching until it is re-saved without them. Each entry names the key, its replacement and the date the old key stops being accepted. */
+                            deprecations?: components["schemas"]["WatchDeprecation"][];
                         }[];
                         request_id: string;
                     };