@truepic/vision-api-types 3.87.0 → 3.89.0

package/index.d.ts

@@ -184,6 +184,69 @@ export interface paths {
                             "<="?: string;
                         };
                     };
+                    /**
+                     * @description Sorting to order the results returned.
+                     *
+                     *     The order of properties is important, as sorting is applied in the order specified.
+                     *
+                     *     Defaults to `created_at` `asc`.
+                     */
+                    sort?: {
+                        /**
+                         * @description Sort by the name of the status.
+                         * @example asc
+                         * @enum {string}
+                         */
+                        status?: "asc" | "desc";
+                        /**
+                         * @description Sort by the name of the inspection type.
+                         * @example asc
+                         * @enum {string}
+                         */
+                        inspection_type?: "asc" | "desc";
+                        /**
+                         * @description Sort by the last name of the member who created the inspection request. Same as `created_by_member`.
+                         * @example asc
+                         * @enum {string}
+                         */
+                        member?: "asc" | "desc";
+                        /**
+                         * @description Sort by the last name of the member who created the inspection request. Same as `member`.
+                         * @example asc
+                         * @enum {string}
+                         */
+                        created_by_member?: "asc" | "desc";
+                        /**
+                         * @description Sort by the last name of the member who is currently assigned to the inspection request.
+                         * @example asc
+                         * @enum {string}
+                         */
+                        assigned_to_member?: "asc" | "desc";
+                        /**
+                         * @description Sort by the date/time when the last photo/video was uploaded.
+                         * @example asc
+                         * @enum {string}
+                         */
+                        photos?: "asc" | "desc";
+                        /**
+                         * @description Sort by the aggregate verification result of all photos/videos.
+                         * @example asc
+                         * @enum {string}
+                         */
+                        verification?: "asc" | "desc";
+                        /**
+                         * @description Sort by the date/time when the inspection request was created.
+                         * @example asc
+                         * @enum {string}
+                         */
+                        created_at?: "asc" | "desc";
+                        /**
+                         * @description Sort by the date/time when the inspection request was scheduled.
+                         * @example asc
+                         * @enum {string}
+                         */
+                        scheduled_for?: "asc" | "desc";
+                    };
                     /**
                      * @description Pagination to limit the number of results returned.
                      *
@@ -377,6 +440,20 @@ export interface paths {
         get: {
             parameters: {
                 query?: {
+                    /**
+                     * @description When `true`, an authorized administrator receives an additive `ai_analysis_test` object, and `ai_status`, `ai_status_details` and `ai_item_types` carry the AI Analysis *test* when the inspection has one to show.
+                     *
+                     *     When it has none — never tested, or the last test failed — those three fields carry the inspection's **ordinary** result instead. A queued or running test is the exception, and which way it goes depends on whether an earlier test result exists. On a first run there is none, so the three fields describe that run and come back empty. On a rerun the earlier test's result is retained, not withheld, and those fields keep carrying it until the rerun finishes or fails.
+                     *
+                     *     `ai_analysis_test.results_type` (`test` or `ordinary`) names which of the two a response carries; see that field for how to read it.
+                     *
+                     *     `ai_analysis_status.state` follows whichever result is being carried, so it is not the test's state — a run's own progress is `ai_analysis_test.attempt.state`.
+                     *
+                     *     `alert`, `alert_count` and the PDF always describe the ordinary analysis whatever `results_type` says, because unpromoted tests are excluded from them by design.
+                     *
+                     *     Without the parameter, or with the explicit value `false`, the response keeps its ordinary meaning and omits `ai_analysis_test` entirely — as it does for a caller whose role or organization is not entitled, whatever value is sent. Any other value, or the parameter repeated, is refused with `400 validation_error`. v3 only; on v2 the parameter has no effect.
+                     */
+                    include_ai_analysis_test?: "true" | "false";
                     /**
                      * @description The top-level `result` fields to include in the response.
                      *
@@ -615,7 +692,7 @@ export interface paths {
         get?: never;
         /**
          * Update the type of an existing inspection
-         * @description Updates the type of an existing inspection. The inspection type can only be changed to a inspection type that is assigned to the inspection's team. Changing the type of an inspection will delete any already-uploaded Truepics and will automatically re-send the request email/text to the customer. This endpoint will also set the inspection status to `Created`. Closed or Canceled inspections cannot have their inspection type changed.
+         * @description Updates the type of an existing inspection. The inspection type can only be changed to an inspection type that is assigned to the inspection's team. Changing the type of an inspection will delete any already-uploaded Truepics and will automatically re-send the request email/text to the customer. This endpoint will also set the inspection status to `Created`. Closed or Canceled inspections cannot have their inspection type changed. Any unpromoted AI Analysis test data on the inspection is hard-deleted, because it was produced from the old type's configuration; the change is refused while a test is queued or running. That refusal is a 409 carrying `test_run_in_progress`, or `test_data_not_removable` when some of the data can no longer be removed; branch on the code, not the status.
          */
         put: {
             parameters: {
@@ -646,6 +723,7 @@ export interface paths {
                 401: components["responses"]["ErrorUnauthorized"];
                 403: components["responses"]["ErrorForbidden"];
                 404: components["responses"]["ErrorNotFound"];
+                409: components["responses"]["AIAnalysisTestModeConflict"];
                 412: components["responses"]["ErrorPreconditionFailed"];
                 500: components["responses"]["ErrorUnhandled"];
             };
@@ -991,7 +1069,7 @@ export interface paths {
                 content: {
                     "multipart/form-data": {
                         /** Format: binary */
-                        asset?: string;
+                        asset: string;
                     };
                 };
             };
@@ -1243,7 +1321,7 @@ export interface paths {
                 content: {
                     "multipart/form-data": {
                         /** Format: binary */
-                        asset?: string;
+                        asset: string;
                     };
                 };
             };
@@ -2023,7 +2101,7 @@ export interface paths {
             };
             responses: {
                 /** @description Success */
-                200: {
+                201: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -2031,6 +2109,15 @@ export interface paths {
                         "application/json": components["schemas"]["ResponseData"] & {
                             /** @description The id of the newly created inspection type */
                             id?: number;
+                            /** @description Present only when `ai_analysis_configuration` was supplied. Carries the configuration that was created in the same transaction as the type. */
+                            result?: {
+                                ai_analysis_configuration?: {
+                                    inspection_type_id?: number;
+                                    /** @enum {string} */
+                                    lifecycle?: "test" | "live";
+                                    item_types?: Record<string, never>[];
+                                };
+                            };
                         };
                     };
                 };
@@ -2932,7 +3019,9 @@ export interface paths {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content?: never;
+                    content: {
+                        "application/json": components["schemas"]["AIAnalysisTestModeErrorBody"];
+                    };
                 };
                 412: components["responses"]["ErrorPreconditionFailed"];
                 500: components["responses"]["ErrorUnhandled"];
@@ -2986,7 +3075,10 @@ export interface paths {
                 500: components["responses"]["ErrorUnhandled"];
             };
         };
-        /** Unlink an AI Item Type from an Inspection Type (auto-deletes the item type if no links remain in V1) */
+        /**
+         * Unlink an AI Item Type from an Inspection Type (auto-deletes the item type if no links remain in V1)
+         * @description Unlinking the final template is a configuration removal and takes the same safety rules. Refused with 409 while a test is queued or running (`test_runs_in_progress`), or when some of the test data can no longer be removed (`test_data_not_removable`). Branch on the code, not the status.
+         */
         delete: {
             parameters: {
                 query?: never;
@@ -3016,6 +3108,7 @@ export interface paths {
                     };
                     content?: never;
                 };
+                409: components["responses"]["AIAnalysisTestModeConflict"];
                 412: components["responses"]["ErrorPreconditionFailed"];
                 500: components["responses"]["ErrorUnhandled"];
             };
@@ -3029,6 +3122,17 @@ export interface paths {
 export type webhooks = Record<string, never>;
 export interface components {
     schemas: {
+        /**
+         * @description Publication state of an inspection type's AI Analysis configuration (VISION-3122).
+         *
+         *     Absence of a value is a third, meaningful state: the configuration has never been published. That covers a type with no configuration at all and one that has linked TEMPLATEs but no lifecycle — a state `InspectionTypeModel.lockAIAnalysisForShareIfConfigured` matches deliberately. Like `TEST`, it enrolls no new inspections. `AIAnalysisLifecycleValue` names that union where a column or field can hold it.
+         *
+         *     Lifecycle belongs to the inspection type rather than to the AI Item Type TEMPLATE, because one template can be linked to several inspection types and each publishes independently. Editing a shared template therefore changes future snapshots for every linked type without changing any of their lifecycles.
+         * @enum {string}
+         */
+        AIAnalysisLifecycle: "test" | "live";
+        /** @description Lifecycle as stored and sent on the wire, including the unconfigured state. */
+        AIAnalysisLifecycleValue: components["schemas"]["AIAnalysisLifecycle"] | unknown;
         AIAnalysisStatus: {
             completed_event_count?: number;
             /** @description Number of non-deleted truepics actually evaluated by the latest completed AI Analysis run, after the AI capture cap (VISION-2118). Equals the total non-deleted count when under the cap; the cap value when over. Present only when the inspection has at least one completed extraction event — drives the summary's "N images analyzed" clause so the user sees the actually-evaluated number rather than the total non-deleted count. */
@@ -3037,6 +3141,41 @@ export interface components {
             /** @enum {string} */
             state: "idle" | "waiting" | "running" | "completed" | "failed";
         };
+        /**
+         * @description The response body every AI Analysis test-mode refusal returns (contract §Errors).
+         *
+         *     Declared here so the generated OpenAPI describes it. These refusals are written past the global error formatter — see `sendCodedError` — so they do not use the platform's `response_code`/`message` envelope, and a route that documents only a 409 description leaves a client no way to discover the `code` it is expected to branch on.
+         */
+        AIAnalysisTestModeErrorBody: {
+            error: {
+                /** @description Stable and intended for client logic. Never reworded; new categories may be added. Examples: `test_run_in_progress`, `test_runs_in_progress`, `test_data_not_removable`, `discard_blocked`, `idempotency_key_conflict`. */
+                code: string;
+                /**
+                 * @description Only information the caller is authorized to see, and never a raw database or provider message. The shape depends on `code`:
+                 *
+                 *     - `test_run_in_progress` — `{ attempt: { id, state } }`, the one attempt   blocking this inspection.
+                 *     - `test_runs_in_progress` — `{ inspections: [{ inspection_id, attempt_id,   state }] }`, every attempt blocking a type-wide operation.
+                 *     - `test_data_not_removable` — `{ generations: [{ generation_id,   extraction_event_id, reason }] }`. `extraction_event_id` names the row   when the refusal came from the event-level walk and is null otherwise;   `generation_id` is null when the refused row carries no generation.
+                 *
+                 *     On a v2-served endpoint the response converter renames keys into v2 terminology, so `inspections`/`inspection_id` arrive as `events`/`event_id`.
+                 */
+                details?: {
+                    [key: string]: unknown;
+                };
+                /** @description Safe to display or log. Clients must not branch on its wording. */
+                message: string;
+            };
+        };
+        AIAnalysisTestProjection: {
+            attempt: components["schemas"]["TestProjectionAttempt"] | unknown;
+            can_run: boolean;
+            current_configuration_fingerprint: string | null;
+            current_result: components["schemas"]["TestProjectionResult"] | unknown;
+            eligible: boolean;
+            inspection_type_lifecycle: components["schemas"]["AIAnalysisLifecycle"] | unknown;
+            results_type: components["schemas"]["TestResultsType"];
+            unavailable_reason: components["schemas"]["TestUnavailableReasonValue"] | unknown;
+        };
         AIInspectionCriteriaEvaluationModelResultV1: {
             cachedTokens: number;
             discrepancies: components["schemas"]["DiscrepanciesOutputParams"][];
@@ -3131,7 +3270,7 @@ export interface components {
             audit_json: components["schemas"]["FieldResultAuditEntry"][];
             /** @description Cross-extraction conflict candidates. Present and non-empty only when status='conflict'. Not deduplicated — vote distribution is preserved. */
             candidate_values: components["schemas"]["CandidateValue"][];
-            /** @description 0..1 consensus confidence; null when status !== 'found'. */
+            /** @description 0..1 extraction confidence; null when unavailable. Conflicts retain the new run's score despite a null row value; low-confidence checks require a non-null newest candidate answer. */
             confidence: number | null;
             /** @description Self-referential reuse provenance (VISION-2080): the prior `ai_inspection_item_field_results.id` this row was cloned from. Null on freshly-computed rows. ON DELETE SET NULL — deleting the source row leaves this as a tombstone. */
             copied_from_field_result_id: number | null;
@@ -3230,6 +3369,8 @@ export interface components {
             additional_details_considerations: string | null;
             /** @description Items-to-look-for for Additional Details. Each entry carries a UUID stable across template→instance copies; items_found[*].lookfor_id references it. */
             additional_details_lookfor: components["schemas"]["AIItemTypeLookforEntry"][];
+            /** @description The immutable configuration snapshot this row belongs to. Required for INSTANCE and TEST_INSTANCE rows (VISION-3246). Null only on TEMPLATE rows, which are editable configuration. */
+            configuration_generation_id: number | null;
             /**
              * Format: date-time
              * @description The date/time the resource was created
@@ -3237,17 +3378,17 @@ export interface components {
              */
             created_at: string;
             id: number;
-            /** @description Set for INSTANCE rows; null for TEMPLATE rows. Template rows are associated with inspection types via the ai_item_type_inspection_types junction table. */
+            /** @description Set for INSTANCE and TEST_INSTANCE rows; null for TEMPLATE rows. Template rows are associated with inspection types via the ai_item_type_inspection_types junction table. */
             inspection_id: number | null;
             name: string;
             organization_id: number;
             /** @description Informational pointer to the TEMPLATE row this INSTANCE was deep-copied from. Not a FK — survives template deletion intentionally. */
             source_item_type_id: number | null;
             /**
-             * @description Discriminates template rows (owned by an inspection type) from instance rows (frozen copies owned by an inspection).
+             * @description `TEMPLATE` is the editable configuration an administrator maintains. `INSTANCE` and `TEST_INSTANCE` are immutable snapshots owned by an inspection — the ordinary one taken at creation, and the frozen copy a test run executes against (VISION-3124).
              * @enum {string}
              */
-            type: "TEMPLATE" | "INSTANCE";
+            type: "TEMPLATE" | "INSTANCE" | "TEST_INSTANCE";
             /**
              * Format: date-time
              * @description The date/time the resource was last updated
@@ -3321,11 +3462,7 @@ export interface components {
                     disposition: "pass" | "warn";
                     field_id: number;
                     field_name: string;
-                    /**
-                     * @description True when a `found` field's `confidence` is below the configured threshold. Never true for a row whose value is the field's own configured "not present" option: that reports absence, so its confidence describes a selection rather than an answer.
-                     *
-                     *     Independent of `disposition`, which reports only whether the answer is wrong or missing and never warns for low confidence alone — so `disposition: 'pass'` with `is_low_confidence: true` means "the answer looks fine but the model was unsure", and the inspection's `ai_status` and alert still flag it for review. A field can be both.
-                     */
+                    /** @description Below-threshold, non-null row confidence on a found answer or a conflict with a non-null newest candidate value. Conflicts use the new run's score. Excludes not_captured and configured absence-option answers. Independent of disposition (wrong/missing): either flag requires review, and both may be true. */
                     is_low_confidence: boolean;
                     /** @description True when the model answered a `found` field by selecting its configured "not present" option (VISION-2692) — the row REPORTS ABSENCE, and clients must not render it as a positive finding. Mirrors `SerializedAIItemFieldResult.not_captured_option_selected` in `serializers/ai-inspection-items.ts`. */
                     not_captured_option_selected: boolean;
@@ -3404,6 +3541,465 @@ export interface components {
             photo_id?: number;
             test_key: string;
         };
+        /** @description An organization in a resolved audience. */
+        AnnouncementAudienceOrganization: {
+            /**
+             * @description The id of the organization.
+             * @example 1843
+             */
+            id: number;
+            /**
+             * @description The name of the organization.
+             * @example Quality Capital
+             */
+            name: string | null;
+        };
+        /** @description Exactly who an audience reaches, for the confirmation screen. */
+        AnnouncementAudiencePreview: {
+            /**
+             * @description How many of those organizations already have the announced feature enabled, and so would see the already-enabled copy and settings button rather than the call to action. Null when the announcement names no feature.
+             * @example 18
+             */
+            feature_enabled_organization_count: number | null;
+            /**
+             * @description How many active organizations the announcement resolves to. Always the whole audience, even when `organizations` is capped.
+             * @example 42
+             */
+            organization_count: number;
+            /** @description The first organizations in the audience, by name, capped at 100. */
+            organizations: components["schemas"]["AnnouncementAudienceOrganization"][];
+            /**
+             * @description Whether the audience is larger than the returned `organizations`.
+             * @example false
+             */
+            truncated: boolean;
+            /**
+             * @description How many dashboard users across those organizations would be shown the announcement. Counts people rather than memberships, so someone with a role in several targeted organizations is counted once. Excludes inspection recipients, bot accounts, super admins and deleted users.
+             * @example 318
+             */
+            user_count: number;
+        };
+        /**
+         * @description The request body for POST /announcements/manage/audience-preview — the targeting as the form currently holds it, rather than as it is stored.
+         *
+         *     Every field is optional, and an empty body is the widest audience there is: every active organization, nothing excluded, no feature named. That is the default the authoring form starts on, which is why it can ask this before anything has been saved.
+         */
+        AnnouncementAudiencePreviewProps: {
+            /**
+             * @description Whether the audience starts global or is narrowed to industries. Defaults to `global`.
+             * @example industries
+             */
+            audience_scope?: components["schemas"]["AnnouncementAudienceScope"];
+            /**
+             * @description The organizations to subtract from the resolved audience. Defaults to none.
+             * @example [
+             *       1843
+             *     ]
+             */
+            excluded_organization_ids?: number[];
+            /**
+             * @description The announced feature, if any, so the already-enabled split can be counted for copy that has not been saved yet. Defaults to none, and the split is answered as `null` rather than 0 when no feature is named.
+             * @example ai_analysis_configuration
+             */
+            feature_identifier?: components["schemas"]["OrganizationEnabledFeatureType"] | unknown;
+            /**
+             * @description The industries to narrow to. Only meaningful under the `industries` scope. Defaults to none, and an `industries` scope with none resolves to nobody.
+             * @example [
+             *       3,
+             *       7
+             *     ]
+             */
+            industry_ids?: number[];
+        };
+        /** @enum {string} */
+        AnnouncementAudienceScope: "global" | "industries";
+        /** @enum {string} */
+        AnnouncementBadge: "new" | "beta";
+        /** @description A row of the super-admin Manage table. */
+        AnnouncementManageRow: {
+            /**
+             * @description How the audience starts out before exclusions are subtracted.
+             * @example global
+             */
+            audience_scope: components["schemas"]["AnnouncementAudienceScope"];
+            /**
+             * @description A one-line description of who the announcement targets.
+             * @example All organizations, excluding 3 organizations
+             */
+            audience_summary: string;
+            /**
+             * Format: date-time
+             * @description The date/time the resource was created
+             * @example 2020-05-01T21:44:40.000Z
+             */
+            created_at: string;
+            /**
+             * @description How many organizations the exclusions actually take out of the reach — only those the scope had reached in the first place, so this and `organization_count` cannot contradict each other. Excluding a soft-deleted organization, or one outside the targeted industries, does not count.
+             * @example 2
+             */
+            excluded_organization_count: number;
+            /**
+             * @description The id of the resource.
+             * @example 1
+             */
+            id: number;
+            /**
+             * @description The industries the audience is narrowed to, by name. Empty when `audience_scope` is `global`.
+             * @example [
+             *       "Auto Warranty",
+             *       "Equipment Financing"
+             *     ]
+             */
+            industry_names: string[];
+            /**
+             * @description The name used to identify the announcement internally, unique across all announcements. Never *displayed* to an organization, but it is sent on the organization-facing feed: the dashboard reports it as the announcement's identity to Mixpanel, since two announcements can share a title.
+             * @example AI Analysis
+             */
+            internal_name: string;
+            /**
+             * @description Whether the announcement is still being authored. A draft is never served to organizations, whatever its publish date, so an author can set a date and keep working. Defaults to true — an announcement goes public only by deliberately clearing this.
+             * @example true
+             */
+            is_draft: boolean;
+            /**
+             * @description How many active organizations the targeting resolves to right now — a live count rather than a snapshot taken at publish time, and the same membership test the organization-facing endpoint applies.
+             * @example 270
+             */
+            organization_count: number;
+            /**
+             * @description Whether the announcement should also be promoted as a modal. Feature announcements only.
+             * @example false
+             */
+            promote_as_modal: boolean;
+            /**
+             * @description The date/time from which the announcement is live, once it is no longer a draft. Always set — a future value means it is scheduled.
+             * @example 2026-08-27T00:00:00.000Z
+             */
+            published_at: string;
+            /**
+             * @description The lifecycle status, derived from `is_draft`, `published_at` and `unpublished_at` rather than stored.
+             * @example published
+             */
+            status: components["schemas"]["AnnouncementStatus"];
+            /**
+             * @description The headline shown to the organization.
+             * @example Introducing AI Analysis!
+             */
+            title: string;
+            /**
+             * @description Which kind of announcement this is.
+             * @example feature_announcement
+             */
+            type: components["schemas"]["AnnouncementType"];
+            /**
+             * @description The date/time the announcement was unpublished. Null while it is a draft, scheduled or published; republishing clears it.
+             * @example 2026-10-01T12:00:00.000Z
+             */
+            unpublished_at: string | null;
+            /**
+             * Format: date-time
+             * @description The date/time the resource was last updated
+             * @example 2020-05-01T21:44:40.000Z
+             */
+            updated_at: string;
+        };
+        /**
+         * @description The request body for creating or updating an announcement.
+         *
+         *     `legacy_seen_state_key` is deliberately absent — it is set by the cutover migration alone, never by an author. `created_by_user_id` and `updated_by_user_id` come from the authenticated super admin.
+         */
+        AnnouncementProps: {
+            /**
+             * @description The author-set display text for the additional link.
+             * @example Learn more
+             */
+            additional_link_label?: string | null;
+            /**
+             * @description The additional link's destination.
+             * @example https://www.truepic.com/vision/ai-analysis
+             */
+            additional_link_url?: string | null;
+            /**
+             * @description How the audience starts out before exclusions are subtracted.
+             * @example global
+             */
+            audience_scope?: components["schemas"]["AnnouncementAudienceScope"];
+            /**
+             * @description The badge to show alongside the announcement, if any.
+             * @example beta
+             */
+            badge?: components["schemas"]["AnnouncementBadge"] | unknown;
+            /**
+             * @description The body copy. Plain text for feature announcements; a sanitized HTML subset for release notes.
+             * @example Let AI review inspections for you.
+             */
+            description?: string;
+            /**
+             * @description Alternate body copy shown when the announced feature is already enabled for the organization. Null when there is no alternate copy.
+             * @example AI Analysis is on for your organization.
+             */
+            description_when_enabled?: string | null;
+            /**
+             * @description The organizations to subtract from the resolved audience.
+             * @example [
+             *       1843
+             *     ]
+             */
+            excluded_organization_ids?: number[];
+            /**
+             * @description The primary call-to-action slot: the feature the blue button acts on. Whether it renders as "Activate feature" or "Request access" comes from the supported-feature-actions config, not from a stored column.
+             * @example ai_analysis_configuration
+             */
+            feature_identifier?: components["schemas"]["OrganizationEnabledFeatureType"] | unknown;
+            /**
+             * @description The URL of the announcement image. Feature announcements only.
+             * @example https://assets.truepic.com/staging/announcements/1756600000000-tpvision-ai-analysis.png
+             */
+            image_url?: string | null;
+            /**
+             * @description The industries to narrow the audience to. Only meaningful when `audience_scope` is `industries`.
+             * @example [
+             *       3,
+             *       7
+             *     ]
+             */
+            industry_ids?: number[];
+            /**
+             * @description The name used to identify the announcement internally, unique across all announcements. Never *displayed* to an organization, but it is sent on the organization-facing feed: the dashboard reports it as the announcement's identity to Mixpanel, since two announcements can share a title.
+             * @example AI Analysis
+             */
+            internal_name?: string;
+            /**
+             * @description Whether the announcement is still being authored. A draft is never served to organizations, whatever its publish date, so an author can set a date and keep working. Defaults to true — an announcement goes public only by deliberately clearing this.
+             * @example true
+             */
+            is_draft?: boolean;
+            /**
+             * @description Whether the announcement should also be promoted as a modal. Feature announcements only.
+             * @example false
+             */
+            promote_as_modal?: boolean;
+            /**
+             * @description The date/time from which the announcement is live, once it is no longer a draft. Always set — a future value means it is scheduled.
+             * @example 2026-08-27T00:00:00.000Z
+             */
+            published_at?: string;
+            /**
+             * @description The author-set display text for the settings button.
+             * @example Go to settings
+             */
+            settings_button_label?: string | null;
+            /**
+             * @description The author-set display text for the settings button, used instead of `settings_button_label` when the announced feature is already enabled for the organization. Null means `settings_button_label` is used either way.
+             * @example Manage settings
+             */
+            settings_button_label_enabled?: string | null;
+            /**
+             * @description The secondary call-to-action slot: the dashboard path the outline button navigates to, stored without the organization slug, which is supplied client-side.
+             * @example /account/settings/landing-pages
+             */
+            settings_path?: string | null;
+            /**
+             * @description The headline shown to the organization.
+             * @example Introducing AI Analysis!
+             */
+            title?: string;
+            /**
+             * @description Which kind of announcement this is.
+             * @example feature_announcement
+             */
+            type?: components["schemas"]["AnnouncementType"];
+            /**
+             * @description The date/time the announcement was unpublished. Null while it is a draft, scheduled or published; republishing clears it.
+             * @example 2026-10-01T12:00:00.000Z
+             */
+            unpublished_at?: string | null;
+        };
+        /** @description An announcement with its derived status and audience ids — what the edit form repopulates from. */
+        AnnouncementRecord: {
+            /**
+             * @description The author-set display text for the additional link.
+             * @example Learn more
+             */
+            additional_link_label: string | null;
+            /**
+             * @description The additional link's destination.
+             * @example https://www.truepic.com/vision/ai-analysis
+             */
+            additional_link_url: string | null;
+            /**
+             * @description How the audience starts out before exclusions are subtracted.
+             * @example global
+             */
+            audience_scope: components["schemas"]["AnnouncementAudienceScope"];
+            /**
+             * @description The badge to show alongside the announcement, if any.
+             * @example beta
+             */
+            badge: components["schemas"]["AnnouncementBadge"] | unknown;
+            /**
+             * Format: date-time
+             * @description The date/time the resource was created
+             * @example 2020-05-01T21:44:40.000Z
+             */
+            created_at: string;
+            /**
+             * @description The id of the user who created the announcement.
+             * @example 512
+             */
+            created_by_user_id: number | null;
+            /**
+             * @description The body copy. Plain text for feature announcements; a sanitized HTML subset for release notes.
+             * @example Let AI review inspections for you.
+             */
+            description: string;
+            /**
+             * @description Alternate body copy shown when the announced feature is already enabled for the organization. Null when there is no alternate copy.
+             * @example AI Analysis is on for your organization.
+             */
+            description_when_enabled: string | null;
+            /**
+             * @description The organizations subtracted from the resolved audience.
+             * @example [
+             *       1843
+             *     ]
+             */
+            excluded_organization_ids: number[];
+            /**
+             * @description The primary call-to-action slot: the feature the blue button acts on. Whether it renders as "Activate feature" or "Request access" comes from the supported-feature-actions config, not from a stored column.
+             * @example ai_analysis_configuration
+             */
+            feature_identifier: components["schemas"]["OrganizationEnabledFeatureType"] | unknown;
+            /**
+             * @description The id of the resource.
+             * @example 1
+             */
+            id: number;
+            /**
+             * @description The URL of the announcement image. Feature announcements only.
+             * @example https://assets.truepic.com/staging/announcements/1756600000000-tpvision-ai-analysis.png
+             */
+            image_url: string | null;
+            /**
+             * @description The industries the audience is narrowed to. Empty unless `audience_scope` is `industries`.
+             * @example [
+             *       3,
+             *       7
+             *     ]
+             */
+            industry_ids: number[];
+            /**
+             * @description The name used to identify the announcement internally, unique across all announcements. Never *displayed* to an organization, but it is sent on the organization-facing feed: the dashboard reports it as the announcement's identity to Mixpanel, since two announcements can share a title.
+             * @example AI Analysis
+             */
+            internal_name: string;
+            /**
+             * @description Whether the announcement is still being authored. A draft is never served to organizations, whatever its publish date, so an author can set a date and keep working. Defaults to true — an announcement goes public only by deliberately clearing this.
+             * @example true
+             */
+            is_draft: boolean;
+            /**
+             * @description The localStorage key that recorded "already seen" for this announcement before announcements moved into the API. Set only on the announcements migrated at cutover, so migrated content is not re-shown to users who had already dismissed it.
+             * @example vision-ui-discover-features-promoted-last-viewed
+             */
+            legacy_seen_state_key: string | null;
+            /**
+             * @description Whether the announcement should also be promoted as a modal. Feature announcements only.
+             * @example false
+             */
+            promote_as_modal: boolean;
+            /**
+             * @description The date/time from which the announcement is live, once it is no longer a draft. Always set — a future value means it is scheduled.
+             * @example 2026-08-27T00:00:00.000Z
+             */
+            published_at: string;
+            /**
+             * @description The author-set display text for the settings button.
+             * @example Go to settings
+             */
+            settings_button_label: string | null;
+            /**
+             * @description The author-set display text for the settings button, used instead of `settings_button_label` when the announced feature is already enabled for the organization. Null means `settings_button_label` is used either way.
+             * @example Manage settings
+             */
+            settings_button_label_enabled: string | null;
+            /**
+             * @description The secondary call-to-action slot: the dashboard path the outline button navigates to, stored without the organization slug, which is supplied client-side.
+             * @example /account/settings/landing-pages
+             */
+            settings_path: string | null;
+            /**
+             * @description The lifecycle status, derived rather than stored.
+             * @example scheduled
+             */
+            status: components["schemas"]["AnnouncementStatus"];
+            /**
+             * @description The headline shown to the organization.
+             * @example Introducing AI Analysis!
+             */
+            title: string;
+            /**
+             * @description Which kind of announcement this is.
+             * @example feature_announcement
+             */
+            type: components["schemas"]["AnnouncementType"];
+            /**
+             * @description The date/time the announcement was unpublished. Null while it is a draft, scheduled or published; republishing clears it.
+             * @example 2026-10-01T12:00:00.000Z
+             */
+            unpublished_at: string | null;
+            /**
+             * @description Who took the announcement down, resolved from `unpublished_by_user_id`. Null on anything that is still up, and on a takedown whose user row has been hard-deleted.
+             * @example Nick Brown
+             */
+            unpublished_by: string | null;
+            /**
+             * @description The id of the user who unpublished the announcement. Written with `unpublished_at` and cleared with it on republish, so it is never set on an announcement that is still up — but it can be null on one that is down, since deleting the user row clears it (`ON DELETE SET NULL`). Read `unpublished_at` for whether a takedown happened.
+             * @example 512
+             */
+            unpublished_by_user_id: number | null;
+            /**
+             * Format: date-time
+             * @description The date/time the resource was last updated
+             * @example 2020-05-01T21:44:40.000Z
+             */
+            updated_at: string;
+            /**
+             * @description The id of the user who last updated the announcement.
+             * @example 512
+             */
+            updated_by_user_id: number | null;
+        };
+        /** @description The audience facts a Manage row carries. The row type owns the field docs; the resolver that produces them and the serializer that writes them both take this rather than re-declaring the four. */
+        AnnouncementRowAudience: {
+            /**
+             * @description A one-line description of who the announcement targets.
+             * @example All organizations, excluding 3 organizations
+             */
+            audience_summary: string;
+            /**
+             * @description How many organizations the exclusions actually take out of the reach — only those the scope had reached in the first place, so this and `organization_count` cannot contradict each other. Excluding a soft-deleted organization, or one outside the targeted industries, does not count.
+             * @example 2
+             */
+            excluded_organization_count: number;
+            /**
+             * @description The industries the audience is narrowed to, by name. Empty when `audience_scope` is `global`.
+             * @example [
+             *       "Auto Warranty",
+             *       "Equipment Financing"
+             *     ]
+             */
+            industry_names: string[];
+            /**
+             * @description How many active organizations the targeting resolves to right now — a live count rather than a snapshot taken at publish time, and the same membership test the organization-facing endpoint applies.
+             * @example 270
+             */
+            organization_count: number;
+        };
+        /** @enum {string} */
+        AnnouncementStatus: "draft" | "scheduled" | "published" | "unpublished";
+        /** @enum {string} */
+        AnnouncementType: "feature_announcement" | "release_note";
         /** @description One entry per model call in audit_json arrays on result tables. */
         AuditEntry: {
             /** @description ISO 8601 timestamp when this model call completed. */
@@ -3851,6 +4447,11 @@ export interface components {
              * @description The date the API credentials and bot were created.
              */
             created_at: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -4015,6 +4616,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -4029,6 +4635,11 @@ export interface components {
         };
         /** @description Request Body for POST /inspection-types */
         CreateInspectionTypeBody: {
+            /**
+             * @description Publication state of this type's AI Analysis configuration (VISION-3122). Null means the configuration has never been published; `'test'` means administrators can run manual tests but new inspections get no ordinary snapshot; `'live'` means eligible new inspections are snapshotted and run automatically.
+             * @example test
+             */
+            ai_analysis_lifecycle: components["schemas"]["AIAnalysisLifecycleValue"];
             /**
              * @description the id of the user who created this inspection type. References `users.id`
              * @example 2343
@@ -4302,6 +4913,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -4339,6 +4955,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -4550,6 +5171,8 @@ export interface components {
              */
             tz: string;
         };
+        /** @enum {string} */
+        FeatureAction: "self_enable" | "request_access";
         /** @description An entry in a field result's `audit_json` array: either a per-model-call record or a suppressed-rerun verdict (VISION-2126). */
         FieldResultAuditEntry: components["schemas"]["AuditEntry"] | components["schemas"]["SuppressedExtractionAuditEntry"];
         /**
@@ -4568,6 +5191,132 @@ export interface components {
         };
         /** @description The response body for GET /auth/auth0 */
         GetAPICredentialsResult: components["schemas"]["CreateAPICredentialsResult"];
+        /** @description The response body for GET /announcements/manage/audience-options */
+        GetAnnouncementAudienceOptionsResult: {
+            /**
+             * @description The current version number of the Vision API
+             * @example 3.0.0
+             */
+            api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
+            /**
+             * @description The human readable-status of the response
+             * @example Success
+             */
+            message: string;
+            /**
+             * @description The HTTP status code of the response
+             * @example 200
+             */
+            response_code: number;
+            result: {
+                /** @description Every industry an audience can be narrowed to, by name. */
+                industries: {
+                    id: number;
+                    name: string;
+                }[];
+                /** @description Every active organization, so the authoring form can offer them as exclusions. Id and name only — the picker needs nothing else. */
+                organizations: components["schemas"]["AnnouncementAudienceOrganization"][];
+                /**
+                 * @description How many active organizations there are in total, which is what a global audience reaches and the denominator the authoring form shows a narrowed audience against.
+                 * @example 272
+                 */
+                total_organization_count: number;
+            };
+        };
+        /** @description The response body for GET /announcements/manage/{announcementID}/audience-preview */
+        GetAnnouncementAudiencePreviewResult: {
+            /**
+             * @description The current version number of the Vision API
+             * @example 3.0.0
+             */
+            api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
+            /**
+             * @description The human readable-status of the response
+             * @example Success
+             */
+            message: string;
+            /**
+             * @description The HTTP status code of the response
+             * @example 200
+             */
+            response_code: number;
+            result: components["schemas"]["AnnouncementAudiencePreview"];
+        };
+        /** @description The response body for GET /announcements/manage/{announcementID} */
+        GetAnnouncementResult: {
+            /**
+             * @description The current version number of the Vision API
+             * @example 3.0.0
+             */
+            api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
+            /**
+             * @description The human readable-status of the response
+             * @example Success
+             */
+            message: string;
+            /**
+             * @description The HTTP status code of the response
+             * @example 200
+             */
+            response_code: number;
+            /** @description The full announcement, including its audience and derived status */
+            result: components["schemas"]["AnnouncementRecord"];
+        };
+        /** @description The response body for GET /announcements/manage */
+        GetAnnouncementsResult: {
+            /**
+             * @description The current version number of the Vision API
+             * @example 3.0.0
+             */
+            api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
+            /**
+             * @description The human readable-status of the response
+             * @example Success
+             */
+            message: string;
+            /**
+             * @description The total number of pages for the given query
+             * @example 12
+             */
+            pageCount: number;
+            /**
+             * @description The HTTP status code of the response
+             * @example 200
+             */
+            response_code: number;
+            /** @description A paginated list of announcements for the Manage table */
+            result: components["schemas"]["AnnouncementManageRow"][];
+            /**
+             * @description The total number of results for the given page
+             * @example 25
+             */
+            total: number;
+            /**
+             * @description The total number of results for the given query
+             * @example 251
+             */
+            totalResults: number;
+        };
         /** @description Response Body for GET /inspections/bearer */
         GetBearerInspectionResult: {
             /**
@@ -4575,6 +5324,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -4585,7 +5339,6 @@ export interface components {
              * @example 200
              */
             response_code: number;
-            /** @description The Inspection schema with all properties optional */
             result: {
                 /**
                  * Format: address
@@ -4740,6 +5493,14 @@ export interface components {
                  * @example 4
                  */
                 inspection_status_id?: components["schemas"]["InspectionStatusId"];
+                inspection_type: {
+                    custom_fields: {
+                        /** @description The label for the custom field */
+                        label?: string;
+                    }[];
+                    /** @description Present when the web app should use verification terminology. */
+                    use_verification_terminology?: boolean;
+                };
                 /**
                  * @description The id of the inspection type this inspection is for.
                  * @example 12
@@ -4886,6 +5647,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -4905,6 +5671,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -4940,6 +5711,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -4959,6 +5735,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -4970,6 +5751,11 @@ export interface components {
              */
             response_code: number;
             result: {
+                /**
+                 * @description Publication state of this type's AI Analysis configuration (VISION-3122). Null means the configuration has never been published; `'test'` means administrators can run manual tests but new inspections get no ordinary snapshot; `'live'` means eligible new inspections are snapshotted and run automatically.
+                 * @example test
+                 */
+                ai_analysis_lifecycle: components["schemas"]["AIAnalysisLifecycleValue"];
                 /**
                  * Format: date-time
                  * @description The date/time the resource was created
@@ -5168,6 +5954,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -5202,6 +5993,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -5236,6 +6032,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -5254,6 +6055,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -5272,6 +6078,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -5306,6 +6117,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -5391,6 +6207,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -5645,6 +6466,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -5664,6 +6490,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -5686,18 +6517,47 @@ export interface components {
              */
             total: number;
             /**
-             * @description The total number of results for the given query
-             * @example 251
+             * @description The total number of results for the given query
+             * @example 251
+             */
+            totalResults: number;
+        };
+        /** @description The response body for GET /operations/{operationId} */
+        GetOperationResult: {
+            /**
+             * @description The current version number of the Vision API
+             * @example 3.0.0
+             */
+            api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
+            /**
+             * @description The human readable-status of the response
+             * @example Success
+             */
+            message: string;
+            /**
+             * @description The HTTP status code of the response
+             * @example 200
              */
-            totalResults: number;
+            response_code: number;
+            result: components["schemas"]["Operation"];
         };
-        /** @description The response body for GET /operations/{operationId} */
-        GetOperationResult: {
+        /** @description The response body for GET /announcements */
+        GetOrganizationAnnouncementsResult: {
             /**
              * @description The current version number of the Vision API
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -5708,7 +6568,16 @@ export interface components {
              * @example 200
              */
             response_code: number;
-            result: components["schemas"]["Operation"];
+            result: {
+                /** @description Every Discover Features card the organization is eligible for, newest publish date first. Not paginated — the page renders all of them. */
+                feature_announcements: components["schemas"]["OrganizationAnnouncement"][];
+                /** @description The feature announcements promoted as a modal — a subset of `feature_announcements`, in the same order. */
+                promoted: components["schemas"]["OrganizationAnnouncement"][];
+                /** @description One page of release notes, newest publish date first. */
+                release_notes: components["schemas"]["OrganizationAnnouncement"][];
+                /** @description Where `release_notes` sits in the whole set, for a "load more" control. */
+                release_notes_pagination: components["schemas"]["ReleaseNotesPagination"];
+            };
         };
         /** @description The response body for GET /inspections/bearer/support */
         GetSupportByBearerResult: {
@@ -5717,6 +6586,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -5736,6 +6610,59 @@ export interface components {
                 user_jwt: string;
             };
         };
+        /**
+         * @description The response body for GET /supported-feature-actions.
+         *
+         *     Structural rather than an alias of the service's `SupportedFeatureActions`: the schema generator reads this directory only, and a type imported from `src/services` would pull a runtime module into that pass. The two are kept in step by the enums they are both built from.
+         */
+        GetSupportedFeatureActionsResult: {
+            /**
+             * @description The current version number of the Vision API
+             * @example 3.0.0
+             */
+            api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
+            /**
+             * @description The human readable-status of the response
+             * @example Success
+             */
+            message: string;
+            /**
+             * @description The HTTP status code of the response
+             * @example 200
+             */
+            response_code: number;
+            /** @description A feature identifier → the action an organization may take on it. A feature absent from the map supports neither, and only a super admin can toggle it. */
+            result: {
+                ai_analysis?: components["schemas"]["FeatureAction"];
+                ai_analysis_configuration?: components["schemas"]["FeatureAction"];
+                ask_for_app_review?: components["schemas"]["FeatureAction"];
+                content_analysis_dot_tin?: components["schemas"]["FeatureAction"];
+                content_analysis_odometer?: components["schemas"]["FeatureAction"];
+                content_analysis_text_matching?: components["schemas"]["FeatureAction"];
+                content_analysis_vin?: components["schemas"]["FeatureAction"];
+                dashboard_user_feedback_forms?: components["schemas"]["FeatureAction"];
+                device_details?: components["schemas"]["FeatureAction"];
+                disable_selfie_capture?: components["schemas"]["FeatureAction"];
+                enable_processing_status_for_inspections?: components["schemas"]["FeatureAction"];
+                external_risk_network?: components["schemas"]["FeatureAction"];
+                guided_capture?: components["schemas"]["FeatureAction"];
+                inspection_device_insights?: components["schemas"]["FeatureAction"];
+                landing_pages?: components["schemas"]["FeatureAction"];
+                member_homepage?: components["schemas"]["FeatureAction"];
+                object_detection_auto?: components["schemas"]["FeatureAction"];
+                object_detection_jewelry?: components["schemas"]["FeatureAction"];
+                object_detection_real_estate?: components["schemas"]["FeatureAction"];
+                restrict_members_to_inspection_details?: components["schemas"]["FeatureAction"];
+                reuse_detection?: components["schemas"]["FeatureAction"];
+                risk_network?: components["schemas"]["FeatureAction"];
+                verisk_sso?: components["schemas"]["FeatureAction"];
+            };
+        };
         /** @description The response body for the GET /teams/{teamId} endpoint */
         GetTeamResult: {
             /**
@@ -5743,6 +6670,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -5871,6 +6803,11 @@ export interface components {
                  */
                 include_list: boolean;
                 inspection_types: {
+                    /**
+                     * @description Publication state of this type's AI Analysis configuration (VISION-3122). Null means the configuration has never been published; `'test'` means administrators can run manual tests but new inspections get no ordinary snapshot; `'live'` means eligible new inspections are snapshotted and run automatically.
+                     * @example test
+                     */
+                    ai_analysis_lifecycle: components["schemas"]["AIAnalysisLifecycleValue"];
                     /**
                      * Format: date-time
                      * @description The date/time the resource was created
@@ -6036,10 +6973,10 @@ export interface components {
                      */
                     name: string;
                     /**
-                     * @description the id of the organization that this inspection type belongs to. References `organizations.id`.
+                     * @description the id of the organization that this inspection type belongs to. References `organizations.id`. Null for legacy inspection types that were created without an owner.
                      * @example 14
                      */
-                    organization_id: number;
+                    organization_id: number | null;
                     /** @description The outcome set that is used by this inspection type. */
                     outcome_set?: components["schemas"]["OutcomeSet"];
                     /**
@@ -6264,6 +7201,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -6282,6 +7224,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -6316,6 +7263,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -6350,6 +7302,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -6368,6 +7325,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -6402,6 +7364,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -6437,6 +7404,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -6472,6 +7444,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -6491,6 +7468,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -6513,6 +7495,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -6547,6 +7534,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -6565,6 +7557,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -6583,6 +7580,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -7394,6 +8396,12 @@ export interface components {
              * @example P
              */
             blockchain_status: components["schemas"]["TestResult"];
+            /**
+             * @description Which camera took the photo/video: `front` (the selfie camera) or `back`.
+             * @example back
+             * @enum {string}
+             */
+            camera_facing?: "front" | "back";
             /**
              * @description The status of a capture integrity test on this Truepic.
              * @example P
@@ -7749,6 +8757,11 @@ export interface components {
         };
         /** @description The core resource representing an inspection request */
         InspectionType: {
+            /**
+             * @description Publication state of this type's AI Analysis configuration (VISION-3122). Null means the configuration has never been published; `'test'` means administrators can run manual tests but new inspections get no ordinary snapshot; `'live'` means eligible new inspections are snapshotted and run automatically.
+             * @example test
+             */
+            ai_analysis_lifecycle: components["schemas"]["AIAnalysisLifecycleValue"];
             /**
              * Format: date-time
              * @description The date/time the resource was created
@@ -7821,10 +8834,10 @@ export interface components {
              */
             name: string;
             /**
-             * @description the id of the organization that this inspection type belongs to. References `organizations.id`.
+             * @description the id of the organization that this inspection type belongs to. References `organizations.id`. Null for legacy inspection types that were created without an owner.
              * @example 14
              */
-            organization_id: number;
+            organization_id: number | null;
             /**
              * @description The id of the outcome set that is used by this inspection type. References `outcome_sets.id`
              * @example 539
@@ -7854,6 +8867,11 @@ export interface components {
             use_single_name_field: boolean;
         };
         InspectionTypeData: {
+            /**
+             * @description Publication state of this type's AI Analysis configuration (VISION-3122). Null means the configuration has never been published; `'test'` means administrators can run manual tests but new inspections get no ordinary snapshot; `'live'` means eligible new inspections are snapshotted and run automatically.
+             * @example test
+             */
+            ai_analysis_lifecycle: components["schemas"]["AIAnalysisLifecycleValue"];
             /**
              * Format: date-time
              * @description The date/time the resource was created
@@ -8838,6 +9856,112 @@ export interface components {
              */
             updated_at: string;
         };
+        /** @description One announcement as an organization sees it. Every question that depends on the organization — which body copy applies, which settings-button label applies, what the primary CTA does — is already answered; the alternates are not sent. */
+        OrganizationAnnouncement: {
+            /**
+             * @description The author-set display text for the additional link.
+             * @example Learn more
+             */
+            additional_link_label: string | null;
+            /**
+             * @description The additional link's destination.
+             * @example https://www.truepic.com/vision/ai-analysis
+             */
+            additional_link_url: string | null;
+            /**
+             * @description The badge to show alongside the announcement, if any.
+             * @example beta
+             */
+            badge: components["schemas"]["AnnouncementBadge"] | unknown;
+            /**
+             * @description The body copy that applies to this organization — the alternate copy when the announced feature is already enabled for it and that copy is set, otherwise the default. Sanitized HTML for a release note; plain text for a feature announcement.
+             * @example Let AI review inspections for you.
+             */
+            description: string;
+            /**
+             * @description The id of the resource.
+             * @example 1
+             */
+            id: number;
+            /**
+             * @description The URL of the announcement image. Feature announcements only.
+             * @example https://assets.truepic.com/staging/announcements/1756600000000-tpvision-ai-analysis.png
+             */
+            image_url: string | null;
+            /**
+             * @description The name used to identify the announcement internally, unique across all announcements. Never *displayed* to an organization, but it is sent on the organization-facing feed: the dashboard reports it as the announcement's identity to Mixpanel, since two announcements can share a title.
+             * @example AI Analysis
+             */
+            internal_name: string;
+            /**
+             * @description The localStorage key that recorded "already seen" for this announcement before announcements moved into the API. Set only on the announcements migrated at cutover, so migrated content is not re-shown to users who had already dismissed it.
+             * @example vision-ui-discover-features-promoted-last-viewed
+             */
+            legacy_seen_state_key: string | null;
+            /** @description The primary call-to-action, or null when the announcement has no feature to act on. */
+            primary_cta: components["schemas"]["OrganizationAnnouncementPrimaryCta"] | unknown;
+            /**
+             * @description The date/time from which the announcement is live, once it is no longer a draft. Always set — a future value means it is scheduled.
+             * @example 2026-08-27T00:00:00.000Z
+             */
+            published_at: string;
+            /**
+             * @description The settings-button text that applies to this organization, resolved the same way. Null when there is no settings button.
+             * @example Configure in settings
+             */
+            settings_button_label: string | null;
+            /**
+             * @description The secondary call-to-action slot: the dashboard path the outline button navigates to, stored without the organization slug, which is supplied client-side.
+             * @example /account/settings/landing-pages
+             */
+            settings_path: string | null;
+            /**
+             * @description The headline shown to the organization.
+             * @example Introducing AI Analysis!
+             */
+            title: string;
+            /**
+             * @description Which kind of announcement this is.
+             * @example feature_announcement
+             */
+            type: components["schemas"]["AnnouncementType"];
+        };
+        /** @description The primary call-to-action, resolved for the calling organization. */
+        OrganizationAnnouncementPrimaryCta: {
+            /**
+             * @description What the organization may do with it, from the `SUPPORTED_FEATURE_ACTIONS` config. Null means the config lists no action, so only a super admin can turn the feature on.
+             * @example self_enable
+             */
+            action: components["schemas"]["FeatureAction"] | unknown;
+            /**
+             * @description Whether the feature is already enabled for the organization.
+             * @example false
+             */
+            feature_enabled: boolean;
+            /**
+             * @description The feature the button acts on.
+             * @example external_risk_network
+             */
+            feature_identifier: components["schemas"]["OrganizationEnabledFeatureType"];
+            /**
+             * @description When the organization requested access to the feature, if it has.
+             * @example 2026-08-28T09:15:00.000Z
+             */
+            feature_requested_access_at: string | null;
+            /**
+             * @description Whether the organization has ever self-enabled the feature.
+             * @example false
+             */
+            feature_self_enabled: boolean;
+            /**
+             * @description The features that have to be enabled alongside it, outermost first, from the feature hierarchy. Send these with the feature when acting on it.
+             * @example [
+             *       "device_details",
+             *       "risk_network"
+             *     ]
+             */
+            required_features: components["schemas"]["OrganizationEnabledFeatureType"][];
+        };
         /** @description A feature that an organization may have enabled. */
         OrganizationEnabledFeature: {
             /**
@@ -8889,7 +10013,7 @@ export interface components {
             updated_by_user_id: number | null;
         };
         /** @enum {string} */
-        OrganizationEnabledFeatureType: "ai_analysis" | "ask_for_app_review" | "inspection_device_insights" | "device_details" | "risk_network" | "external_risk_network" | "content_analysis_odometer" | "content_analysis_text_matching" | "content_analysis_vin" | "content_analysis_dot_tin" | "object_detection_auto" | "object_detection_jewelry" | "object_detection_real_estate" | "landing_pages" | "dashboard_user_feedback_forms" | "member_homepage" | "reuse_detection" | "restrict_members_to_inspection_details" | "ai_analysis_configuration" | "guided_capture" | "verisk_sso" | "enable_processing_status_for_inspections";
+        OrganizationEnabledFeatureType: "ai_analysis" | "ask_for_app_review" | "inspection_device_insights" | "device_details" | "risk_network" | "external_risk_network" | "content_analysis_odometer" | "content_analysis_text_matching" | "content_analysis_vin" | "content_analysis_dot_tin" | "object_detection_auto" | "object_detection_jewelry" | "object_detection_real_estate" | "landing_pages" | "dashboard_user_feedback_forms" | "member_homepage" | "reuse_detection" | "restrict_members_to_inspection_details" | "ai_analysis_configuration" | "guided_capture" | "verisk_sso" | "enable_processing_status_for_inspections" | "disable_selfie_capture";
         /** @description A possible outcome for an inspection */
         Outcome: {
             /**
@@ -9415,6 +10539,11 @@ export interface components {
              */
             include_list: boolean;
             inspection_types: {
+                /**
+                 * @description Publication state of this type's AI Analysis configuration (VISION-3122). Null means the configuration has never been published; `'test'` means administrators can run manual tests but new inspections get no ordinary snapshot; `'live'` means eligible new inspections are snapshotted and run automatically.
+                 * @example test
+                 */
+                ai_analysis_lifecycle: components["schemas"]["AIAnalysisLifecycleValue"];
                 /**
                  * Format: date-time
                  * @description The date/time the resource was created
@@ -9580,10 +10709,10 @@ export interface components {
                  */
                 name: string;
                 /**
-                 * @description the id of the organization that this inspection type belongs to. References `organizations.id`.
+                 * @description the id of the organization that this inspection type belongs to. References `organizations.id`. Null for legacy inspection types that were created without an owner.
                  * @example 14
                  */
-                organization_id: number;
+                organization_id: number | null;
                 /** @description The outcome set that is used by this inspection type. */
                 outcome_set?: components["schemas"]["OutcomeSet"];
                 /**
@@ -9866,6 +10995,57 @@ export interface components {
              */
             updated_at: string;
         };
+        /** @description The response body for POST /announcements/asset/upload */
+        PostAnnouncementAssetResult: {
+            /**
+             * @description The current version number of the Vision API
+             * @example 3.0.0
+             */
+            api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
+            /**
+             * @description The human readable-status of the response
+             * @example Success
+             */
+            message: string;
+            /**
+             * @description The HTTP status code of the response
+             * @example 200
+             */
+            response_code: number;
+            result: {
+                /** @description The URL to store on `announcements.image_url` */
+                image_url: string;
+            };
+        };
+        /** @description The response body for POST /announcements/manage/audience-preview */
+        PostAnnouncementAudiencePreviewResult: {
+            /**
+             * @description The current version number of the Vision API
+             * @example 3.0.0
+             */
+            api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
+            /**
+             * @description The human readable-status of the response
+             * @example Success
+             */
+            message: string;
+            /**
+             * @description The HTTP status code of the response
+             * @example 200
+             */
+            response_code: number;
+            result: components["schemas"]["AnnouncementAudiencePreview"];
+        };
         /** @description The response body for POST /org-asset/{assetType}/upload */
         PostOrgAssetResult: {
             /**
@@ -9873,6 +11053,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -9895,6 +11080,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -9924,6 +11114,33 @@ export interface components {
             data?: Record<string, never>;
         };
         RecordWebsiteFormBearerActivityResult: components["schemas"]["ResponseData"];
+        /**
+         * @description Where the returned page of release notes sits in the whole set.
+         *
+         *     Nested rather than on the envelope because only one of the three arrays is paged, but `pageCount` / `totalResults` are deliberately the same names `generate-response.ts` puts on a paginated envelope — the same two numbers should not have two spellings in one API.
+         */
+        ReleaseNotesPagination: {
+            /**
+             * @description The page number returned.
+             * @example 1
+             */
+            number: number;
+            /**
+             * @description How many pages of release notes this organization has.
+             * @example 3
+             */
+            pageCount: number;
+            /**
+             * @description The page size used.
+             * @example 20
+             */
+            size: number;
+            /**
+             * @description How many release notes this organization has in total.
+             * @example 47
+             */
+            totalResults: number;
+        };
         /** @description The response body for DELETE /users/{userId} */
         RemoveUserResult: components["schemas"]["CreateUserResult"];
         /** @description The generic format for Vision API responses */
@@ -9933,6 +11150,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -10048,6 +11270,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -10080,6 +11307,8 @@ export interface components {
         };
         SerializedInspection: {
             ai_analysis_status?: components["schemas"]["AIAnalysisStatus"];
+            /** @description VISION-3127: the AI Analysis test alongside the inspection. Absent unless the request sent `include_ai_analysis_test=true` *and* the caller's role and organization are entitled to see test data — an unentitled request gets the ordinary response with this omitted rather than an error, so its absence carries no information about why. Declared here so the generated schema describes the object the query parameter produces, not only the parameter. */
+            ai_analysis_test?: components["schemas"]["AIAnalysisTestProjection"];
             ai_inspection_additional_details?: components["schemas"]["AIInspectionItemAdditionalDetailsResult"] | unknown;
             /** @description The reviewing member user's latest consolidated verdict feedback (all surfaces), surfaced on GET /inspections/{id}. Null when no feedback has been submitted. */
             ai_inspection_feedback?: components["schemas"]["AIInspectionFeedback"] | unknown;
@@ -10247,6 +11476,11 @@ export interface components {
             inspection_status_id: components["schemas"]["InspectionStatusId"];
             /** @description An inspection type with attached list and message template set data */
             inspection_type: {
+                /**
+                 * @description Publication state of this type's AI Analysis configuration (VISION-3122). Null means the configuration has never been published; `'test'` means administrators can run manual tests but new inspections get no ordinary snapshot; `'live'` means eligible new inspections are snapshotted and run automatically.
+                 * @example test
+                 */
+                ai_analysis_lifecycle: components["schemas"]["AIAnalysisLifecycleValue"];
                 /**
                  * Format: date-time
                  * @description The date/time the resource was created
@@ -10412,10 +11646,10 @@ export interface components {
                  */
                 name: string;
                 /**
-                 * @description the id of the organization that this inspection type belongs to. References `organizations.id`.
+                 * @description the id of the organization that this inspection type belongs to. References `organizations.id`. Null for legacy inspection types that were created without an owner.
                  * @example 14
                  */
-                organization_id: number;
+                organization_id: number | null;
                 /** @description The outcome set that is used by this inspection type. */
                 outcome_set?: components["schemas"]["OutcomeSet"];
                 /**
@@ -10908,6 +12142,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The ID of the newly created resource
              * @example 5
@@ -11373,6 +12612,16 @@ export interface components {
              *     }
              */
             custom_headers?: Record<string, never> | unknown;
+            /**
+             * @description The events this webhook receives. Null — the default, and what every webhook created before this field existed holds — means every event.
+             *
+             *     A `v2` webhook reads these back in their v2 spelling (`ACTION_INSPECTION_CREATED` for `ACTION_INSPECTION_CREATED`), and either spelling is accepted on write.
+             * @example [
+             *       "ACTION_INSPECTION_CREATED",
+             *       "ACTION_STATUS_READY_FOR_REVIEW"
+             *     ]
+             */
+            enabled_events?: components["schemas"]["WebhookEventType"][] | unknown;
             /**
              * @description Whether or not the webhook should be disabled.  If set to true, the webhook will be disabled and no longer send POST requests. If set to false, the webhook will be enabled and will send POST requests.  If you omit this field, the webhook will not change its disabled state.
              * @example false
@@ -11444,6 +12693,16 @@ export interface components {
              * @example 2023-06-01 17:12:20.097233+00
              */
             disabled_at?: string | null;
+            /**
+             * @description The events this webhook receives. Null — the default, and what every webhook created before this field existed holds — means every event.
+             *
+             *     A `v2` webhook reads these back in their v2 spelling (`ACTION_INSPECTION_CREATED` for `ACTION_INSPECTION_CREATED`), and either spelling is accepted on write.
+             * @example [
+             *       "ACTION_INSPECTION_CREATED",
+             *       "ACTION_STATUS_READY_FOR_REVIEW"
+             *     ]
+             */
+            enabled_events?: components["schemas"]["WebhookEventType"][] | unknown;
             /**
              * @description Whether or not the webhook has an OAuth `client_secret` stored.
              * @example true
@@ -11646,6 +12905,16 @@ export interface components {
              *     }
              */
             custom_headers?: Record<string, never> | unknown;
+            /**
+             * @description The events this webhook receives. Null — the default, and what every webhook created before this field existed holds — means every event.
+             *
+             *     A `v2` webhook reads these back in their v2 spelling (`ACTION_INSPECTION_CREATED` for `ACTION_INSPECTION_CREATED`), and either spelling is accepted on write.
+             * @example [
+             *       "ACTION_INSPECTION_CREATED",
+             *       "ACTION_STATUS_READY_FOR_REVIEW"
+             *     ]
+             */
+            enabled_events?: components["schemas"]["WebhookEventType"][] | unknown;
             /**
              * @description Whether or not the webhook should be disabled.  If set to true, the webhook will be disabled and no longer send POST requests. If set to false, the webhook will be enabled and will send POST requests.  If you omit this field, the webhook will not change its disabled state.
              * @example false
@@ -11712,6 +12981,16 @@ export interface components {
              * @example 2023-06-01 17:12:20.097233+00
              */
             disabled_at?: string | null;
+            /**
+             * @description The events this webhook receives. Null — the default, and what every webhook created before this field existed holds — means every event.
+             *
+             *     A `v2` webhook reads these back in their v2 spelling (`ACTION_INSPECTION_CREATED` for `ACTION_INSPECTION_CREATED`), and either spelling is accepted on write.
+             * @example [
+             *       "ACTION_INSPECTION_CREATED",
+             *       "ACTION_STATUS_READY_FOR_REVIEW"
+             *     ]
+             */
+            enabled_events?: components["schemas"]["WebhookEventType"][] | unknown;
             /**
              * @description Whether or not the webhook has an OAuth `client_secret` stored.
              * @example true
@@ -11773,11 +13052,49 @@ export interface components {
              */
             vision_api_version: components["schemas"]["VisionAPIVersion"];
         };
+        TestProjectionAttempt: {
+            completed_at: string | null;
+            configuration_fingerprint: string | null;
+            configuration_generation_id: number | null;
+            created_at: string | null;
+            error_code: string | null;
+            failed_at: string | null;
+            id: number;
+            started_at: string | null;
+            state: string;
+        };
+        TestProjectionResult: {
+            completed_at: string | null;
+            configuration_fingerprint: string | null;
+            configuration_generation_id: number | null;
+            /**
+             * @description The extraction event behind this result.
+             *
+             *     Named `extraction_event_id` rather than `event_id`: the v2/v3 terminology converter rewrites any key called `event_id` to `inspection_id` on every response, because v2 called inspections "events" — so a field named `event_id` could never reach a client under that name.
+             */
+            extraction_event_id?: number;
+            is_stale: boolean;
+        };
         /**
          * @description The possible results of a single test on a Truepic (blurriness, geo, ris, etc.)
          * @enum {string}
          */
         TestResult: "P" | "W" | "F" | "U" | "N";
+        /**
+         * @description Which result the established `ai_status`, `ai_status_details` and `ai_item_types` fields carry in this response: `test` when they carry the AI Analysis test, `ordinary` when they carry the inspection's ordinary result instead.
+         *
+         *     Read this field rather than inferring the answer from `eligible` or from `inspection_type_lifecycle`. It names where those three fields came from, not whether they hold anything.
+         *
+         *     An inspection with no analysis at all reports `ordinary`, returning the same empty response an ordinary reader would get. A first run in flight reports `test` with an empty body. A rerun in flight also reports `test`, but the earlier test's result is retained, so those fields keep carrying it until the rerun finishes or fails.
+         *
+         *     For a run's own progress, read `ai_analysis_test.attempt.state`.
+         *
+         *     It describes those three fields only. `alert`, `alert_count` and the PDF always describe the ordinary analysis whatever this says, because unpromoted tests are excluded from all three by design.
+         * @enum {string}
+         */
+        TestResultsType: "test" | "ordinary";
+        /** @enum {string} */
+        TestUnavailableReasonValue: "inspection_not_ready_for_review" | "inspection_type_not_test" | "configuration_missing";
         TextMatchingExpectedValues: {
             /**
              * @description The text matching set to compare against.
@@ -12063,6 +13380,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -12083,6 +13405,11 @@ export interface components {
         };
         /** @description Request Body for PUT /inspection-types/{inspectionTypeId} */
         UpdateInspectionTypeBody: {
+            /**
+             * @description Publication state of this type's AI Analysis configuration (VISION-3122). Null means the configuration has never been published; `'test'` means administrators can run manual tests but new inspections get no ordinary snapshot; `'live'` means eligible new inspections are snapshotted and run automatically.
+             * @example test
+             */
+            ai_analysis_lifecycle?: components["schemas"]["AIAnalysisLifecycleValue"];
             /**
              * @description the id of the user who created this inspection type. References `users.id`
              * @example 2343
@@ -12214,6 +13541,11 @@ export interface components {
              */
             api_version: string;
             data: components["schemas"]["OrganizationEnabledFeature"][];
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -12296,6 +13628,11 @@ export interface components {
              * @example 3.0.0
              */
             api_version: string;
+            /**
+             * @description A stable, machine-readable name for a rejection, sent beside the message on the 4xx responses a client has to act on rather than only display. Absent on success, and on rejections with nothing to branch on — so treat a missing value as "no specific reason given" rather than as an error.
+             * @example announcement_internal_name_taken
+             */
+            error_code?: string;
             /**
              * @description The human readable-status of the response
              * @example Success
@@ -12507,6 +13844,11 @@ export interface components {
             /** @description URI of the page or document the model relied on. One URI per source — multiple supporting URIs become multiple `web_lookup` entries. */
             uri: string;
         };
+        /**
+         * @description An event an outbound Vision webhook can be subscribed to via `enabled_events`.
+         * @enum {string}
+         */
+        WebhookEventType: "ACTION_INSPECTION_CREATED" | "ACTION_INSPECTION_SCHEDULED" | "ACTION_INSPECTION_RESCHEDULED" | "ACTION_STATUS_STARTED" | "ACTION_STATUS_IN_PROGRESS" | "ACTION_STATUS_PROCESSING" | "ACTION_STATUS_READY_FOR_REVIEW" | "ACTION_INSPECTION_CLOSED" | "ACTION_INSPECTION_CANCELED" | "ACTION_PHOTO_VERIFICATION_PASSED" | "ACTION_PHOTO_VERIFICATION_FAILED" | "ACTION_PHOTO_VERIFICATION_WARN" | "ACTION_PHOTO_DELETED" | "ACTION_QUESTION_ANSWERED" | "ACTION_QUESTION_ANSWER_DELETED" | "ACTION_MESSAGE_WELCOME_TEXT" | "ACTION_MESSAGE_REMINDER_TEXT" | "ACTION_MESSAGE_FINISH_REMINDER_TEXT" | "ACTION_MESSAGE_AUTO_REMINDER_TEXT" | "ACTION_MESSAGE_AUTO_FINISH_REMINDER_TEXT" | "ACTION_MESSAGE_REQUEST_TEXT" | "ACTION_MESSAGE_INSPECTION_FINISHED_TEXT" | "ACTION_CONSUMER_REPLY" | "ACTION_MESSAGE_AUTO_REPLY_TEXT" | "ACTION_MESSAGE_AGENT_REPLY_TEXT" | "ACTION_MESSAGE_RECEIVED" | "ACTION_MESSAGE_FAILED" | "ACTION_MESSAGE_UNDELIVERED" | "ACTION_MESSAGE_TEXT_DROPPED_VIA_UNSUBSCRIBE" | "ACTION_MESSAGE_WELCOME_EMAIL" | "ACTION_MESSAGE_REMINDER_EMAIL" | "ACTION_MESSAGE_FINISH_REMINDER_EMAIL" | "ACTION_MESSAGE_AUTO_REMINDER_EMAIL" | "ACTION_MESSAGE_AUTO_FINISH_REMINDER_EMAIL" | "ACTION_MESSAGE_REQUEST_EMAIL" | "ACTION_MESSAGE_INSPECTION_FINISHED_EMAIL" | "ACTION_MESSAGE_AUTO_REPLY_EMAIL" | "ACTION_MESSAGE_EMAIL_REPLY" | "ACTION_MESSAGE_EMAIL_RECEIVED" | "ACTION_MESSAGE_EMAIL_OPENED" | "ACTION_MESSAGE_EMAIL_BOUNCED" | "ACTION_MESSAGE_EMAIL_DROPPED" | "ACTION_MESSAGE_EMAIL_DROPPED_VIA_UNSUBSCRIBE" | "ACTION_MESSAGE_EMAIL_SPAM_REPORTED" | "ACTION_EMAIL_UNSUBSCRIBED" | "ACTION_EMAIL_RESUBSCRIBED" | "ACTION_APP_OPENED" | "ACTION_PDF_READY" | "ACTION_PDF_FAILED" | "ACTION_AI_ANALYSIS_FAILED";
         /**
          * @description How Vision presents the client credentials on the token request.
          *
@@ -12715,6 +14057,29 @@ export interface components {
         };
     };
     responses: {
+        /** @description The operation was refused. `code` is stable and intended for client logic; `details` depends on it. */
+        AIAnalysisTestModeConflict: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                /**
+                 * @example {
+                 *       "error": {
+                 *         "code": "test_run_in_progress",
+                 *         "message": "A test is already running for this inspection.",
+                 *         "details": {
+                 *           "attempt": {
+                 *             "id": 4711,
+                 *             "state": "running"
+                 *           }
+                 *         }
+                 *       }
+                 *     }
+                 */
+                "application/json": components["schemas"]["AIAnalysisTestModeErrorBody"];
+            };
+        };
         /** @description The request body couldn't be parsed. */
         ErrorBadRequest: {
             headers: {