@cavuno/board 4.26.0 → 4.27.0

package/dist/{_spec-EgN7VmAI.d.mts → _spec-B_pBNVUd.d.mts}

@@ -4,11 +4,8 @@ interface components {
             token: string;
         };
         AccessCheckoutBody: {
-            /**
-             * @description The offer tier to purchase (from `GET /paywall/offers/enabled`).
-             * @enum {string}
-             */
-            offerKey: "daily" | "weekly" | "monthly" | "quarterly" | "yearly" | "lifetime";
+            /** @description The opaque offer key returned by `GET /paywall/offers/enabled` (a plan ID or legacy tier key). */
+            offerKey: string;
             /** @description Relative path Stripe returns the buyer to on completion; `session_id` is appended. */
             returnPath: string;
             /** @enum {string} */
@@ -276,6 +273,89 @@ interface components {
         BoardAuthVerifyEmailBody: {
             token: string;
         };
+        BoardFormBuiltinField: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            kind: "builtin";
+            /** @description The built-in field, rendered by your own control for that key. Job: `employmentType`, `seniority`, `title`, `workArrangement`, `location`, `remoteEligibility`, `description`, `salary`, `applyMethod`, `company`. Company: `name`, `website`, `summary`, `xUrl`, `linkedinUrl`, `facebookUrl`, `logo`, `description`. Talent: `name`, `email`, `avatar`, `headline`, `location`, `jobSearchStatus`, `bio`, `experience`, `education`, `skills`, `languages`. New built-ins may be added; skip keys you do not recognise. */
+            key: string;
+            /** @description Whether the form shows this field. Omit hidden fields from the form entirely; any value already stored on a record is kept. */
+            visible: boolean;
+            /** @description Whether a submission must fill this field. Always `false` for a hidden field. Validate it in the form before submitting. */
+            required: boolean;
+            /** @description A locked built-in is always shown and required: render it wherever it sits in the order, without a way to skip it. */
+            locked: boolean;
+            lockReason: components["schemas"]["FormFieldLockReason"];
+        };
+        /** @description The operator's job, company and talent forms (Settings → Job form, Company profile, Talent profile) as ordered field lists. Render each list in order: built-ins by `key` with your own controls, custom and collection fields from the inlined `definition`. Skip entries with `visible: false`. Every field the board has appears exactly once, so a new custom field shows up at its position without code changes. */
+        BoardForms: {
+            /** @description The job posting form, in the order to render it. */
+            job: components["schemas"]["BoardJobFormField"][];
+            /** @description The company profile form, in the order to render it. Public profile fields only. */
+            company: components["schemas"]["BoardProfileFormField"][];
+            /** @description The candidate profile form, in the order to render it. Public profile fields only. */
+            talent: components["schemas"]["BoardProfileFormField"][];
+        };
+        BoardJobFormCollectionField: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            kind: "collection";
+            /** @description The collection field key used in `collectionValues`. Fetch choices from /boards/{identifier}/job-fields/{fieldKey}/choices. */
+            key: string;
+            /** @description Whether the form shows this field. Omit hidden fields from the form entirely; any value already stored on a record is kept. */
+            visible: boolean;
+            /** @description Whether a submission must fill this field. Always `false` for a hidden field. Validate it in the form before submitting. */
+            required: boolean;
+            definition: components["schemas"]["JobCollectionFieldDefinition"];
+        };
+        BoardJobFormCustomField: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            kind: "custom";
+            /** @description The custom field key used in `customFieldValues`. */
+            key: string;
+            /** @description Whether the form shows this field. Omit hidden fields from the form entirely; any value already stored on a record is kept. */
+            visible: boolean;
+            /** @description Whether a submission must fill this field. Always `false` for a hidden field. Validate it in the form before submitting. */
+            required: boolean;
+            definition: components["schemas"]["CustomFieldDefinition"];
+        };
+        BoardJobFormField: components["schemas"]["BoardFormBuiltinField"] | components["schemas"]["BoardJobFormCustomField"] | components["schemas"]["BoardJobFormCollectionField"];
+        BoardProfileFormCollectionField: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            kind: "collection";
+            /** @description The catalog field key. Fetch choices from /boards/{identifier}/profile-fields/{entity}/{fieldKey}/choices, or the signed-in owner choices endpoint. */
+            key: string;
+            /** @description Whether the form shows this field. Omit hidden fields from the form entirely; any value already stored on a record is kept. */
+            visible: boolean;
+            /** @description Whether a submission must fill this field. Always `false` for a hidden field. Validate it in the form before submitting. */
+            required: boolean;
+            definition: components["schemas"]["ProfileObjectReferenceDefinition"];
+        };
+        BoardProfileFormCustomField: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            kind: "custom";
+            /** @description The profile custom field key. */
+            key: string;
+            /** @description Whether the form shows this field. Omit hidden fields from the form entirely; any value already stored on a record is kept. */
+            visible: boolean;
+            /** @description Whether a submission must fill this field. Always `false` for a hidden field. Validate it in the form before submitting. */
+            required: boolean;
+            definition: components["schemas"]["ProfileCustomFieldDefinition"];
+        };
+        BoardProfileFormField: components["schemas"]["BoardFormBuiltinField"] | components["schemas"]["BoardProfileFormCustomField"] | components["schemas"]["BoardProfileFormCollectionField"];
         BoardSeo: {
             /** @enum {string} */
             object: "board_seo";
@@ -548,6 +628,12 @@ interface components {
             /** @description Number of jobs that contribute to this company's salary aggregates on the board (the salary sample size). `0` when there is no usable salary data — prefer this over fetching the full company-salary document just to decide whether to show a Salaries tab. Not the same as `publishedJobCount` (open roles without pay data stay at 0 here). */
             salarySampleCount: number;
             membership: components["schemas"]["PublicCompanyMembership"];
+            /** @description Values for public company custom fields, keyed by field key. Private and unknown fields are omitted. */
+            customFieldValues: {
+                [key: string]: string | number | boolean | string[];
+            };
+            /** @description Resolved public object references attached to this company. Private references are omitted. */
+            objectReferences: components["schemas"]["ResolvedProfileObjectReference"][];
             links: components["schemas"]["PublicCompanyLinks"];
         };
         CompanyPublicDetail: components["schemas"]["CompanyPublic"] & {
@@ -708,18 +794,18 @@ interface components {
             sessionKey: string;
         };
         CreateCompanyBody: {
-            /** @description Public company website URL. Normalized to a canonical apex domain when stored. */
-            website?: string;
-            /** @description One-line summary of the company. Up to 280 characters. */
-            summary?: string;
-            /** @description Long-form description of the company. Up to 25,000 characters. */
-            description?: string;
-            /** @description X (Twitter) profile URL or handle. Stored as the canonical handle. */
-            xUrl?: string;
-            /** @description LinkedIn company page URL. */
-            linkedinUrl?: string;
-            /** @description Facebook company page URL. */
-            facebookUrl?: string;
+            /** @description Public company website URL. Normalized to a canonical apex domain when stored. `null` or `""` means not set. */
+            website?: string | null;
+            /** @description One-line summary of the company. Up to 280 characters. `null` or `""` means not set. */
+            summary?: string | null;
+            /** @description Long-form description of the company, as HTML. Up to 25,000 characters. The HTML is sanitized on write: tags and attributes outside the supported formatting set (paragraphs, headings, lists, links, inline emphasis) are removed. Plain text without HTML tags is converted to paragraphs. `null` or `""` means not set. */
+            description?: string | null;
+            /** @description X (Twitter) profile URL or handle. Stored as the canonical handle. `null` or `""` means not set. */
+            xUrl?: string | null;
+            /** @description LinkedIn company page URL. `null` or `""` means not set. */
+            linkedinUrl?: string | null;
+            /** @description Facebook company page URL. `null` or `""` means not set. */
+            facebookUrl?: string | null;
             /** @description Canonical market slugs assigned to the company. Pass an empty array to clear all markets. */
             markets?: string[];
             /** @description The company's display name. */
@@ -866,11 +952,13 @@ interface components {
             key: string;
             /** @description Authoring-default label; the localized public string lives in the board template. */
             label: string;
+            /** @description Optional guidance displayed beside the field. */
+            helpText?: string;
             /**
-             * @description Field type, which dictates the value: `short_text`/`long_text` → string; `single_select` → one option key; `multi_select` → array of option keys; `boolean` → boolean; `number` → number.
+             * @description Field type, which dictates the value: `short_text`/`long_text` → plain string; `rich_text` → sanitized basic HTML; `single_select` → one option key; `multi_select` → array of option keys; `boolean` → boolean; `number` → number.
              * @enum {string}
              */
-            type: "short_text" | "long_text" | "single_select" | "multi_select" | "boolean" | "number";
+            type: "short_text" | "long_text" | "rich_text" | "single_select" | "multi_select" | "boolean" | "number";
             /** @description Present only for `single_select`/`multi_select`. A stored value is one (or, for multi, several) of these option `key`s — never a label. */
             options?: components["schemas"]["CustomFieldOption"][];
             /** @description When true, the value cannot be cleared or left empty on a write (rejected with `custom_field_required`). */
@@ -1038,7 +1126,7 @@ interface components {
             deletionEnabled: boolean;
         };
         EmployerCreateJobBody: {
-            /** @description Long-form description of the role. Up to 25,000 characters. */
+            /** @description Long-form description of the role, as HTML. Up to 25,000 characters. The HTML is sanitized on write: tags and attributes outside the supported formatting set (paragraphs, headings, lists, links, inline emphasis) are removed. Plain text without HTML tags is converted to paragraphs. */
             description: string;
             /** @description URL-friendly slug for the job. Auto-generated from `title` when omitted. */
             slug?: string;
@@ -1048,10 +1136,10 @@ interface components {
              */
             employmentType?: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other";
             /**
-             * @description Whether the role is on-site, hybrid, or fully remote. **Never valid on its own:** `on_site` and `hybrid` require at least one `officeLocations` entry, and `remote` requires `remotePermits` (use `[{"type":"worldwide","value":"worldwide"}]` for anywhere; `remoteTimezones` then auto-derives on POST). Sending it alone returns `400`.
+             * @description **Required.** Whether the role is on-site, hybrid, or fully remote: one of `on_site`, `hybrid`, `remote`. Omitting it or sending `null` returns `400`. It is not valid on its own either: `on_site` and `hybrid` require at least one `officeLocations` entry, and `remote` requires `remotePermits` (use `[{"type":"worldwide","value":"worldwide"}]` for anywhere; `remoteTimezones` then auto-derives on POST).
              * @enum {string}
              */
-            remoteOption?: "on_site" | "hybrid" | "remote";
+            remoteOption: "on_site" | "hybrid" | "remote";
             /** @description Where remote candidates must hold work authorization. Each entry is the smallest relevant scope: `worldwide`, a `world_region` (EMEA / LATAM / NA / APAC), a `continent`, a `region`, a `subregion`, a `custom` group (e.g. `EU`), a `country` (ISO 3166-1 alpha-2), or a `subdivision` (ISO 3166-2). Subdivisions auto-imply their parent country in the derived `remoteWorkPermitCountryCodes` output. Worldwide is mutually exclusive with all other entries. The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-permits`. Pass `[]` to clear an existing constraint. */
             remotePermits?: {
                 /** @enum {string} */
@@ -1075,19 +1163,19 @@ interface components {
              * @enum {string}
              */
             seniority?: "entry_level" | "associate" | "mid_level" | "senior" | "lead" | "principal" | "director" | "executive";
-            /** @description Where candidates apply. Accepts an HTTPS URL, a `mailto:` URI, or a bare email address (normalized to `mailto:` form). Omit to collect applications on the board (built-in applications). */
-            applicationUrl?: string;
-            /** @description Minimum salary, in `salaryCurrency` units. */
-            salaryMin?: number;
-            /** @description Maximum salary, in `salaryCurrency` units. */
-            salaryMax?: number;
-            /** @description Three-letter ISO 4217 currency code for `salaryMin` and `salaryMax`. */
-            salaryCurrency?: string;
-            /**
-             * @description Period the `salaryMin` and `salaryMax` figures are quoted against.
-             * @enum {string}
+            /** @description Where candidates apply. Accepts an HTTPS URL, a `mailto:` URI, or a bare email address (normalized to `mailto:` form). Omit it or pass `null` to collect applications on the board (built-in applications). */
+            applicationUrl?: string | null;
+            /** @description Minimum salary, in `salaryCurrency` units. `null` means not set. When `salaryMin` or `salaryMax` is set, `salaryCurrency` and `salaryTimeframe` are both required; otherwise `400`. */
+            salaryMin?: number | null;
+            /** @description Maximum salary, in `salaryCurrency` units. `null` means not set. When `salaryMin` or `salaryMax` is set, `salaryCurrency` and `salaryTimeframe` are both required; otherwise `400`. */
+            salaryMax?: number | null;
+            /** @description Three-letter ISO 4217 currency code for `salaryMin` and `salaryMax`. `null` means not set. Required when `salaryMin` or `salaryMax` is set; optional otherwise. */
+            salaryCurrency?: string | null;
+            /**
+             * @description Period the `salaryMin` and `salaryMax` figures are quoted against. `null` means not set. Required when `salaryMin` or `salaryMax` is set; optional otherwise.
+             * @enum {string|null}
              */
-            salaryTimeframe?: "per_year" | "per_month" | "per_week" | "per_day" | "per_hour";
+            salaryTimeframe?: "per_year" | "per_month" | "per_week" | "per_day" | "per_hour" | null;
             /** @description Up to 100 canonical skill slugs from `GET /v1/taxonomies/skills`. Every slug must exist in this account. */
             skills?: string[];
             /** @description Up to 100 canonical category slugs from `GET /v1/taxonomies/categories`. Every slug must exist in this account. */
@@ -1107,10 +1195,21 @@ interface components {
             inOfficeFrequency?: number;
             /** @description Physical office locations associated with the job. Prefer `{query: "City, Country"}` for free-form input; `{city, country, region?, locality?}` is also accepted when you already have structured fields. Each entry is resolved server-side; a country mismatch returns `400 jobs_unresolvable_location`. */
             officeLocations?: components["schemas"]["JobOfficeLocationInput"][];
+            /** @description Collection-reference selections keyed by the configured job collection field key. Values are arrays of record IDs, including for single-select fields. On PATCH omitted keys are preserved; send null or an empty array to clear a field. */
+            collectionValues?: {
+                [key: string]: string[] | unknown;
+            };
+            /** @description Per-job wording for selected collection entries, only on fields whose definition has `allowOverrides`. At most one item per selected entry; an item for an entry that is not selected on the job is rejected with `400 jobs_constraint_violation`. The list replaces the job's stored overrides: on PATCH omit it to keep them and send `[]` to clear them all. Deselecting an entry through `collectionValues` drops its override. */
+            collectionOverrides?: components["schemas"]["JobCollectionOverride"][];
             /** @description The job title. */
             title: string;
+            /** @description Board-defined custom-field values, keyed by the field `key` (definitions, including type, option keys and whether the field is required, are published on the public board context at `GET /v1/boards/:identifier` under `customFields.job`). Writes are **additive**: on `PATCH` a key you send is set/overwritten and a key you omit is preserved; on `POST` this initializes the bag. Send a key with an intentional-empty value (`null`, `""`, or `[]`) to **clear** it; `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 required field left empty, a wrong-typed value or an undefined option is rejected with `400 jobs_constraint_violation`. On `POST`, the required-field check runs only when this property is present (an empty object counts as present); a request that omits it is not rejected for a custom field it did not send. Unknown keys are ignored. */
+            customFieldValues?: {
+                [key: string]: string | string[] | boolean | number | unknown;
+            };
         };
         EmployerJob: components["schemas"]["EmployerJobSummary"] & {
+            resolvedCollectionFields: components["schemas"]["ResolvedJobCollectionField"][];
             /** @description Long-form description of the role, or `null` if not specified. */
             description: string | null;
             /** @description Where candidates apply, or `null` if not specified. An HTTPS URL or `mailto:` URI. */
@@ -1211,7 +1310,7 @@ interface components {
              */
             employmentType: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other" | null;
             /**
-             * @description Whether the role is on-site, hybrid, or fully remote, or `null` if not specified.
+             * @description Whether the role is on-site, hybrid, or fully remote. `null` only on older jobs saved without one; create requires it and `PATCH` cannot clear it.
              * @enum {string|null}
              */
             remoteOption: "on_site" | "hybrid" | "remote" | null;
@@ -1235,12 +1334,20 @@ interface components {
             isFeatured: boolean;
             /** @description Time at which the job was first published, or `null` if not yet published. ISO 8601 datetime. */
             publishedAt: string | null;
-            /** @description Time at which the job expires, or `null` if no expiry is set. ISO 8601 datetime. */
+            /** @description Time at which the job expires as an ISO 8601 datetime. `null` can appear when the expiry requirement does not apply, including for drafts and sponsored jobs; ordinary published jobs always have an expiry. */
             expiresAt: string | null;
             /** @description Time at which the job was created. ISO 8601 datetime. */
             createdAt: string;
             /** @description Time at which the job was last updated. ISO 8601 datetime. */
             updatedAt: string;
+            /** @description Board-defined custom-field values for this job, keyed by the field `key`. The definitions (label, type, option keys, required) are published on the public board context at `GET /v1/boards/:identifier` under `customFields.job`. 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. */
+            customFieldValues: {
+                [key: string]: string | string[] | boolean | number;
+            };
+            /** @description Collection record IDs keyed by configured job collection field. */
+            collectionValues: {
+                [key: string]: string[];
+            };
             links: components["schemas"]["EmployerJobLinks"];
         };
         EmployerPipeline: {
@@ -1296,7 +1403,7 @@ interface components {
             views: number;
         };
         EmployerUpdateJobBody: {
-            /** @description Long-form description of the role. Up to 25,000 characters. */
+            /** @description Long-form description of the role, as HTML. Up to 25,000 characters. The HTML is sanitized on write: tags and attributes outside the supported formatting set (paragraphs, headings, lists, links, inline emphasis) are removed. Plain text without HTML tags is converted to paragraphs. */
             description?: string;
             /** @description URL-friendly slug for the job. Auto-generated from `title` when omitted. */
             slug?: string;
@@ -1306,7 +1413,7 @@ interface components {
              */
             employmentType?: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other";
             /**
-             * @description Whether the role is on-site, hybrid, or fully remote. **Never valid on its own:** `on_site` and `hybrid` require at least one `officeLocations` entry, and `remote` requires `remotePermits` (use `[{"type":"worldwide","value":"worldwide"}]` for anywhere; `remoteTimezones` then auto-derives on POST). Sending it alone returns `400`.
+             * @description Whether the role is on-site, hybrid, or fully remote. Omitted means unchanged; `null` returns `400` because a job's workplace type can be changed but not cleared. **Never valid on its own:** `on_site` and `hybrid` require at least one `officeLocations` entry, and `remote` requires `remotePermits` (use `[{"type":"worldwide","value":"worldwide"}]` for anywhere; `remoteTimezones` then auto-derives on POST). Sending it alone returns `400`.
              * @enum {string}
              */
             remoteOption?: "on_site" | "hybrid" | "remote";
@@ -1335,14 +1442,14 @@ interface components {
             seniority?: "entry_level" | "associate" | "mid_level" | "senior" | "lead" | "principal" | "director" | "executive";
             /** @description Where candidates apply. Accepts an HTTPS URL, a `mailto:` URI, or a bare email address (normalized to `mailto:` form). Pass `null` to clear the stored value and switch the job to on-board (built-in) applications. Omitted means unchanged. */
             applicationUrl?: string | null;
-            /** @description Minimum salary, in `salaryCurrency` units. Pass `null` to clear the stored value; omitted means unchanged. */
+            /** @description Minimum salary, in `salaryCurrency` units. Pass `null` to clear the stored value; omitted means unchanged. When a request sends any salary field, the resulting salary (sent values over stored ones) must have `salaryCurrency` and `salaryTimeframe` whenever `salaryMin` or `salaryMax` is set; otherwise `400`. Requests that send no salary field are not checked. */
             salaryMin?: number | null;
-            /** @description Maximum salary, in `salaryCurrency` units. Pass `null` to clear the stored value; omitted means unchanged. */
+            /** @description Maximum salary, in `salaryCurrency` units. Pass `null` to clear the stored value; omitted means unchanged. When a request sends any salary field, the resulting salary (sent values over stored ones) must have `salaryCurrency` and `salaryTimeframe` whenever `salaryMin` or `salaryMax` is set; otherwise `400`. Requests that send no salary field are not checked. */
             salaryMax?: number | null;
-            /** @description Three-letter ISO 4217 currency code for `salaryMin` and `salaryMax`. Pass `null` to clear the stored value; omitted means unchanged. */
+            /** @description Three-letter ISO 4217 currency code for `salaryMin` and `salaryMax`. Pass `null` to clear the stored value; omitted means unchanged. When a request sends any salary field, the resulting salary (sent values over stored ones) must have `salaryCurrency` and `salaryTimeframe` whenever `salaryMin` or `salaryMax` is set; otherwise `400`. Requests that send no salary field are not checked. */
             salaryCurrency?: string | null;
             /**
-             * @description Period the `salaryMin` and `salaryMax` figures are quoted against. Pass `null` to clear the stored value; omitted means unchanged.
+             * @description Period the `salaryMin` and `salaryMax` figures are quoted against. Pass `null` to clear the stored value; omitted means unchanged. When a request sends any salary field, the resulting salary (sent values over stored ones) must have `salaryCurrency` and `salaryTimeframe` whenever `salaryMin` or `salaryMax` is set; otherwise `400`. Requests that send no salary field are not checked.
              * @enum {string|null}
              */
             salaryTimeframe?: "per_year" | "per_month" | "per_week" | "per_day" | "per_hour" | null;
@@ -1365,8 +1472,18 @@ interface components {
             inOfficeFrequency?: number;
             /** @description Physical office locations associated with the job. Prefer `{query: "City, Country"}` for free-form input; `{city, country, region?, locality?}` is also accepted when you already have structured fields. Each entry is resolved server-side; a country mismatch returns `400 jobs_unresolvable_location`. */
             officeLocations?: components["schemas"]["JobOfficeLocationInput"][];
+            /** @description Collection-reference selections keyed by the configured job collection field key. Values are arrays of record IDs, including for single-select fields. On PATCH omitted keys are preserved; send null or an empty array to clear a field. */
+            collectionValues?: {
+                [key: string]: string[] | unknown;
+            };
+            /** @description Per-job wording for selected collection entries, only on fields whose definition has `allowOverrides`. At most one item per selected entry; an item for an entry that is not selected on the job is rejected with `400 jobs_constraint_violation`. The list replaces the job's stored overrides: on PATCH omit it to keep them and send `[]` to clear them all. Deselecting an entry through `collectionValues` drops its override. */
+            collectionOverrides?: components["schemas"]["JobCollectionOverride"][];
             /** @description The job title. */
             title?: string;
+            /** @description Board-defined custom-field values, keyed by the field `key` (definitions, including type, option keys and whether the field is required, are published on the public board context at `GET /v1/boards/:identifier` under `customFields.job`). Writes are **additive**: on `PATCH` a key you send is set/overwritten and a key you omit is preserved; on `POST` this initializes the bag. Send a key with an intentional-empty value (`null`, `""`, or `[]`) to **clear** it; `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 required field left empty, a wrong-typed value or an undefined option is rejected with `400 jobs_constraint_violation`. On `POST`, the required-field check runs only when this property is present (an empty object counts as present); a request that omits it is not rejected for a custom field it did not send. Unknown keys are ignored. */
+            customFieldValues?: {
+                [key: string]: string | string[] | boolean | number | unknown;
+            };
         };
         /** @description The error envelope returned by every non-2xx response. */
         Error: {
@@ -1381,12 +1498,51 @@ interface components {
                 details?: unknown;
             };
         };
+        /**
+         * @description Why the field is locked, or `null` when it is not.
+         * @enum {string|null}
+         */
+        FormFieldLockReason: "google_required" | "google_hiring_organization" | "google_work_arrangement" | "google_job_location" | "google_remote_eligibility" | "posting" | "identity" | null;
         HandleAvailability: {
             /** @enum {string} */
             object: "handle_availability";
             handle: string;
             available: boolean;
         };
+        JobCollectionChoiceList: {
+            data: {
+                id: string;
+                name: string;
+                /** @description URL-safe identifier, unique within the collection. Changing it keeps the previous value reserved. */
+                slug?: string;
+                /** @description The entry's logo: the image in the collection's logo field, or a legacy logo URL on older entries. Absent when the entry has neither. */
+                logoUrl?: string;
+            }[];
+            nextCursor: string | null;
+        };
+        JobCollectionFieldDefinition: {
+            key: string;
+            label: string;
+            typeId: string;
+            multiple: boolean;
+            required: boolean;
+            /** @description Operator-set maximum number of entries a poster can select. Only meaningful when `multiple` is true; absent means the system ceiling of 100. */
+            maxSelections?: number;
+            /** @description Whether each job can replace a selected entry's title and description through `collectionOverrides`. Absent means false. */
+            allowOverrides?: boolean;
+            /** @description Key of the collection's short, long or rich text field whose value is a selected entry's default description. When that field is rich text, an entry's `description` is sanitised HTML. Absent means entries have no default description. */
+            descriptionFieldKey?: string;
+        };
+        JobCollectionOverride: {
+            /** @description The collection field key used in `collectionValues`. */
+            fieldKey: string;
+            /** @description A record ID selected for that field on this job. */
+            recordId: string;
+            /** @description The entry's title on this job, up to 160 characters. Omit or send a blank string to use the entry name. */
+            title?: string;
+            /** @description The entry's description on this job, up to 2000 characters of plain text. When the default description field is rich text, the entry's `description` returns it escaped as HTML. Omit or send a blank string to use the default description. */
+            description?: string;
+        };
         /** @description Embedded company resource for the job, or `null` if no company is attached. */
         JobCompany: {
             /** @description Unique identifier for the company. */
@@ -1717,7 +1873,7 @@ interface components {
         PaywallOffer: {
             /** @enum {string} */
             object: "paywall_offer";
-            /** @description The tier key posted to checkout (e.g. `monthly`, `lifetime`). */
+            /** @description The opaque key posted unchanged to checkout (a plan ID or legacy tier key). */
             offerKey: string;
             label: string;
             billingLabel: string;
@@ -1815,6 +1971,80 @@ interface components {
             /** @description Post title. */
             title: string;
         };
+        ProfileChoiceList: {
+            data: {
+                id: string;
+                name: string;
+                /** @description URL-safe identifier, unique within the collection. Changing it keeps the previous value reserved. */
+                slug?: string;
+                logoUrl?: string;
+            }[];
+            nextCursor: string | null;
+        };
+        ProfileCustomFieldDefinition: {
+            key: string;
+            label: string;
+            helpText?: string;
+            /** @enum {string} */
+            type: "short_text" | "long_text" | "rich_text" | "single_select" | "multi_select" | "boolean" | "number" | "date" | "url" | "email" | "phone" | "image_gallery" | "file";
+            required: boolean;
+            /** @enum {string} */
+            visibility: "private" | "public";
+            editableByOwner: boolean;
+            options?: {
+                key: string;
+                label: string;
+            }[];
+            min?: number;
+            max?: number;
+        };
+        ProfileFieldValuesBody: {
+            values: {
+                [key: string]: string | number | boolean | string[] | unknown;
+            };
+        };
+        ProfileFieldValuesResponse: {
+            definitions: components["schemas"]["ProfileCustomFieldDefinition"][];
+            values: {
+                [key: string]: string | number | boolean | string[];
+            };
+        };
+        ProfileObjectReferenceDefinition: {
+            key: string;
+            label: string;
+            typeId: string;
+            multiple: boolean;
+            /** @description Operator-set maximum number of entries a profile can select. Only meaningful when `multiple` is true; absent means the system ceiling of 100. */
+            maxSelections?: number;
+            /** @description Whether a profile must select at least one entry when this field is shown. */
+            required?: boolean;
+            /** @enum {string} */
+            visibility: "private" | "public";
+            editableByOwner: boolean;
+            allowOverrides: boolean;
+            descriptionFieldKey?: string;
+            valueDefinitions?: components["schemas"]["ScalarProfileCustomFieldDefinition"][];
+            entryDefinitions?: components["schemas"]["ScalarProfileCustomFieldDefinition"][];
+        };
+        ProfileObjectReferenceSelectionWrite: {
+            fieldKey: string;
+            recordId: string;
+            titleOverride?: string | null;
+            descriptionOverride?: string | null;
+            values?: {
+                [key: string]: string | number | boolean | string[];
+            };
+            entries?: {
+                key: string;
+                values: {
+                    [key: string]: string | number | boolean | string[];
+                };
+            }[];
+        };
+        ProfileObjectReferencesResult: {
+            definitions: components["schemas"]["ProfileObjectReferenceDefinition"][];
+            selections: components["schemas"]["ResolvedProfileObjectReference"][];
+        };
         PublicBlogAdjacentPosts: {
             /** @enum {string} */
             object: "blog_adjacent_posts";
@@ -1972,10 +2202,12 @@ interface components {
                 /** @description Default Google-issued ad unit id (10 digits). Resolves the enabled jobs:list.footer slot first, then the first enabled valid slot in alphabetical placement-key order. Null when advertising is off, the publisher id is invalid, or no enabled valid slot exists. Frontends may override it per ad unit. */
                 defaultSlotId: string | null;
             };
-            /** @description Operator-defined custom field definitions keyed by model (currently only `job`). Each key holds that model's definitions in display order. Company and talent keys are added when those models ship. The frontend uses these to render and localize each record's opaque `customFieldValues`. Display-only: not filterable or searchable in v1. */
+            /** @description Operator-defined custom field definitions keyed by model (currently only `job`). Each key holds that model's definitions in display order. The frontend uses these to render and localize each record's opaque `customFieldValues`. Supports exact-value custom-field filters in job search. Profile definitions are discovered through the profile-fields endpoint. */
             customFields: {
                 /** @description This model's custom-field definitions in display order. Empty when the board defines none for the model. */
                 job: components["schemas"]["CustomFieldDefinition"][];
+                /** @description Collection-reference job field definitions in display order. Fetch choices from /boards/{identifier}/job-fields/{fieldKey}/choices. */
+                jobCollections: components["schemas"]["JobCollectionFieldDefinition"][];
             };
             /** @description Built-in job-form field configuration from Settings → Job form (custom fields live on `customFields.job`). The platform ENFORCES these constraints when a job is created — a violation is a 400 — so a posting form that ignores them offers options the server will reject and the employer only finds out on submit. */
             jobForm: {
@@ -2018,6 +2250,7 @@ interface components {
                     allowedOptions: string[];
                 };
             };
+            forms: components["schemas"]["BoardForms"];
             /** @description Operator-authored contact and social identity (settings › Contact & company details). Extracted from the former `footer` group in 4.0.0: contact is identity data, not layout. Brand/social URLs are sanitized to absolute http(s). */
             contact: {
                 /** @description Public contact email (render as `mailto:`). Operator-set in settings › Contact & company details. */
@@ -2039,6 +2272,16 @@ interface components {
             query?: string;
             /** @description Scope the results to companies in a single market (sector), by the market slug. Resolves a board-language or English slug; an unknown slug returns 404. Use `GET /boards/:identifier/companies/markets/:market` to resolve a slug to its canonical form first. */
             marketSlug?: string;
+            /** @description Public company custom fields. Clauses are AND-matched and values within a clause are OR-matched. */
+            customFields?: {
+                key: string;
+                values: (string | number | boolean)[];
+            }[];
+            /** @description Public company catalog references. Clauses are AND-matched and record IDs within a clause are OR-matched. */
+            objectReferences?: {
+                key: string;
+                recordIds: string[];
+            }[];
             /** @description An opaque pagination cursor returned in the `nextCursor` field of a previous response. Pass it back to fetch the next page of results. */
             cursor?: string | null;
             /** @description A limit on the number of objects to be returned. Limit can range between 1 and 100. */
@@ -2089,7 +2332,7 @@ interface components {
              */
             employmentType: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other" | null;
             /**
-             * @description Whether the role is on-site, hybrid, or fully remote, or `null` if not specified.
+             * @description Whether the role is on-site, hybrid, or fully remote. `null` only on older jobs saved without one; create requires it and `PATCH` cannot clear it.
              * @enum {string|null}
              */
             remoteOption: "on_site" | "hybrid" | "remote" | null;
@@ -2113,7 +2356,7 @@ interface components {
             isFeatured: boolean;
             /** @description Time at which the job was first published, or `null` if not yet published. ISO 8601 datetime. */
             publishedAt: string | null;
-            /** @description Time at which the job expires, or `null` if no expiry is set. ISO 8601 datetime. */
+            /** @description Time at which the job expires as an ISO 8601 datetime. `null` can appear when the expiry requirement does not apply, including for drafts and sponsored jobs; ordinary published jobs always have an expiry. */
             expiresAt: string | null;
             /** @description Time at which the job was created. ISO 8601 datetime. */
             createdAt: string;
@@ -2182,10 +2425,12 @@ interface components {
                 slug: string;
                 name: string;
             }[];
-            /** @description Opaque, display-only custom-field values, 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.job` 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, 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.job` definitions (see `GET /v1/boards/:identifier`). `{}` when the board defines no custom fields. Supports exact-value custom-field filters in job search. */
             customFieldValues: {
                 [key: string]: string | string[] | boolean | number;
             };
+            /** @description Configured collection references resolved to current live names, logos, and public record details. Archived collections and records are omitted. */
+            resolvedCollectionFields: components["schemas"]["ResolvedJobCollectionField"][];
         };
         PublicJobAlertConfirmation: {
             /** @enum {string} */
@@ -2324,6 +2569,10 @@ interface components {
             /** @description Live published-job count for this place. */
             jobCount: number;
         };
+        PublicProfileFields: {
+            definitions: components["schemas"]["ProfileCustomFieldDefinition"][];
+            referenceDefinitions: components["schemas"]["ProfileObjectReferenceDefinition"][];
+        };
         PublicSearchJobsBody: {
             /** @description Free-text search query matched against job title and description. Up to 200 characters. */
             query?: string;
@@ -2344,6 +2593,8 @@ interface components {
                 employmentType?: ("full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other")[];
                 /** @description Only return jobs at any of the given seniority levels. Up to 10 values. */
                 seniority?: ("entry_level" | "associate" | "mid_level" | "senior" | "lead" | "principal" | "director" | "executive")[];
+                /** @description Only return jobs tagged with any of the given category slugs. Up to 10 values. Accepts the `sourceSlug` or the board-language `canonicalSlug` from `GET /v1/boards/{identifier}/categories`, or a `slug` from a job card's `categories`. Unknown slugs match no jobs. */
+                categories?: string[];
                 /** @description Range filter on the job's `publishedAt` timestamp. */
                 publishedAt?: {
                     /**
@@ -2361,6 +2612,11 @@ interface components {
                 location?: string;
                 /** @description Search radius in kilometres around `location` (10–250; default 50). Ignored without `location`. */
                 radius?: number;
+                /** @description Public custom job fields. Clauses are AND-matched; values within a clause are OR-matched. Up to 10 clauses and 10 values per clause. */
+                customFields?: {
+                    key: string;
+                    values: (string | number | boolean)[];
+                }[];
             };
             /** @description An opaque pagination cursor returned in the `nextCursor` field of a previous response. Pass it back to fetch the next page of results. */
             cursor?: string;
@@ -2447,6 +2703,9 @@ interface components {
             /** @description Every stage id of the job, in the new order. */
             orderedStageIds: string[];
         };
+        ReplaceProfileObjectReferenceSelectionsBody: {
+            selections: components["schemas"]["ProfileObjectReferenceSelectionWrite"][];
+        };
         ReplyBody: {
             body: string;
         };
@@ -2459,6 +2718,173 @@ interface components {
             /** Format: email */
             email: string;
         };
+        ResolvedJobCollectionField: {
+            key: string;
+            label: string;
+            entries: {
+                id: string;
+                name: string;
+                /** @description URL-safe identifier, unique within the collection. Changing it keeps the previous value reserved. */
+                slug?: string;
+                /** @description The entry's logo: the image in the collection's logo field, or a legacy logo URL on older entries. Absent when the entry has neither. */
+                logoUrl?: string;
+                /** @description The entry's title on this job: the job's `titleOverride` when set, otherwise the entry name. Render this. */
+                title: string;
+                /** @description The entry's description on this job: the job's `descriptionOverride` when set, otherwise the value of the field's default description field, or `null` when neither exists. Sanitised HTML when the default description field is rich text, with a plain-text override escaped into paragraphs. Render this. */
+                description: string | null;
+                /** @description The title this job set for the entry, or `null` when it uses the entry name. */
+                titleOverride: string | null;
+                /** @description The plain-text description this job set for the entry, or `null` when it uses the default description. */
+                descriptionOverride: string | null;
+                fields: {
+                    key: string;
+                    label: string;
+                    /** @enum {string} */
+                    type: "short_text" | "long_text" | "rich_text" | "single_select" | "multi_select" | "boolean" | "number" | "date" | "url" | "email" | "phone" | "image" | "image_gallery" | "file" | "reference";
+                    helpText?: string;
+                    options?: {
+                        key: string;
+                        label: string;
+                    }[];
+                }[];
+                values: {
+                    [key: string]: string | string[] | boolean | number | {
+                        id: string;
+                        name: string;
+                        contentType: string;
+                        sizeBytes: number;
+                        url: string;
+                    } | {
+                        id: string;
+                        name: string;
+                        contentType: string;
+                        sizeBytes: number;
+                        url: string;
+                    }[];
+                };
+                references?: {
+                    [key: string]: {
+                        id: string;
+                        name: string;
+                        /** @description URL-safe identifier, unique within the collection. Changing it keeps the previous value reserved. */
+                        slug?: string;
+                        fields: {
+                            key: string;
+                            label: string;
+                            /** @enum {string} */
+                            type: "short_text" | "long_text" | "rich_text" | "single_select" | "multi_select" | "boolean" | "number" | "date" | "url" | "email" | "phone" | "image" | "image_gallery" | "file" | "reference";
+                            helpText?: string;
+                            options?: {
+                                key: string;
+                                label: string;
+                            }[];
+                        }[];
+                        values: {
+                            [key: string]: string | string[] | boolean | number | {
+                                id: string;
+                                name: string;
+                                contentType: string;
+                                sizeBytes: number;
+                                url: string;
+                            } | {
+                                id: string;
+                                name: string;
+                                contentType: string;
+                                sizeBytes: number;
+                                url: string;
+                            }[];
+                        };
+                    }[];
+                };
+            }[];
+        };
+        ResolvedProfileObjectReference: {
+            fieldKey: string;
+            fieldLabel: string;
+            recordId: string;
+            /** @description URL-safe identifier, unique within the collection. Changing it keeps the previous value reserved. */
+            slug?: string;
+            title: string;
+            description?: string;
+            titleOverride?: string;
+            descriptionOverride?: string;
+            /** @description The entry's logo: the image in the collection's logo field, or a legacy logo URL on older entries. Absent when the entry has neither. */
+            logoUrl?: string;
+            /** @enum {string} */
+            descriptionType?: "rich_text";
+            descriptionFieldKey?: string;
+            fields: {
+                key: string;
+                label: string;
+                /** @enum {string} */
+                type: "short_text" | "long_text" | "rich_text" | "single_select" | "multi_select" | "boolean" | "number" | "date" | "url" | "email" | "phone" | "image" | "image_gallery" | "file" | "reference";
+                helpText?: string;
+                options?: {
+                    key: string;
+                    label: string;
+                }[];
+            }[];
+            attributes: {
+                [key: string]: string | string[] | boolean | number | {
+                    id: string;
+                    name: string;
+                    contentType: string;
+                    sizeBytes: number;
+                    url: string;
+                } | {
+                    id: string;
+                    name: string;
+                    contentType: string;
+                    sizeBytes: number;
+                    url: string;
+                }[];
+            };
+            references?: {
+                [key: string]: {
+                    id: string;
+                    name: string;
+                    /** @description URL-safe identifier, unique within the collection. Changing it keeps the previous value reserved. */
+                    slug?: string;
+                    fields: {
+                        key: string;
+                        label: string;
+                        /** @enum {string} */
+                        type: "short_text" | "long_text" | "rich_text" | "single_select" | "multi_select" | "boolean" | "number" | "date" | "url" | "email" | "phone" | "image" | "image_gallery" | "file" | "reference";
+                        helpText?: string;
+                        options?: {
+                            key: string;
+                            label: string;
+                        }[];
+                    }[];
+                    values: {
+                        [key: string]: string | string[] | boolean | number | {
+                            id: string;
+                            name: string;
+                            contentType: string;
+                            sizeBytes: number;
+                            url: string;
+                        } | {
+                            id: string;
+                            name: string;
+                            contentType: string;
+                            sizeBytes: number;
+                            url: string;
+                        }[];
+                    };
+                }[];
+            };
+            valueDefinitions: components["schemas"]["ScalarProfileCustomFieldDefinition"][];
+            entryDefinitions: components["schemas"]["ScalarProfileCustomFieldDefinition"][];
+            values: {
+                [key: string]: string | number | boolean | string[];
+            };
+            entries: {
+                key: string;
+                values: {
+                    [key: string]: string | number | boolean | string[];
+                };
+            }[];
+        };
         Resume: {
             /** @enum {string} */
             object: "resume";
@@ -2554,6 +2980,10 @@ interface components {
             savedAt: string;
             job: components["schemas"]["PublicJobCard"];
         };
+        ScalarProfileCustomFieldDefinition: components["schemas"]["ProfileCustomFieldDefinition"] & {
+            /** @enum {string} */
+            type?: "short_text" | "long_text" | "rich_text" | "single_select" | "multi_select" | "boolean" | "number" | "date" | "url" | "email" | "phone";
+        };
         SendWorkEmailBody: {
             /** Format: email */
             workEmail: string;
@@ -2840,6 +3270,11 @@ interface components {
                 startDate: string | null;
                 endDate: string | null;
             }[];
+            /** @description Values for public candidate custom fields, keyed by field key. Private and unknown fields are omitted. */
+            customFieldValues: {
+                [key: string]: string | number | boolean | string[];
+            };
+            objectReferences: components["schemas"]["ResolvedProfileObjectReference"][];
         };
         TalentList: {
             id: string;
@@ -2919,6 +3354,11 @@ interface components {
                 name: string;
                 proficiency: string;
             }[];
+            /** @description Values for public candidate custom fields, keyed by field key. Private and unknown fields are omitted. */
+            customFieldValues: {
+                [key: string]: string | number | boolean | string[];
+            };
+            objectReferences: components["schemas"]["ResolvedProfileObjectReference"][];
         };
         TalentUnlock: {
             /** @enum {string} */