@cavuno/board 1.42.0 → 1.44.0

package/dist/{_spec-LdkTxfx0.d.mts → _spec-CoL3oYpG.d.mts}

@@ -128,7 +128,7 @@ interface components {
             remaining: number;
         };
         Alert: {
-            /** @description Job-alert preference ID — also the path key. */
+            /** @description Job-alert preference ID. Also the path key. */
             id: string;
             /** @enum {string} */
             object: "alert";
@@ -189,7 +189,7 @@ interface components {
             expiresAt: number | null;
         };
         Application: {
-            /** @description Application ID — the `:applicationId` path key. */
+            /** @description Application ID. Also the `:applicationId` path key. */
             id: string;
             /** @enum {string} */
             object: "application";
@@ -736,7 +736,7 @@ interface components {
             handle: string | null;
             /** @description Avatar URL, or `null`. */
             avatarUrl: string | null;
-            /** @description Whether the candidate has uploaded a resume. */
+            /** @description Whether a resume is on file. On list rows this reflects the stored pointer; on the single-candidate detail it reflects the resolved blob (always agrees with `resume !== null`), so the two can briefly disagree if a stored file was garbage-collected. */
             hasResume: boolean;
             /** @description ISO-8601 timestamp of when the candidate registered. */
             createdAt: string;
@@ -765,6 +765,7 @@ interface components {
             savedJobCount: number;
             /** @description Number of job alerts the candidate has. */
             alertCount: number;
+            resume: components["schemas"]["CandidateResumeFile"];
         };
         CandidateEducation: {
             id: string;
@@ -822,6 +823,15 @@ interface components {
             jobSearchStatusVisibleTo: "everyone" | "employers_only";
             openToRelocate: boolean;
         };
+        /** @description Signed Convex storage URL + metadata for the uploaded resume, or `null` when no resume is on file (or the storage blob is missing). Treat the URL as sensitive PII. */
+        CandidateResumeFile: {
+            /** @description Convex storage download URL for the candidate resume. Unguessable; treat as sensitive PII. It serves the candidate’s actual resume file. Short-lived: do not cache or store it; re-fetch the candidate to get a fresh URL. */
+            url: string;
+            /** @description MIME type of the stored resume file. */
+            contentType: string;
+            /** @description Size of the resume file in bytes. */
+            sizeBytes: number;
+        } | null;
         CandidateSkill: {
             /** @enum {string} */
             object: "candidate_skill";
@@ -1386,7 +1396,7 @@ interface components {
                 type: "worldwide" | "world_region" | "continent" | "region" | "subregion" | "subdivision" | "country" | "custom";
                 value: string;
             }[];
-            /** @description Where remote candidates must be timezone-compatible. Each entry mirrors the `remotePermits` shape (`world_region`, `continent`, `region`, `subregion`, `country`) plus `timezone` (specific IANA name with optional `plusMinus` ±N hours expansion) and `all` (every timezone — equivalent of `worldwide` for permits). The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-timezones`. **When omitted on POST**, the server auto-derives this from `remotePermits` (or `[{all,all}]` if neither was provided). **PATCH never auto-re-derives** — once set, only an explicit replacement updates the stored value, even when `remotePermits` changes. Pass `[]` to clear an existing constraint. */
+            /** @description Where remote candidates must be timezone-compatible. Each entry mirrors the `remotePermits` shape (`world_region`, `continent`, `region`, `subregion`, `country`) plus `timezone` (specific IANA name with optional `plusMinus` ±N hours expansion) and `all` (every timezone: equivalent of `worldwide` for permits). The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-timezones`. **When omitted on POST**, the server auto-derives this from `remotePermits` (or `[{all,all}]` if neither was provided). **PATCH never auto-re-derives**: once set, only an explicit replacement updates the stored value, even when `remotePermits` changes. Pass `[]` to clear an existing constraint. */
             remoteTimezones?: {
                 /** @enum {string} */
                 type: "all" | "world_region" | "continent" | "region" | "subregion" | "country" | "timezone";
@@ -1443,7 +1453,7 @@ interface components {
             officeLocations?: components["schemas"]["JobOfficeLocationInput"][];
             /** @description An external identifier for the job from your own system, such as an ATS requisition ID. Use this value to look up the job later via `GET /v1/jobs?externalId=...` for deduplication. Scoped per-account: two different accounts may reuse the same `externalId` without collision. Up to 255 characters. */
             externalId?: string;
-            /** @description Board-defined custom-field values, keyed by the field `key` (definitions, including type and option keys, are published at `GET /v1/settings/job-form`). Writes are **additive**: on `PATCH` a key you send is set/overwritten and a key you omit is preserved (unsent keys are never cleared); on `POST` this initializes the bag. Send a key with an intentional-empty value — `null`, `""`, or `[]` — to **clear** it (`""`/`null` clear any type; `[]` clears a `multi_select`); `false` and `0` are kept as real values. Values must match the field type and `single_select`/`multi_select` must use defined option **keys** (not labels); a wrong-typed value is rejected (`custom_field_wrong_type`), never silently cleared. Unknown keys are ignored. The stored bag never contains `null`/empty values. */
+            /** @description Board-defined custom-field values, keyed by the field `key` (definitions, including type and option keys, are published at `GET /v1/settings/job-form`). Writes are **additive**: on `PATCH` a key you send is set/overwritten and a key you omit is preserved (unsent keys are never cleared); on `POST` this initializes the bag. Send a key with an intentional-empty value (`null`, `""`, or `[]`) to **clear** it (`""`/`null` clear any type; `[]` clears a `multi_select`); `false` and `0` are kept as real values. Values must match the field type and `single_select`/`multi_select` must use defined option **keys** (not labels); a wrong-typed value is rejected (`custom_field_wrong_type`), never silently cleared. Unknown keys are ignored. The stored bag never contains `null`/empty values. */
             customFieldValues?: {
                 [key: string]: string | string[] | boolean | number | unknown | unknown;
             };
@@ -1451,7 +1461,7 @@ interface components {
             title: string;
             company?: components["schemas"]["InlineCompanyInput"];
             /**
-             * @description Initial status of the job. Defaults to `draft`. Only `draft` and `published` are writable here. The system-set values `expired` and `archived` are not — use the dedicated transitions (`POST /v1/jobs/:id/publish`, `/pause`, `/expire`) for status changes after create.
+             * @description Initial status of the job. Defaults to `draft`. Only `draft` and `published` are writable here. The system-set values `expired` and `archived` are not. Use the dedicated transitions (`POST /v1/jobs/:id/publish`, `/pause`, `/expire`) for status changes after create.
              * @enum {string}
              */
             status?: "draft" | "published";
@@ -1889,7 +1899,7 @@ interface components {
                 type: "worldwide" | "world_region" | "continent" | "region" | "subregion" | "subdivision" | "country" | "custom";
                 value: string;
             }[];
-            /** @description Where remote candidates must be timezone-compatible. Each entry mirrors the `remotePermits` shape (`world_region`, `continent`, `region`, `subregion`, `country`) plus `timezone` (specific IANA name with optional `plusMinus` ±N hours expansion) and `all` (every timezone — equivalent of `worldwide` for permits). The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-timezones`. **When omitted on POST**, the server auto-derives this from `remotePermits` (or `[{all,all}]` if neither was provided). **PATCH never auto-re-derives** — once set, only an explicit replacement updates the stored value, even when `remotePermits` changes. Pass `[]` to clear an existing constraint. */
+            /** @description Where remote candidates must be timezone-compatible. Each entry mirrors the `remotePermits` shape (`world_region`, `continent`, `region`, `subregion`, `country`) plus `timezone` (specific IANA name with optional `plusMinus` ±N hours expansion) and `all` (every timezone: equivalent of `worldwide` for permits). The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-timezones`. **When omitted on POST**, the server auto-derives this from `remotePermits` (or `[{all,all}]` if neither was provided). **PATCH never auto-re-derives**: once set, only an explicit replacement updates the stored value, even when `remotePermits` changes. Pass `[]` to clear an existing constraint. */
             remoteTimezones?: {
                 /** @enum {string} */
                 type: "all" | "world_region" | "continent" | "region" | "subregion" | "country" | "timezone";
@@ -1951,7 +1961,7 @@ interface components {
                 type: string;
                 value: string;
             }[];
-            /** @description Read-only — derived from `remotePermits`. */
+            /** @description Read-only: derived from `remotePermits`. */
             remoteWorldwide: boolean | null;
             /** @description Hierarchical timezone selection. The flat `remoteAllowedTzOffsets` below is the read-only derived projection. */
             remoteTimezones: {
@@ -1959,11 +1969,11 @@ interface components {
                 value: string;
                 plusMinus?: number;
             }[];
-            /** @description Read-only — derived from `remoteTimezones`. UTC hour offsets. */
+            /** @description Read-only: derived from `remoteTimezones`. UTC hour offsets. */
             remoteAllowedTzOffsets: number[];
-            /** @description Read-only — derived from `remotePermits`. ISO 3166-1 alpha-2. */
+            /** @description Read-only: derived from `remotePermits`. ISO 3166-1 alpha-2. */
             remoteWorkPermitCountryCodes: string[];
-            /** @description Read-only — derived from `remotePermits`. ISO 3166-2. */
+            /** @description Read-only: derived from `remotePermits`. ISO 3166-2. */
             remoteWorkPermitSubdivisionCodes: string[];
             /**
              * @description Whether the employer sponsors visas for remote candidates. One of `yes`, `no`, or `unknown`.
@@ -2121,6 +2131,20 @@ interface components {
             hidden: boolean;
             position: number;
         };
+        EmployerProfileStats: {
+            /** @enum {string} */
+            object: "employer_profile_stats";
+            /** @description Company profile-page views over the all-time window (tabs and bots excluded). */
+            profileViews: number;
+        };
+        EmployerProfileViewsPoint: {
+            /** @enum {string} */
+            object: "employer_profile_views_point";
+            /** @description The UTC day this bucket covers (`YYYY-MM-DD`). */
+            date: string;
+            /** @description Company profile-page views on this day. */
+            views: number;
+        };
         EmployerSubscription: {
             id: string;
             /** @enum {string} */
@@ -2161,7 +2185,7 @@ interface components {
                 type: "worldwide" | "world_region" | "continent" | "region" | "subregion" | "subdivision" | "country" | "custom";
                 value: string;
             }[];
-            /** @description Where remote candidates must be timezone-compatible. Each entry mirrors the `remotePermits` shape (`world_region`, `continent`, `region`, `subregion`, `country`) plus `timezone` (specific IANA name with optional `plusMinus` ±N hours expansion) and `all` (every timezone — equivalent of `worldwide` for permits). The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-timezones`. **When omitted on POST**, the server auto-derives this from `remotePermits` (or `[{all,all}]` if neither was provided). **PATCH never auto-re-derives** — once set, only an explicit replacement updates the stored value, even when `remotePermits` changes. Pass `[]` to clear an existing constraint. */
+            /** @description Where remote candidates must be timezone-compatible. Each entry mirrors the `remotePermits` shape (`world_region`, `continent`, `region`, `subregion`, `country`) plus `timezone` (specific IANA name with optional `plusMinus` ±N hours expansion) and `all` (every timezone: equivalent of `worldwide` for permits). The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-timezones`. **When omitted on POST**, the server auto-derives this from `remotePermits` (or `[{all,all}]` if neither was provided). **PATCH never auto-re-derives**: once set, only an explicit replacement updates the stored value, even when `remotePermits` changes. Pass `[]` to clear an existing constraint. */
             remoteTimezones?: {
                 /** @enum {string} */
                 type: "all" | "world_region" | "continent" | "region" | "subregion" | "country" | "timezone";
@@ -2213,6 +2237,19 @@ interface components {
             /** @description The job title. */
             title?: string;
         };
+        /** @description The error envelope returned by every non-2xx response. */
+        Error: {
+            error: {
+                /** @description Machine-readable error code, such as `validation_bad_request` or `jobs_not_found`. */
+                code: string;
+                /** @description Human-readable explanation. */
+                message: string;
+                /** @description Unique id for this request. Include it when contacting support. */
+                requestId: string;
+                /** @description Structured context for some errors, such as per-field validation issues. */
+                details?: unknown;
+            };
+        };
         FeatureDefinition: {
             id: string;
             /** @enum {string} */
@@ -2506,24 +2543,24 @@ interface components {
             description: string | null;
             /** @description Where candidates apply, or `null` if not specified. An HTTPS URL or `mailto:` URI. */
             applicationUrl: string | null;
-            /** @description Hierarchical permit selection authored by the caller. Lossless round-trip with the input — `[{type:"world_region",value:"EMEA"}]` goes in and comes out the same. The three `remoteWorkPermit*` and `remoteWorldwide` fields below are read-only derived projections of this list. */
+            /** @description Hierarchical permit selection authored by the caller. Lossless round-trip with the input: `[{type:"world_region",value:"EMEA"}]` goes in and comes out the same. The three `remoteWorkPermit*` and `remoteWorldwide` fields below are read-only derived projections of this list. */
             remotePermits: {
                 type: string;
                 value: string;
             }[];
-            /** @description Read-only — derived from `remotePermits`. `true` only when the authored selection is a single `{type:"worldwide"}` entry. */
+            /** @description Read-only: derived from `remotePermits`. `true` only when the authored selection is a single `{type:"worldwide"}` entry. */
             remoteWorldwide: boolean | null;
-            /** @description Hierarchical timezone selection. Lossless round-trip with the authored input. When omitted on POST, the server auto-derives this from `remotePermits` (or `[{all,all}]` if neither was provided). PATCH never auto-re-derives — once set, only an explicit replacement updates the stored value. The flat `remoteAllowedTzOffsets` field below is the read-only derived projection used by search. */
+            /** @description Hierarchical timezone selection. Lossless round-trip with the authored input. When omitted on POST, the server auto-derives this from `remotePermits` (or `[{all,all}]` if neither was provided). PATCH never auto-re-derives: once set, only an explicit replacement updates the stored value. The flat `remoteAllowedTzOffsets` field below is the read-only derived projection used by search. */
             remoteTimezones: {
                 type: string;
                 value: string;
                 plusMinus?: number;
             }[];
-            /** @description Read-only — derived from `remoteTimezones` (per-country/per-region offset fan-out). UTC hour offsets used by the job-search index. */
+            /** @description Read-only: derived from `remoteTimezones` (per-country/per-region offset fan-out). UTC hour offsets used by the job-search index. */
             remoteAllowedTzOffsets: number[];
-            /** @description Read-only — derived from `remotePermits` (hierarchical groups fan out to alpha2 sets; subdivisions auto-add the parent country). ISO 3166-1 alpha-2 codes. */
+            /** @description Read-only: derived from `remotePermits` (hierarchical groups fan out to alpha2 sets; subdivisions auto-add the parent country). ISO 3166-1 alpha-2 codes. */
             remoteWorkPermitCountryCodes: string[];
-            /** @description Read-only — derived from `remotePermits` (subdivision entries only). ISO 3166-2 codes. */
+            /** @description Read-only: derived from `remotePermits` (subdivision entries only). ISO 3166-2 codes. */
             remoteWorkPermitSubdivisionCodes: string[];
             /**
              * @description Whether the employer sponsors visas for remote candidates. One of `yes`, `no`, or `unknown`.
@@ -2589,6 +2626,10 @@ interface components {
             /** @description Board-defined custom field definitions, in display order. Read these to learn which `customFieldValues` keys, types, and option keys a job accepts on POST/PATCH /v1/jobs. */
             customFields?: components["schemas"]["CustomFieldDefinition"][];
         };
+        JobFormCustomFieldsBody: {
+            /** @description Full replacement list of custom field definitions, in display order. Empty array removes all. Changing `type` on an existing `key` is rejected (422); delete + recreate instead. Renaming a key is delete+add and orphans per-job values under the old key. */
+            customFields: components["schemas"]["CustomFieldDefinition"][];
+        };
         JobOfficeLocation: {
             /** @description ISO 3166-1 alpha-2 country code, or `null` if the location was not resolved. */
             countryCode: string | null;
@@ -2774,7 +2815,7 @@ interface components {
             categories: string[];
             /** @description External identifier supplied by the caller on create, used for deduplication via `GET /v1/jobs?externalId=...`. `null` when no external identifier was set. */
             externalId: string | null;
-            /** @description Board-defined custom-field values for this job, keyed by the field `key` (the definitions are published at `GET /v1/settings/job-form`). Each value is returned as stored: a string (`short_text` / `long_text` / a `single_select` option key), a string array (`multi_select` option keys), a boolean, or a number. Always an object — `{}` when the job has no custom-field values, never `null` or a missing field. Only real values are stored, so this never contains `null` or empty values. */
+            /** @description Board-defined custom-field values for this job, keyed by the field `key` (the definitions are published at `GET /v1/settings/job-form`). Each value is returned as stored: a string (`short_text` / `long_text` / a `single_select` option key), a string array (`multi_select` option keys), a boolean, or a number. Always an object: `{}` when the job has no custom-field values, never `null` or a missing field. Only real values are stored, so this never contains `null` or empty values. */
             customFieldValues: {
                 [key: string]: string | string[] | boolean | number;
             };
@@ -2787,7 +2828,7 @@ interface components {
             type: string;
             /** @description Page heading (H1), with `{{board_name}}` resolved. */
             title: string;
-            /** @description Owner-authored prose as portable HTML (transitional field, ADR-0039 — the starter authors the layout). Empty string when the page has no text body. */
+            /** @description Owner-authored prose as portable HTML (transitional field, ADR-0039: the starter authors the layout). Empty string when the page has no text body. */
             content: string;
             /** @enum {string} */
             contentFormat: "html";
@@ -2800,9 +2841,9 @@ interface components {
         LocationSalaryDetail: {
             /** @enum {string} */
             object: "location_salary_detail";
-            /** @description Immutable English source place slug — the salary-stats key. */
+            /** @description Immutable English source place slug: the salary-stats key. */
             sourceSlug: string;
-            /** @description Board-language canonical URL slug — the starter 308 target. */
+            /** @description Board-language canonical URL slug: the starter 308 target. */
             canonicalSlug: string;
             placeName: string;
             placeId: string;
@@ -2919,7 +2960,7 @@ interface components {
         MediaGet: components["schemas"]["MediaUpload"] & {
             /** @description Time at which the file was uploaded. ISO 8601 datetime. */
             uploadedAt: string;
-            /** @description Resources currently referencing this file. Currently always `[]` — the resolver is not yet implemented. */
+            /** @description Resources currently referencing this file. Currently always `[]`. The resolver is not yet implemented. */
             referencedBy: {
                 /** @description Type of the resource referencing this file. */
                 resourceType: string;
@@ -3142,7 +3183,7 @@ interface components {
             requireApprovalAggregatedJobs?: boolean;
             /** @description Whether visitors must sign in to view jobs. */
             registrationWallEnabled?: boolean;
-            /** @description Whether the board's built-in ATS receives applications. When `false` (external-applications-only board), posting surfaces require an external `applicationUrl` and `POST /boards/:identifier/jobs/:jobSlug/apply` rejects with `applications_native_disabled`. Turning this off UNPUBLISHES every published native-apply job (those with no external `applicationUrl`) back to draft via an asynchronous batched drain — expect published job counts to shrink over the following seconds. Nothing is deleted, and re-enabling does NOT republish the drafted jobs. Absent means `true`. */
+            /** @description Whether the board's built-in ATS receives applications. When `false` (external-applications-only board), posting surfaces require an external `applicationUrl` and `POST /boards/:identifier/jobs/:jobSlug/apply` rejects with `applications_native_disabled`. Turning this off UNPUBLISHES every published native-apply job (those with no external `applicationUrl`) back to draft via an asynchronous batched drain. Expect published job counts to shrink over the following seconds. Nothing is deleted, and re-enabling does NOT republish the drafted jobs. Absent means `true`. */
             nativeApplicationsEnabled?: boolean;
             /** @description Whether applicant↔employer messaging is enabled. When `false`, the `me/conversations` route family rejects with `messaging_disabled` and new-message emails are suppressed. Absent means `true`. */
             applicantMessagingEnabled?: boolean;
@@ -3187,7 +3228,7 @@ interface components {
             talentNavLabel?: string;
             /** @description Custom copy displayed on the password gate. Up to 500 characters. Pass `null` to clear. */
             passwordProtectionMessage?: string | "" | unknown | unknown;
-            /** @description Free-form configuration object merged into the existing config. Reserved keys (e.g. `passwordProtectionEnabled`, `adsenseClientId`, `jobAccessPaywallEnabled`) cannot be set here — use the dedicated endpoints instead. */
+            /** @description Free-form configuration object merged into the existing config. Reserved keys (e.g. `passwordProtectionEnabled`, `adsenseClientId`, `jobAccessPaywallEnabled`) cannot be set here. Use the dedicated endpoints instead. */
             config?: {
                 [key: string]: unknown;
             };
@@ -3390,6 +3431,11 @@ interface components {
             cursor?: string | null;
             /** @description A limit on the number of objects to be returned. Limit can range between 1 and 50. */
             limit?: number;
+            /**
+             * @description The number of posts to skip — the search page offset. Takes precedence over `cursor`; pair with the response `count` to page in parallel. `offset + limit` may not exceed 10,000.
+             * @example 0
+             */
+            offset?: number;
         };
         PublicBlogTag: components["schemas"]["PublicBlogTagEmbed"] & {
             /** @enum {string} */
@@ -3416,7 +3462,7 @@ interface components {
             primaryDomain: string | null;
             /** @description Whitelabel toggle (default `true`). Render the "Powered by Cavuno" badge unless `false`. */
             showCavunoBranding: boolean;
-            /** @description True ONLY for the platform sandbox fixture tenant — the safe target for write probes (doctor tier 3); data is reset nightly. Every real tenant board is `false`. */
+            /** @description True ONLY for the platform sandbox fixture tenant: the safe target for write probes (doctor tier 3); data is reset nightly. Every real tenant board is `false`. */
             sandbox: boolean;
             features: {
                 jobAlerts: boolean;
@@ -3431,11 +3477,11 @@ interface components {
                 impressum: boolean;
                 /** @description Whether the board accepts native (on-board ATS) applications. `false` means external-applications-only: the server rejects native submissions to `POST /jobs/:jobSlug/apply` with `applications_native_disabled` (422). Clients should hide native apply UI and treat a job with no external `applicationUrl` as not-applyable. */
                 nativeApplications: boolean;
-                /** @description Whether applicant↔employer messaging is enabled on the board. `false` means the `me/conversations` route family rejects with `messaging_disabled` (403) — hide inbox/dock/Message CTAs. */
+                /** @description Whether applicant↔employer messaging is enabled on the board. `false` means the `me/conversations` route family rejects with `messaging_disabled` (403). Hide inbox/dock/Message CTAs. */
                 messaging: boolean;
             };
             /**
-             * @description The tri-state behind `features.talentDirectory` (which is `visibility === 'public'`). Link /talent whenever this is not `'off'` — an employers-only directory renders a sign-in upsell for anonymous visitors, matching the hosted chrome.
+             * @description The tri-state behind `features.talentDirectory` (which is `visibility === 'public'`). Link /talent whenever this is not `'off'`. An employers-only directory renders a sign-in upsell for anonymous visitors, matching the hosted chrome.
              * @enum {string}
              */
             talentDirectoryVisibility: "off" | "public" | "employers_only";
@@ -3462,9 +3508,9 @@ interface components {
                     };
                 };
             } | null;
-            /** @description Operator-defined custom job-field definitions (CAV-294), in display order. Board-wide; the frontend uses these to render and localize each job's opaque `customFieldValues`. Empty when the board defines none. Display-only — not filterable or searchable in v1. */
+            /** @description Operator-defined custom job-field definitions (CAV-294), in display order. Board-wide; the frontend uses these to render and localize each job's opaque `customFieldValues`. Empty when the board defines none. Display-only: not filterable or searchable in v1. */
             customFields: components["schemas"]["CustomFieldDefinition"][];
-            /** @description Stored operator label overrides by config group (`jobCardLabels`, `navLabels`, `breadcrumbsLabels`, …) — plain-text chrome copy to merge over the `@cavuno/board` `uiCopy(language)` catalog via `uiCopy(language, labels)` (ADR-0059). Empty object when the board stores none. */
+            /** @description Stored operator label overrides by config group (`jobCardLabels`, `navLabels`, `breadcrumbsLabels`, …): plain-text chrome copy to merge over the `@cavuno/board` `uiCopy(language)` catalog via `uiCopy(language, labels)` (ADR-0059). Empty object when the board stores none. */
             labels: {
                 [key: string]: {
                     [key: string]: string;
@@ -3472,7 +3518,7 @@ interface components {
             };
             /** @description Footer/brand data the hosted board footer renders (description, contact, website + social links, navigation order). The brand/social URLs (`websiteUrl`, `facebookUrl`, `linkedinUrl`, `xUrl`) are sanitized to absolute http(s); `customLinks[].url` is served verbatim (see its own note). */
             footer: {
-                /** @description Operator-written footer brand description. May carry a `{{board_name}}` placeholder — resolve it before rendering. When null, fall back to the label catalog's `footer.defaultDescription` template. */
+                /** @description Operator-written footer brand description. May carry a `{{board_name}}` placeholder. Resolve it before rendering. When null, fall back to the label catalog's `footer.defaultDescription` template. */
                 description: string | null;
                 /** @description Public contact email for the footer About column (render as `mailto:`). */
                 contactEmail: string | null;
@@ -3481,9 +3527,9 @@ interface components {
                 xUrl: string | null;
                 facebookUrl: string | null;
                 linkedinUrl: string | null;
-                /** @description Operator-configured navigation order: system item ids (`home`, `companies`, `pricing`, `blog`) and `custom:<id>` refs into `customLinks`. Empty when the operator never reordered — render the system defaults. System items still gate on their feature flags (e.g. `blog` only when `features.blog`). */
+                /** @description Operator-configured navigation order: system item ids (`home`, `companies`, `pricing`, `blog`) and `custom:<id>` refs into `customLinks`. Empty when the operator never reordered. Render the system defaults. System items still gate on their feature flags (e.g. `blog` only when `features.blog`). */
                 navigationOrder: string[];
-                /** @description Operator-defined navigation links referenced from `navigationOrder` as `custom:<id>`; links not referenced there append after the system items (hosted-footer behavior). Each `url` is served verbatim (trimmed only) and may be a relative path (e.g. `/hub`) — unlike the brand/social URLs it is NOT run through http(s) sanitization (matching the hosted footer, which supports relative links), so a consumer MUST sanitize it before binding to an anchor href. */
+                /** @description Operator-defined navigation links referenced from `navigationOrder` as `custom:<id>`; links not referenced there append after the system items (hosted-footer behavior). Each `url` is served verbatim (trimmed only) and may be a relative path (e.g. `/hub`): unlike the brand/social URLs it is NOT run through http(s) sanitization (matching the hosted footer, which supports relative links), so a consumer MUST sanitize it before binding to an anchor href. */
                 customLinks: {
                     id: string;
                     label: string;
@@ -3502,6 +3548,11 @@ interface components {
             cursor?: string | null;
             /** @description A limit on the number of objects to be returned. Limit can range between 1 and 100. */
             limit?: number;
+            /**
+             * @description The number of companies to skip — the company catalog page offset. Takes precedence over `cursor`; pair with the response `count` to page in parallel. `offset + limit` may not exceed 10,000.
+             * @example 0
+             */
+            offset?: number;
         };
         /** @description Public-only links. The admin URL is intentionally omitted on public-board responses. */
         PublicCompanyLinks: {
@@ -3592,7 +3643,7 @@ interface components {
                 type: string;
                 value: string;
             }[];
-            /** @description Read-only — derived from `remotePermits`. `true` only when the authored selection is a single `{type:"worldwide"}` entry. */
+            /** @description Read-only: derived from `remotePermits`. `true` only when the authored selection is a single `{type:"worldwide"}` entry. */
             remoteWorldwide: boolean | null;
             /** @description Hierarchical timezone selection. The flat `remoteAllowedTzOffsets` field below is the read-only derived projection. */
             remoteTimezones: {
@@ -3600,11 +3651,11 @@ interface components {
                 value: string;
                 plusMinus?: number;
             }[];
-            /** @description Read-only — derived from `remoteTimezones`. UTC hour offsets used by the job-search index. */
+            /** @description Read-only: derived from `remoteTimezones`. UTC hour offsets used by the job-search index. */
             remoteAllowedTzOffsets: number[];
-            /** @description Read-only — derived from `remotePermits` (hierarchical groups fan out to alpha2 sets; subdivisions auto-add the parent country). ISO 3166-1 alpha-2 codes. */
+            /** @description Read-only: derived from `remotePermits` (hierarchical groups fan out to alpha2 sets; subdivisions auto-add the parent country). ISO 3166-1 alpha-2 codes. */
             remoteWorkPermitCountryCodes: string[];
-            /** @description Read-only — derived from `remotePermits` (subdivision entries only). ISO 3166-2 codes. */
+            /** @description Read-only: derived from `remotePermits` (subdivision entries only). ISO 3166-2 codes. */
             remoteWorkPermitSubdivisionCodes: string[];
             /**
              * @description Whether the employer sponsors visas for remote candidates. One of `yes`, `no`, or `unknown`.
@@ -3627,7 +3678,7 @@ interface components {
             company: components["schemas"]["JobCompany"];
             /** @description Physical office locations associated with the job. */
             officeLocations: components["schemas"]["JobOfficeLocation"][];
-            /** @description Resolved job categories (slug + board display name) — same shape as the card; names joined server-side. */
+            /** @description Resolved job categories (slug + board display name): same shape as the card; names joined server-side. */
             categories: {
                 slug: string;
                 name: string;
@@ -3642,7 +3693,7 @@ interface components {
                 slug: string;
                 name: string;
             }[];
-            /** @description Opaque, display-only custom-field values (CAV-294), keyed by each field's `key`. Values are the option `key`(s) for select fields, or the raw boolean/number/text otherwise — resolve labels via the board's `customFields` definitions (see `GET /v1/boards/:identifier`). `{}` when the board defines no custom fields. Not filterable or searchable in v1. */
+            /** @description Opaque, display-only custom-field values (CAV-294), keyed by each field's `key`. Values are the option `key`(s) for select fields, or the raw boolean/number/text otherwise. Resolve labels via the board's `customFields` definitions (see `GET /v1/boards/:identifier`). `{}` when the board defines no custom fields. Not filterable or searchable in v1. */
             customFieldValues: {
                 [key: string]: string | string[] | boolean | number;
             };
@@ -3820,7 +3871,7 @@ interface components {
              */
             limit?: number;
             /**
-             * @description The number of jobs to skip — the job catalog page offset. Takes precedence over `cursor`. `offset + limit` may not exceed 10,000.
+             * @description The number of jobs to skip: the job catalog page offset. Takes precedence over `cursor`. `offset + limit` may not exceed 10,000.
              * @example 0
              */
             offset?: number;
@@ -3973,9 +4024,9 @@ interface components {
             segment: string;
             /** @description The aggregation interval (e.g. `1d`). */
             interval: string;
-            /** @description ISO date string — inclusive start of the snapshot range. */
+            /** @description ISO date string: inclusive start of the snapshot range. */
             rangeStart: string;
-            /** @description ISO date string — inclusive end of the snapshot range. */
+            /** @description ISO date string: inclusive end of the snapshot range. */
             rangeEnd: string;
             /** @description Provider-specific metric payload as collected. */
             payload?: unknown;
@@ -3992,15 +4043,15 @@ interface components {
             provider: string;
             /** @description Whether the integration is already fully connected. */
             connected: boolean;
-            /** @description OAuth providers only — the URL the user must visit to grant access. */
+            /** @description OAuth providers only. The URL the user must visit to grant access. */
             authorizationUrl?: string;
-            /** @description Search Console only — the site-verification DNS token. */
+            /** @description Search Console only: the site-verification DNS token. */
             verificationToken?: string;
             /** @description The board site URL the integration reports on. */
             siteUrl?: string;
-            /** @description Stripe only — the Monetization settings deep link. */
+            /** @description Stripe only: the Monetization settings deep link. */
             redirectUrl?: string;
-            /** @description Stripe only — why no OAuth URL is returned. */
+            /** @description Stripe only: why no OAuth URL is returned. */
             reason?: string;
         };
         ReportingIntegration: {
@@ -4158,7 +4209,7 @@ interface components {
             /** @description Display price text, e.g. "Contact us". */
             priceText: string;
             ctaText: string;
-            /** @description The CTA target — a URL, mailto:, or tel: link. */
+            /** @description The CTA target: a URL, mailto:, or tel: link. */
             ctaDestination: string;
             featuredBullets: string[];
             displayOrder: number;
@@ -4179,7 +4230,7 @@ interface components {
             id: string;
             /** @enum {string} */
             object: "saved_job";
-            /** @description The saved job — also the DELETE path key. */
+            /** @description The saved job id. Also the DELETE path key. */
             jobId: string;
             /** Format: date-time */
             savedAt: string;
@@ -4408,9 +4459,9 @@ interface components {
         SkillSalaryDetail: {
             /** @enum {string} */
             object: "skill_salary_detail";
-            /** @description Immutable English source slug — the salary-stats key. */
+            /** @description Immutable English source slug: the salary-stats key. */
             sourceSlug: string;
-            /** @description Board-language canonical URL slug — the starter 308 target. */
+            /** @description Board-language canonical URL slug: the starter 308 target. */
             canonicalSlug: string;
             skillName: string;
             overallSalary: {
@@ -4589,7 +4640,7 @@ interface components {
                 title: string;
                 companyName: string;
                 companyUrl: string | null;
-                /** @description Absolute logo URL for the company, resolved from `companyUrl` the same way the hosted profile renders it; `null` when the company has no usable website. Render a monogram/initials fallback when `null` (and on image error — the URL 404s when the brand has no icon). */
+                /** @description Absolute logo URL for the company, resolved from `companyUrl` the same way the hosted profile renders it; `null` when the company has no usable website. Render a monogram/initials fallback when `null` (and on image error: the URL 404s when the brand has no icon). */
                 companyLogoUrl: string | null;
                 location: string | null;
                 employmentType: string | null;
@@ -4738,9 +4789,9 @@ interface components {
         TitleSalaryDetail: {
             /** @enum {string} */
             object: "title_salary_detail";
-            /** @description Immutable English source slug — the salary-stats key. */
+            /** @description Immutable English source slug: the salary-stats key. */
             sourceSlug: string;
-            /** @description Board-language canonical URL slug — the starter 308 target. */
+            /** @description Board-language canonical URL slug: the starter 308 target. */
             canonicalSlug: string;
             categoryName: string;
             overallSalary: {
@@ -4822,7 +4873,7 @@ interface components {
             client_id?: string;
             /** @description OAuth client secret. May be supplied here or via HTTP Basic authentication. */
             client_secret?: string;
-            /** @description Optional scope narrowing. Currently ignored — issued tokens always carry the full scope registered for the client. */
+            /** @description Optional scope narrowing. Currently ignored: issued tokens always carry the full scope registered for the client. */
             scope?: string;
         };
         TokenResponse: {
@@ -5068,7 +5119,7 @@ interface components {
                 type: "worldwide" | "world_region" | "continent" | "region" | "subregion" | "subdivision" | "country" | "custom";
                 value: string;
             }[];
-            /** @description Where remote candidates must be timezone-compatible. Each entry mirrors the `remotePermits` shape (`world_region`, `continent`, `region`, `subregion`, `country`) plus `timezone` (specific IANA name with optional `plusMinus` ±N hours expansion) and `all` (every timezone — equivalent of `worldwide` for permits). The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-timezones`. **When omitted on POST**, the server auto-derives this from `remotePermits` (or `[{all,all}]` if neither was provided). **PATCH never auto-re-derives** — once set, only an explicit replacement updates the stored value, even when `remotePermits` changes. Pass `[]` to clear an existing constraint. */
+            /** @description Where remote candidates must be timezone-compatible. Each entry mirrors the `remotePermits` shape (`world_region`, `continent`, `region`, `subregion`, `country`) plus `timezone` (specific IANA name with optional `plusMinus` ±N hours expansion) and `all` (every timezone: equivalent of `worldwide` for permits). The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-timezones`. **When omitted on POST**, the server auto-derives this from `remotePermits` (or `[{all,all}]` if neither was provided). **PATCH never auto-re-derives**: once set, only an explicit replacement updates the stored value, even when `remotePermits` changes. Pass `[]` to clear an existing constraint. */
             remoteTimezones?: {
                 /** @enum {string} */
                 type: "all" | "world_region" | "continent" | "region" | "subregion" | "country" | "timezone";
@@ -5125,7 +5176,7 @@ interface components {
             officeLocations?: components["schemas"]["JobOfficeLocationInput"][];
             /** @description An external identifier for the job from your own system, such as an ATS requisition ID. Use this value to look up the job later via `GET /v1/jobs?externalId=...` for deduplication. Scoped per-account: two different accounts may reuse the same `externalId` without collision. Up to 255 characters. */
             externalId?: string;
-            /** @description Board-defined custom-field values, keyed by the field `key` (definitions, including type and option keys, are published at `GET /v1/settings/job-form`). Writes are **additive**: on `PATCH` a key you send is set/overwritten and a key you omit is preserved (unsent keys are never cleared); on `POST` this initializes the bag. Send a key with an intentional-empty value — `null`, `""`, or `[]` — to **clear** it (`""`/`null` clear any type; `[]` clears a `multi_select`); `false` and `0` are kept as real values. Values must match the field type and `single_select`/`multi_select` must use defined option **keys** (not labels); a wrong-typed value is rejected (`custom_field_wrong_type`), never silently cleared. Unknown keys are ignored. The stored bag never contains `null`/empty values. */
+            /** @description Board-defined custom-field values, keyed by the field `key` (definitions, including type and option keys, are published at `GET /v1/settings/job-form`). Writes are **additive**: on `PATCH` a key you send is set/overwritten and a key you omit is preserved (unsent keys are never cleared); on `POST` this initializes the bag. Send a key with an intentional-empty value (`null`, `""`, or `[]`) to **clear** it (`""`/`null` clear any type; `[]` clears a `multi_select`); `false` and `0` are kept as real values. Values must match the field type and `single_select`/`multi_select` must use defined option **keys** (not labels); a wrong-typed value is rejected (`custom_field_wrong_type`), never silently cleared. Unknown keys are ignored. The stored bag never contains `null`/empty values. */
             customFieldValues?: {
                 [key: string]: string | string[] | boolean | number | unknown | unknown;
             };
@@ -5213,7 +5264,7 @@ interface components {
             name?: string;
         };
         Usage: {
-            /** @description Unique identifier for the object. Equal to the account ID — usage is a per-account singleton. */
+            /** @description Unique identifier for the object. Equal to the account ID: usage is a per-account singleton. */
             id: string;
             /**
              * @description String representing the object's type. Objects of the same type share the same value.