@signa-so/sdk 0.7.0 → 0.9.0

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

@@ -88,6 +88,49 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/offices/votes": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description List the authenticated organization's office-coverage votes, alphabetical by office code. The set is bounded by the votable vocabulary, so the list is always a single page: `limit` and `cursor` are accepted for list-client compatibility but do not affect the response, which always returns every vote with `has_more: false`. */
+        get: operations["listOfficeVotes"];
+        put?: never;
+        /**
+         * @description Vote for trademark offices your organization wants on Signa. One vote per office per organization — re-votes are no-ops, so the call is safely retryable. Returns the stored votes for every requested code (newly cast or pre-existing).
+         *
+         *     This operation requires an `Idempotency-Key` header (see parameter description for 24h replay and 409-conflict semantics).
+         */
+        post: operations["castOfficeVotes"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/offices/votes/{code}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * @description Retract your organization's vote for an office. Accepts the same code vocabulary as casting; votes for offices that have since gone live can still be retracted.
+         *
+         *     This operation requires an `Idempotency-Key` header (see parameter description for 24h replay and 409-conflict semantics).
+         */
+        delete: operations["retractOfficeVote"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/classifications": {
         parameters: {
             query?: never;
@@ -335,7 +378,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** @description INTERNAL/beta — requires the `image-search:read` scope (internal + design-partner keys only until GA). Search trademarks by logo/image similarity. Accepts a multipart `image` upload, an `{image_url}` (https, SSRF-guarded), or a `{media_id}` (reuse an existing mark logo). Returns mark-level hits with named signal channels + thumbnails. Billed as `image_search`. Bounded top-K (limit ≤ 100). The query image is never stored. */
+        /** @description INTERNAL/beta — requires the `image-search:read` scope (internal + design-partner keys only until GA). Search trademarks by logo/image similarity. Accepts a multipart `image` upload, an `{image_url}` (https, SSRF-guarded), or a `{media_id}` (reuse an existing mark logo). Returns mark-level hits with named signal channels + thumbnails. Metered as `image_search`: **0 credits by default** while the image index is being built, 5 credits once image-search billing is enabled. Zero-billed calls carry no `X-Credits-*` headers (nothing is debited). Bounded top-K (limit ≤ 100). The query image is never stored. */
         post: operations["searchTrademarksByImage"];
         delete?: never;
         options?: never;
@@ -467,66 +510,15 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/trademarks/{id}/history": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** @description Paginated prosecution event timeline, reverse chronological. Maps to trademark_event table. */
-        get: operations["listTrademarkHistory"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/trademarks/{id}/changes": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** @description Version-level change history from the trademark_changes ledger, reverse chronological. This is an OBSERVED-changes feed: each entry records a mutation Signa observed to the record (office re-ingest diffs, Madrid ir_id link/unlink, retractions), not the office's own filing history. Entries are retained for a rolling 12-month window; older changes are pruned. The top-level `observed_since` field is the record's first-observation date (when Signa first ingested it) — the effective start of the visible history is max(observed_since, now − 12 months). */
-        get: operations["listTrademarkChanges"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/trademarks/{id}/related": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** @description Mark-to-mark relationships: Madrid designations, divisionals, seniority claims. Maps to trademark_relationship table. */
-        get: operations["listTrademarkRelated"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/trademarks/{id}/source": {
+    "/v1/trademarks/{id}/events": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** @description Raw-record provenance metadata. Returns where the data came from and when. Falls back to trademark-record metadata when no raw-record version is available — in that case some fields (e.g. the full raw payload reference and response-type classification) are omitted but the response is still 200. Only returns 404 when the trademark itself does not exist. */
-        get: operations["getTrademarkSource"];
+        /** @description Paginated prosecution event timeline for THIS mark, reverse chronological (maps to the trademark_event table): filings, publications, registrations, status changes. This is the office-reported history of a single trademark — not the org-level `/v1/events` activity feed. */
+        get: operations["listTrademarkEvents"];
         put?: never;
         post?: never;
         delete?: never;
@@ -586,40 +578,6 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/trademarks/{id}/coverage": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** @description Madrid designation territories. Maps to trademark_coverage table. Meaningful only for marks with filing_route = madrid_ir. */
-        get: operations["listTrademarkCoverage"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/trademarks/{id}/media/{mediaId}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** @description Proxy endpoint serving trademark images. Fetches the image server-side from the upstream office or CDN and streams it back. Unauthenticated — suitable for use in <img> tags. */
-        get: operations["getTrademarkMedia"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/v1/owners/{id}/analytics": {
         parameters: {
             query?: never;
@@ -1504,7 +1462,7 @@ export interface paths {
         };
         /** @description Read the org auto-top-up config. Internal (dashboard BFF); requires organization:manage. */
         get: operations["getAutoTopUpConfig"];
-        /** @description Update the org auto-top-up config. Internal (dashboard BFF); requires organization:manage. */
+        /** @description Update the org auto-top-up config. Internal (dashboard BFF); requires organization:manage. Any update whose MERGED result would be enabled is refused with 501 — auto-top-up charges saved cards off-session, which Stripe Managed Payments does not support. Disabling (enabled:false) and editing a stored, disabled config remain allowed. */
         put: operations["setAutoTopUpConfig"];
         post?: never;
         delete?: never;
@@ -1556,6 +1514,118 @@ export interface paths {
 export type webhooks = Record<string, never>;
 export interface components {
     schemas: {
+        SourceRecordRef: {
+            /** @example WO */
+            source_office_code: string | null;
+            /** @example US */
+            territory_code: string | null;
+            trademark?: {
+                id: string;
+                href: string;
+            };
+        };
+        DetailCoverageTerritory: {
+            /** @example US */
+            territory: string;
+            /** @example active */
+            primary: string;
+            /** @example registered */
+            stage: string;
+            /** @example protected */
+            protection_status: string | null;
+            /** @example 2024-06-01 */
+            designation_date: string | null;
+            /** @example 2025-01-20 */
+            protection_date: string | null;
+            /**
+             * @description The designation record covering this territory. Always present.
+             * @example tm_7d4e1f2a-3b8c-4d0e-9f1a-2b3c4d5e6f70
+             */
+            trademark_id: string;
+            /** @example United States of America */
+            territory_name: string | null;
+            /** @example 2025-03-11 */
+            refusal_date: string | null;
+            /** @example 2025-06-01 */
+            status_effective_date: string | null;
+            /** @example false */
+            is_subsequent_designation: boolean | null;
+            /** @example madrid_protocol */
+            designation_protocol: string | null;
+            /** @description Reconciliation alternates for a dual-feed territory (the WIPO-feed record folded into a winning national-feed record, or vice versa). Empty for a single-feed territory. */
+            source_records: components["schemas"]["SourceRecordRef"][];
+        };
+        DetailCoverage: {
+            /** @example 50 */
+            territory_count: number;
+            /**
+             * @example {
+             *       "active": 46,
+             *       "pending": 2,
+             *       "inactive": 2
+             *     }
+             */
+            by_primary: {
+                [key: string]: number;
+            };
+            /**
+             * @example {
+             *       "registered": 46,
+             *       "pending": 2,
+             *       "refused": 2
+             *     }
+             */
+            by_stage: {
+                [key: string]: number;
+            };
+            territories: components["schemas"]["DetailCoverageTerritory"][];
+        };
+        TrademarkRelationship: {
+            /** @example based_on_basic_registration */
+            type: string;
+            /**
+             * @example child
+             * @enum {string}
+             */
+            direction: "child" | "parent";
+            /** @example tm_7d4e1f2a-3b8c-4d0e-9f1a-2b3c4d5e6f70 */
+            trademark_id: string | null;
+            /**
+             * @description ST.3 office code of the counterpart as reported by the office. Null on `parent` edges (the counterpart is identified by `trademark_id`).
+             * @example US
+             */
+            target_office_code: string | null;
+            /**
+             * @description Office-native identifier of the counterpart. Null on `parent` edges (the counterpart is identified by `trademark_id`).
+             * @example 97123456
+             */
+            target_record_id: string | null;
+            /** @example US */
+            office_code: string | null;
+            /** @example SIGNA */
+            mark_text: string | null;
+            /** @example registered */
+            status_stage: string | null;
+            /** @example 2024-03-15 */
+            effective_date: string | null;
+        };
+        Provenance: {
+            /**
+             * @description Date of the office data file/response this record was built from.
+             * @example 2026-03-18
+             */
+            source_data_date: string | null;
+            /**
+             * @description The office's own last-modified timestamp for the record, when it publishes one.
+             * @example 2026-03-17T00:00:00Z
+             */
+            office_updated_at: string | null;
+            /**
+             * @description When Signa last fetched the full detail record from the office.
+             * @example 2026-03-18T04:00:00Z
+             */
+            retrieved_at: string | null;
+        };
         TrademarkDetailV1: {
             /** @example tm_7d4e1f2a3b8c9d0e */
             id: string;
@@ -1620,16 +1690,6 @@ export interface components {
             publication_date: string | null;
             priority_date: string | null;
             termination_date: string | null;
-            /**
-             * @description Timestamp reported by the source office for the record, when available.
-             * @example 2026-03-18T04:00:00Z
-             */
-            office_updated_at: string | null;
-            /**
-             * @description Timestamp of the most recent detail enrichment fetch when that office populates it; null otherwise.
-             * @example 2026-03-18T04:30:00Z
-             */
-            retrieved_at: string | null;
             protection_effective_date: string | null;
             designation_date: string | null;
             dependency_period_end_date: string | null;
@@ -1899,29 +1959,18 @@ export interface components {
                 } | null;
             } | null;
             has_media: boolean;
+            /**
+             * @description Media-proxy URL for the primary mark image. Null when the mark has no media.
+             * @example https://api.signa.so/v1/trademarks/tm_abc/media/01234567-89ab-cdef-0123-456789abcdef
+             */
+            primary_image_url: string | null;
+            /** @description Per-territory coverage for a grouped Madrid IR (the same reconciled rollup the search row carries, plus per-designation detail). Null on designation legs and on direct/regional marks. */
+            coverage: components["schemas"]["DetailCoverage"] | null;
+            /** @description Mark-to-mark relationships. Excludes Madrid designations (see coverage.territories[]) and seniority claims (see seniority_claims[]). Capped at 200 per mark. */
+            relationships: components["schemas"]["TrademarkRelationship"][];
             events_count: number;
             proceedings_count: number;
-            coverage_count: number;
-            relationships_count: number;
-            data_freshness: {
-                /** @example 2026-03-18 */
-                source_data_date: string | null;
-                /** @example dtd_v2.0 */
-                source_format: string | null;
-                /** @example 2026-03-18T04:00:00Z */
-                last_updated_at: string;
-            };
-            madrid?: {
-                ir_number: string;
-                holder_name: string | null;
-                origin_office: string | null;
-                expiry_date: string | null;
-                designation_count: number;
-                designated_countries: string[];
-                nice_classes: number[];
-                status_stage: string | null;
-                fetched_at: string | null;
-            } | null;
+            provenance: components["schemas"]["Provenance"];
             /** @example 2024-03-16T00:00:00Z */
             created_at: string;
             /** @example 2026-03-18T04:00:00Z */
@@ -2096,18 +2145,6 @@ export interface components {
                 /** @example 2025-01-20 */
                 protection_date: string | null;
             }[];
-            /** @example /v1/trademarks/tm_IR1293856/coverage */
-            href: string;
-        };
-        SourceRecordRef: {
-            /** @example WO */
-            source_office_code: string | null;
-            /** @example US */
-            territory_code: string | null;
-            trademark?: {
-                id: string;
-                href: string;
-            };
         };
         TerritoryMatch: {
             /**
@@ -2421,27 +2458,33 @@ export interface components {
             data: components["schemas"]["ScreeningHitV3"][];
             request_id?: string;
         };
-        Classification: {
-            /** @example 9 */
-            class_number: number;
+        OfficeVoteResource: {
             /** @enum {string} */
-            object: "classification";
-            /** @example Electrical and scientific apparatus */
-            title: string;
-            description: string | null;
-            category: string | null;
+            object: "office_vote";
+            /**
+             * @description Canonical WIPO ST.3 office code (uppercase), e.g. BR, MX, BX.
+             * @example BR
+             */
+            office_code: string;
+            /**
+             * @description Current coverage of the voted office: `live` (now on Signa — your ask landed), `roadmap` (modeled, connector not shipping yet), `not_covered` (not modeled yet).
+             * @enum {string}
+             */
+            office_status: "live" | "roadmap" | "not_covered";
+            /** @description When this org first voted for the office. */
+            created_at: string;
         };
-        ClassificationListResponse: {
+        OfficeVoteList: {
             /** @enum {string} */
             object: "list";
-            data: components["schemas"]["Classification"][];
+            data: components["schemas"]["OfficeVoteResource"][];
             has_more: boolean;
             pagination: {
                 cursor: string | null;
                 total_count?: number;
                 total_count_approximate?: boolean;
             };
-            request_id?: string;
+            request_id: string;
         };
         Error: {
             error: {
@@ -2477,23 +2520,53 @@ export interface components {
             /** @example req_abc123 */
             request_id: string;
         };
-        GoodsServicesTerm: {
-            /** @example Computer software for data processing */
-            term: string;
-            /** @example computer-software-for-data-processing */
-            term_key: string;
+        OfficeVoteDeleted: {
+            /** @enum {string} */
+            object: "office_vote";
+            office_code: string;
+            /** @enum {boolean} */
+            deleted: true;
+            request_id: string;
+        };
+        Classification: {
             /** @example 9 */
             class_number: number;
-            /** @example Software > Data Processing */
-            taxonomy_path: string | null;
-            /** @example true */
-            is_harmonised: boolean;
-            /**
-             * @description Offices whose goods & services catalogs accept this term, as identified by the upstream sources (TMclass/HDB, USPTO ID Manual). This is a catalog-acceptance vocabulary passed through verbatim — NOT the ST.3 `office_code` vocabulary used elsewhere in the API.
-             * @example [
-             *       "USPTO",
-             *       "EUIPO",
-             *       "UKIPO",
+            /** @enum {string} */
+            object: "classification";
+            /** @example Electrical and scientific apparatus */
+            title: string;
+            description: string | null;
+            category: string | null;
+        };
+        ClassificationListResponse: {
+            /** @enum {string} */
+            object: "list";
+            data: components["schemas"]["Classification"][];
+            has_more: boolean;
+            pagination: {
+                cursor: string | null;
+                total_count?: number;
+                total_count_approximate?: boolean;
+            };
+            request_id?: string;
+        };
+        GoodsServicesTerm: {
+            /** @example Computer software for data processing */
+            term: string;
+            /** @example computer-software-for-data-processing */
+            term_key: string;
+            /** @example 9 */
+            class_number: number;
+            /** @example Software > Data Processing */
+            taxonomy_path: string | null;
+            /** @example true */
+            is_harmonised: boolean;
+            /**
+             * @description Offices whose goods & services catalogs accept this term, as identified by the upstream sources (TMclass/HDB, USPTO ID Manual). This is a catalog-acceptance vocabulary passed through verbatim — NOT the ST.3 `office_code` vocabulary used elsewhere in the API.
+             * @example [
+             *       "USPTO",
+             *       "EUIPO",
+             *       "UKIPO",
              *       "CIPO"
              *     ]
              */
@@ -3511,7 +3584,7 @@ export interface components {
                 international_registrations: "grouped" | "expanded";
                 /**
                  * @description Present when a grouped request falls back to expanded because a filter, sort, or option cannot be served by the grouped index.
-                 * @example filter:vienna_codes forced expanded
+                 * @example filter:filing_date forced expanded
                  */
                 fallback_reason?: string;
                 /**
@@ -3575,7 +3648,11 @@ export interface components {
             aggregation_metadata?: components["schemas"]["AggregationMetadata"];
             request_id: string;
         };
-        TrademarkHistoryEvent: {
+        TrademarkEvent: {
+            /** @example evt_7d4e1f2a-3b8c-4d0e-9f1a-2b3c4d5e6f70 */
+            id: string;
+            /** @enum {string} */
+            object: "event";
             /** @example 2025-01-20 */
             event_date: string | null;
             /** @example registration */
@@ -3599,108 +3676,10 @@ export interface components {
             /** @example 12 */
             sequence_no: number | null;
         };
-        TrademarkHistoryResponse: {
-            /** @enum {string} */
-            object: "list";
-            data: components["schemas"]["TrademarkHistoryEvent"][];
-            has_more: boolean;
-            pagination: {
-                cursor: string | null;
-                total_count?: number;
-                total_count_approximate?: boolean;
-            };
-            request_id: string;
-        };
-        TrademarkChange: {
-            /** @example evt_019d2141-6ce9-771b-872e-bc8b20e49fcf */
-            id: string;
-            /** @enum {string} */
-            object: "trademark_change";
-            /** @example 12 */
-            version: number;
-            /** @example updated */
-            change_type: string;
-            /**
-             * @example [
-             *       "status_stage",
-             *       "registration_date"
-             *     ]
-             */
-            changed_fields: string[];
-            /**
-             * @example {
-             *       "status_stage": "examining",
-             *       "registration_date": null
-             *     }
-             */
-            old_values: {
-                [key: string]: string | number | boolean | unknown[] | {
-                    [key: string]: unknown;
-                } | null;
-            } | null;
-            /**
-             * @example {
-             *       "status_stage": "registered",
-             *       "registration_date": "2026-03-15"
-             *     }
-             */
-            new_values: {
-                [key: string]: string | number | boolean | unknown[] | {
-                    [key: string]: unknown;
-                } | null;
-            };
-            /** @example 2026-03-15 */
-            source_data_date: string | null;
-            /** @example US */
-            office_code: string | null;
-            /** @example 2026-03-15T12:00:00Z */
-            created_at: string;
-        };
-        TrademarkChangesResponse: {
-            /** @enum {string} */
-            object: "list";
-            data: components["schemas"]["TrademarkChange"][];
-            has_more: boolean;
-            pagination: {
-                cursor: string | null;
-                total_count?: number;
-                total_count_approximate?: boolean;
-            };
-            /**
-             * Format: date-time
-             * @description ISO 8601 date-time the trademark was first observed by Signa (first ingest). Changes older than the rolling 12-month retention window are pruned.
-             */
-            observed_since: string | null;
-            request_id: string;
-        };
-        TrademarkRelated: {
-            /** @example tm_xyz */
-            related_trademark_id: string | null;
-            /** @example madrid_designation_of */
-            relationship_type: string;
-            /** @example 2024-06-01 */
-            effective_date: string | null;
-            /** @example SIGNA */
-            mark_text: string | null;
-            /** @example EM */
-            office_code: string | null;
-            /** @example registered */
-            status_stage: string | null;
-            /** @example child */
-            direction: string;
-            /** @example null */
-            target_office_code: string | null;
-            /** @example null */
-            target_record_id: string | null;
-            /** @example null */
-            metadata: string | number | boolean | unknown[] | {
-                [key: string]: unknown;
-            } | null;
-        };
-        TrademarkRelatedResponse: {
+        TrademarkEventsResponse: {
             /** @enum {string} */
             object: "list";
-            data: components["schemas"]["TrademarkRelated"][];
+            data: components["schemas"]["TrademarkEvent"][];
             has_more: boolean;
             pagination: {
                 cursor: string | null;
@@ -3709,27 +3688,6 @@ export interface components {
             };
             request_id: string;
         };
-        TrademarkSource: {
-            /** @enum {string} */
-            object: "trademark_source";
-            /** @example tm_abc */
-            trademark_id: string;
-            /** @example US */
-            office_code: string | null;
-            /** @example 2026-03-18T04:00:00Z */
-            observed_at: string;
-            /** @example dtd_v2.0 */
-            source_format: string;
-            /** @example daily_bulk_xml */
-            source_response_type: string | null;
-            /** @example apc18840407-20251231-01.zip/entry-1234.xml */
-            source_locator: string | null;
-            /** @example sha256:a1b2c3d4... */
-            payload_hash: string;
-        };
-        TrademarkSourceResponse: components["schemas"]["TrademarkSource"] & {
-            request_id: string;
-        };
         TrademarkProceedingParty: {
             /** @example own_xyz */
             owner_id: string | null;
@@ -3930,57 +3888,6 @@ export interface components {
             source_sync: components["schemas"]["TrademarkDocumentSourceSync"];
             request_id: string;
         };
-        TrademarkCoverage: {
-            /** @example GB */
-            territory_code: string | null;
-            /** @example United Kingdom */
-            territory_name: string | null;
-            /** @example active */
-            primary: string | null;
-            /** @example registered */
-            stage: string | null;
-            /** @example protected */
-            protection_status: string | null;
-            /** @example 2024-06-01 */
-            designation_date: string | null;
-            /** @example 2025-02-15 */
-            protection_date: string | null;
-            /** @example null */
-            refusal_date: string | null;
-            /** @example 2025-02-15 */
-            status_effective_date: string | null;
-            /** @example false */
-            is_subsequent_designation: boolean | null;
-            /** @example madrid */
-            designation_protocol: string | null;
-            /** @example null */
-            goods_limitations: string | number | boolean | unknown[] | {
-                [key: string]: unknown;
-            } | null;
-            /** @example null */
-            status_detail: string | number | boolean | unknown[] | {
-                [key: string]: unknown;
-            } | null;
-            /** @description WIPO/national reconciliation alternates for this territory (§12.1) on grouped IR-parent rows — additive, never a duplicate row. Empty/absent for single-feed territories and non-IR marks. */
-            source_records?: {
-                /** @example WO */
-                source_office_code: string | null;
-                /** @example US */
-                territory_code: string | null;
-            }[];
-        };
-        TrademarkCoverageResponse: {
-            /** @enum {string} */
-            object: "list";
-            data: components["schemas"]["TrademarkCoverage"][];
-            has_more: boolean;
-            pagination: {
-                cursor: string | null;
-                total_count?: number;
-                total_count_approximate?: boolean;
-            };
-            request_id: string;
-        };
         AnalyticsPortfolioBlock: {
             mark_count: number;
             active_count: number;
@@ -4395,7 +4302,7 @@ export interface components {
                 international_registrations: "grouped" | "expanded";
                 /**
                  * @description Present when a grouped request falls back to expanded because a filter, sort, or option cannot be served by the grouped index.
-                 * @example filter:vienna_codes forced expanded
+                 * @example filter:filing_date forced expanded
                  */
                 fallback_reason?: string;
                 /**
@@ -4633,7 +4540,7 @@ export interface components {
                 international_registrations: "grouped" | "expanded";
                 /**
                  * @description Present when a grouped request falls back to expanded because a filter, sort, or option cannot be served by the grouped index.
-                 * @example filter:vienna_codes forced expanded
+                 * @example filter:filing_date forced expanded
                  */
                 fallback_reason?: string;
                 /**
@@ -4872,7 +4779,7 @@ export interface components {
                 international_registrations: "grouped" | "expanded";
                 /**
                  * @description Present when a grouped request falls back to expanded because a filter, sort, or option cannot be served by the grouped index.
-                 * @example filter:vienna_codes forced expanded
+                 * @example filter:filing_date forced expanded
                  */
                 fallback_reason?: string;
                 /**
@@ -5167,7 +5074,7 @@ export interface components {
                 international_registrations: "grouped" | "expanded";
                 /**
                  * @description Present when a grouped request falls back to expanded because a filter, sort, or option cannot be served by the grouped index.
-                 * @example filter:vienna_codes forced expanded
+                 * @example filter:filing_date forced expanded
                  */
                 fallback_reason?: string;
                 /**
@@ -6396,6 +6303,8 @@ export interface components {
              */
             status: "active" | "revoked" | "expired";
             expires_at: string | null;
+            /** @description When this key was rotated (superseded). Non-null means expires_at is a rotation grace deadline, not a customer-set expiry. */
+            rotated_at: string | null;
             last_used_at: string | null;
             metadata: {
                 [key: string]: string;
@@ -6427,6 +6336,8 @@ export interface components {
                  */
                 status: "active" | "revoked" | "expired";
                 expires_at: string | null;
+                /** @description When this key was rotated (superseded). Non-null means expires_at is a rotation grace deadline, not a customer-set expiry. */
+                rotated_at: string | null;
                 last_used_at: string | null;
                 metadata: {
                     [key: string]: string;
@@ -6577,16 +6488,19 @@ export interface components {
         StripeCheckoutSessionResponse: {
             checkout_url: string | null;
             session_id: string;
+            request_id: string;
         };
         StripeBillingPortalResponse: {
             portal_url: string;
             session_id: string;
+            request_id: string;
         };
         StripeCreditPackCheckoutResponse: {
             checkout_url: string | null;
             session_id: string;
             credits: number;
             plan: string;
+            request_id: string;
         };
         AutoTopUpConfigResponse: {
             enabled: boolean;
@@ -6597,6 +6511,9 @@ export interface components {
             saved_payment_method: string | null;
             month_to_date_spend_usd: number;
             last_failure_reason: string | null;
+            /** @description True while auto-top-up charging is suspended fleet-wide (all Signa payments run through Stripe Managed Payments, which cannot make automatic off-session charges). While true, any update whose merged result would be enabled is refused with 501. */
+            suspended: boolean;
+            request_id: string;
         };
         NotificationCategory: {
             key: string;
@@ -6833,6 +6750,153 @@ export interface operations {
             };
         };
     };
+    listOfficeVotes: {
+        parameters: {
+            query?: {
+                limit?: number;
+                cursor?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description List of office votes */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OfficeVoteList"];
+                };
+            };
+            /** @description Invalid query parameter */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    castOfficeVotes: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Unique key for safe retries. Responses to a given key are cached for 24h; retrying the same key with the same body replays the original response (with an Idempotent-Replayed: true header); the same key with a different body returns 409 conflict. */
+                "Idempotency-Key": string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": {
+                    /**
+                     * @description Office codes to vote for (1–50). ST.3 / ISO country codes, any case (surrounding whitespace is trimmed); legacy internal codes and reserved aliases like UK are canonicalized. Offices Signa already covers are rejected — vote for what you want added. Codes your organization already voted for are no-ops, never double counts.
+                     * @example [
+                     *       "BR",
+                     *       "MX"
+                     *     ]
+                     */
+                    office_codes: string[];
+                };
+            };
+        };
+        responses: {
+            /** @description Stored votes for the requested codes */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OfficeVoteList"];
+                };
+            };
+            /** @description Unknown, already-covered, or register-less office code (unknown_office_code / office_already_live / no_trademark_register) */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    retractOfficeVote: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Unique key for safe retries. Responses to a given key are cached for 24h; retrying the same key with the same body replays the original response (with an Idempotent-Replayed: true header); the same key with a different body returns 409 conflict. */
+                "Idempotency-Key": string;
+            };
+            path: {
+                code: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Vote deleted */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OfficeVoteDeleted"];
+                };
+            };
+            /** @description Unknown office code */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description No vote for this office */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
     listClassifications: {
         parameters: {
             query?: {
@@ -8328,167 +8392,39 @@ export interface operations {
                      * @description International registration presentation. Default grouped → one row per mark/IR, with coverage on IR rows. Use expanded for one row per Madrid designation.
                      * @example grouped
                      * @enum {string}
-                     */
-                    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.
-                     * @example [
-                     *       "full_goods_services"
-                     *     ]
-                     */
-                    include?: "full_goods_services"[];
-                    /**
-                     * @description Sparse top-level field projection. id and object are always retained.
-                     * @example [
-                     *       "mark_text",
-                     *       "status",
-                     *       "nice_classes",
-                     *       "owners"
-                     *     ]
-                     */
-                    fields?: string[];
-                };
-            };
-        };
-        responses: {
-            /** @description Search results */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["SearchResponseV2"];
-                };
-            };
-            /** @description Validation error */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Missing or invalid API key */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Missing required scope */
-            403: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Entity too large (member cap exceeded) */
-            422: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-        };
-    };
-    listTrademarkHistory: {
-        parameters: {
-            query?: {
-                event_type?: string[] | null;
-                event_scope?: string;
-                event_date_gte?: string;
-                event_date_lt?: string;
-                limit?: number;
-                cursor?: string;
-            };
-            header?: never;
-            path: {
-                id: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Trademark event history */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["TrademarkHistoryResponse"];
-                };
-            };
-            /** @description Invalid ID */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Missing or invalid API key */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Missing required scope */
-            403: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Trademark not found */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
+                     */
+                    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.
+                     * @example [
+                     *       "full_goods_services"
+                     *     ]
+                     */
+                    include?: "full_goods_services"[];
+                    /**
+                     * @description Sparse top-level field projection. id and object are always retained.
+                     * @example [
+                     *       "mark_text",
+                     *       "status",
+                     *       "nice_classes",
+                     *       "owners"
+                     *     ]
+                     */
+                    fields?: string[];
                 };
             };
         };
-    };
-    listTrademarkChanges: {
-        parameters: {
-            query?: {
-                changed_field?: string;
-                sort?: "-changed_at" | "changed_at";
-                limit?: number;
-                cursor?: string;
-            };
-            header?: never;
-            path: {
-                id: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
         responses: {
-            /** @description Trademark change history */
+            /** @description Search results */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["TrademarkChangesResponse"];
+                    "application/json": components["schemas"]["SearchResponseV2"];
                 };
             };
-            /** @description Invalid ID */
+            /** @description Validation error */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -8515,8 +8451,8 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Trademark not found */
-            404: {
+            /** @description Entity too large (member cap exceeded) */
+            422: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -8526,10 +8462,13 @@ export interface operations {
             };
         };
     };
-    listTrademarkRelated: {
+    listTrademarkEvents: {
         parameters: {
             query?: {
-                relationship_type?: string;
+                event_type?: string[] | null;
+                event_scope?: string;
+                event_date_gte?: string;
+                event_date_lt?: string;
                 limit?: number;
                 cursor?: string;
             };
@@ -8541,71 +8480,13 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Trademark relationships */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["TrademarkRelatedResponse"];
-                };
-            };
-            /** @description Invalid ID */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Missing or invalid API key */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Missing required scope */
-            403: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Trademark not found */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-        };
-    };
-    getTrademarkSource: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                id: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Source provenance (synthesized from trademark-record metadata when no raw-record version exists — reduced field set) */
+            /** @description Trademark prosecution events */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["TrademarkSourceResponse"];
+                    "application/json": components["schemas"]["TrademarkEventsResponse"];
                 };
             };
             /** @description Invalid ID */
@@ -8836,116 +8717,6 @@ export interface operations {
             };
         };
     };
-    listTrademarkCoverage: {
-        parameters: {
-            query?: {
-                protection_status?: string;
-                limit?: number;
-                cursor?: string;
-            };
-            header?: never;
-            path: {
-                id: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Trademark coverage territories */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["TrademarkCoverageResponse"];
-                };
-            };
-            /** @description Invalid ID */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Missing or invalid API key */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Missing required scope */
-            403: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Trademark not found */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-        };
-    };
-    getTrademarkMedia: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                id: string;
-                mediaId: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Image content */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Invalid ID */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Media not found */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Upstream image unavailable */
-            502: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-        };
-    };
     retrieveOwnerAnalytics: {
         parameters: {
             query?: never;
@@ -12554,6 +12325,11 @@ export interface operations {
                      * @description Redirect on cancel.
                      */
                     cancel_url?: string;
+                    /**
+                     * Format: email
+                     * @description Billing email for the Stripe customer (receipts, invoices, failed-payment mail). The dashboard BFF passes the signed-in user's address. Write-once seed: ignored when the organization already has a billing email (later changes flow from the Stripe customer via the customer.updated webhook).
+                     */
+                    billing_email?: string;
                 };
             };
         };
@@ -12603,6 +12379,24 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Organization already has an active subscription */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Billing is not configured on this deployment (Stripe key absent) */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     createBillingPortal: {
@@ -12623,6 +12417,11 @@ export interface operations {
                      * @description Return URL after the portal.
                      */
                     return_url?: string;
+                    /**
+                     * Format: email
+                     * @description Billing email for the Stripe customer (receipts, invoices, failed-payment mail). The dashboard BFF passes the signed-in user's address. Write-once seed: ignored when the organization already has a billing email (later changes flow from the Stripe customer via the customer.updated webhook).
+                     */
+                    billing_email?: string;
                 };
             };
         };
@@ -12636,6 +12435,15 @@ export interface operations {
                     "application/json": components["schemas"]["StripeBillingPortalResponse"];
                 };
             };
+            /** @description Validation error */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Missing or invalid API key */
             401: {
                 headers: {
@@ -12663,6 +12471,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Billing is not configured on this deployment (Stripe key absent) */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     createCreditPackCheckout: {
@@ -12693,6 +12510,11 @@ export interface operations {
                      * @description Redirect on cancel.
                      */
                     cancel_url?: string;
+                    /**
+                     * Format: email
+                     * @description Billing email for the Stripe customer (receipts, invoices, failed-payment mail). The dashboard BFF passes the signed-in user's address. Write-once seed: ignored when the organization already has a billing email (later changes flow from the Stripe customer via the customer.updated webhook).
+                     */
+                    billing_email?: string;
                 };
             };
         };
@@ -12742,6 +12564,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Billing is not configured on this deployment (Stripe key absent) */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     getAutoTopUpConfig: {
@@ -12829,7 +12660,7 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Missing scope, or plan cannot enable auto-top-up */
+            /** @description Missing organization:manage scope */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -12838,6 +12669,15 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /** @description Auto-top-up cannot be enabled: all Signa payments run through Stripe Managed Payments, which does not support automatic off-session charges. */
+            501: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     getNotificationPreferences: {