@cavuno/board 1.3.0 → 1.5.0

package/dist/index.d.mts

@@ -1,3 +1,1870 @@
+interface components {
+    schemas: {
+        /** @description Links related to this resource. List responses only carry the `admin` URL because the public URL needs the company slug, which list-shape Convex projections do not fan out to. */
+        AdminOnlyResourceLinks: {
+            /**
+             * Format: uri
+             * @description URL inside the Cavuno app where the authenticated owner can manage this resource.
+             */
+            admin: string;
+        };
+        ApiKey: {
+            /** @description Unique identifier for the object. */
+            id: string;
+            /**
+             * @description String representing the object's type. Objects of the same type share the same value.
+             * @enum {string}
+             */
+            object: "api_key";
+            /** @description Public key ID component, embedded in the key prefix as `cavuno_live_<keyId>_`. */
+            keyId: string;
+            /** @description Human-readable name for the key, shown in the dashboard. */
+            name: string;
+            /** @description Public prefix in the form `cavuno_live_<keyId>_`. Safe to log; the full plaintext secret is never returned by the API. */
+            prefix: string;
+            /** @description Time at which the key was created. Unix epoch in milliseconds. */
+            createdAt: number;
+            /** @description Identifier of the user who minted the key. */
+            createdBy: string;
+            /** @description Time at which the key was last used to authenticate a request, or `null` if it has never been used. Unix epoch in milliseconds. */
+            lastUsedAt: number | null;
+            /** @description Time at which the key was revoked, or `null` if the key is still active. Unix epoch in milliseconds. */
+            revokedAt: number | null;
+            /** @description Time at which the key expires, or `null` if the key has no expiry. Unix epoch in milliseconds. */
+            expiresAt: number | null;
+        };
+        AuditLogEntry: {
+            /** @description Unique identifier for the object. */
+            id: string;
+            /**
+             * @description String representing the object's type. Objects of the same type share the same value.
+             * @enum {string}
+             */
+            object: "audit_log";
+            /** @description Identifier of the account the entry belongs to. */
+            accountId: string;
+            /**
+             * @description Type of actor that performed the action.
+             * @enum {string}
+             */
+            actorType: "api_key" | "oauth_token" | "user_session" | "system";
+            /** @description Identifier of the actor that performed the action. */
+            actorId: string;
+            /** @description Human-readable label for the actor, suitable for display. */
+            actorLabel: string;
+            /** @description Action that was performed (e.g. `jobs.create`, `companies.update`). */
+            action: string;
+            /** @description Type of resource the action was performed on. */
+            resourceType: string;
+            /** @description Identifier of the resource the action was performed on, or `null` for resource-less actions. */
+            resourceId: string | null;
+            /** @description Serialized JSON snapshot of the resource before the action, or `null` for create actions. */
+            before: string | null;
+            /** @description Serialized JSON snapshot of the resource after the action, or `null` for delete actions. */
+            after: string | null;
+            /** @description Serialized JSON of free-form metadata about the action (e.g. truncation byte sizes), or `null` if none was attached. */
+            metadata: string | null;
+            /** @description IP address the request originated from, or `null` if unavailable. */
+            ipAddress: string | null;
+            /** @description User-agent string from the request, or `null` if unavailable. */
+            userAgent: string | null;
+            /** @description Identifier of the request that produced the entry. Use this to correlate with platform logs. */
+            requestId: string;
+            /** @description Time at which the audit entry was written. Unix epoch in milliseconds. */
+            timestamp: number;
+        };
+        BatchRequestBody: {
+            /** @description Array of sub-operations to execute. Each entry runs independently and reports its result on the corresponding entry of the response `data` array. Sub-operation `id` values must be unique within the batch. Up to 100 entries. */
+            operations: ({
+                id: string;
+                /** @enum {string} */
+                method: "POST";
+                body?: unknown;
+                action?: string;
+                resourceId?: string;
+            } | {
+                id: string;
+                /** @enum {string} */
+                method: "PATCH";
+                body?: unknown;
+                resourceId: string;
+            } | {
+                id: string;
+                /** @enum {string} */
+                method: "DELETE";
+                resourceId: string;
+            })[];
+        };
+        BlogAuthor: {
+            /** @description Unique identifier for the object. Use this value as the `{id}` path parameter for the author endpoints (e.g. `GET /v1/blog/authors/{id}`). */
+            id: string;
+            /**
+             * @description String representing the object's type. Objects of the same type share the same value.
+             * @enum {string}
+             */
+            object: "blog_author";
+            /** @description Display name of the author. */
+            name: string;
+            /** @description URL-friendly slug for the author. */
+            slug: string;
+            /** @description Short biography, or `null` if not set. */
+            bio: string | null;
+            /** @description The author's email address, or `null` if not set. */
+            email: string | null;
+            /** @description Author visibility status, or `null` if not set. */
+            status: string | null;
+            /** @description URL of the author avatar, or `null` if no avatar is set. */
+            avatarUrl: string | null;
+            /** @description The author's website URL, or `null` if not set. */
+            websiteUrl: string | null;
+            /** @description The author's X (Twitter) URL, or `null` if not set. */
+            twitterUrl: string | null;
+            /** @description The author's LinkedIn URL, or `null` if not set. */
+            linkedinUrl: string | null;
+            /** @description The author's GitHub URL, or `null` if not set. */
+            githubUrl: string | null;
+            /** @description SEO meta title, or `null` if not set. */
+            metaTitle: string | null;
+            /** @description SEO meta description, or `null` if not set. */
+            metaDescription: string | null;
+            /** @description Time at which the author was created. ISO 8601 datetime. */
+            createdAt: string;
+            /** @description Time at which the author was last updated, or `null` if it has never been updated. ISO 8601 datetime. */
+            updatedAt: string | null;
+        };
+        BlogPost: components["schemas"]["BlogPostSummary"] & {
+            html: string | null;
+        };
+        BlogPostSummary: {
+            /** @description Unique identifier for the object. Use this value as the `{id}` path parameter for the blog-post endpoints (e.g. `GET /v1/blog/posts/{id}`). */
+            id: string;
+            /** @enum {string} */
+            object: "blog_post";
+            title: string;
+            slug: string;
+            status: string;
+            visibility: string;
+            type: string;
+            featured: boolean;
+            authorIds: string[];
+            tagIds: string[];
+            coverUrl: string | null;
+            ogImageUrl: string | null;
+            featureImageAlt: string | null;
+            featureImageCaption: string | null;
+            customExcerpt: string | null;
+            readingTimeMin: number | null;
+            seoTitle: string | null;
+            seoDescription: string | null;
+            canonicalUrl: string | null;
+            publishedAt: string | null;
+            createdAt: string;
+            updatedAt: string | null;
+        };
+        BlogPostsBatchRequest: {
+            /** @description Array of post sub-operations to execute. Each runs independently and reports on the matching entry of the response `data` array. `id` values must be unique. Supported: POST (create), PATCH (update), DELETE, and POST with action `publish`/`unpublish`. Up to 50 entries. */
+            operations: ({
+                id: string;
+                /** @enum {string} */
+                method: "POST";
+                body?: unknown;
+                action?: string;
+                resourceId?: string;
+            } | {
+                id: string;
+                /** @enum {string} */
+                method: "PATCH";
+                body?: unknown;
+                resourceId: string;
+            } | {
+                id: string;
+                /** @enum {string} */
+                method: "DELETE";
+                resourceId: string;
+            })[];
+        };
+        BlogTag: {
+            /** @description Unique identifier for the object. Use this value as the `{id}` path parameter for the tag endpoints (e.g. `GET /v1/blog/tags/{id}`). */
+            id: string;
+            /**
+             * @description String representing the object's type. Objects of the same type share the same value.
+             * @enum {string}
+             */
+            object: "blog_tag";
+            /** @description Display name of the tag. */
+            name: string;
+            /** @description URL-friendly slug for the tag. */
+            slug: string;
+            /** @description Tag description, or `null` if not set. */
+            description: string | null;
+            /** @description Tag visibility, or `null` if not set. */
+            visibility: string | null;
+            /** @description SEO meta title, or `null` if not set. */
+            metaTitle: string | null;
+            /** @description SEO meta description, or `null` if not set. */
+            metaDescription: string | null;
+            /** @description Time at which the tag was created. ISO 8601 datetime. */
+            createdAt: string;
+            /** @description Time at which the tag was last updated, or `null` if it has never been updated. ISO 8601 datetime. */
+            updatedAt: string | null;
+        };
+        BoardAccessGrant: {
+            /** @enum {string} */
+            object: "board_access_grant";
+            /** @description The board-access grant. Send it as the `X-Board-Access` header on subsequent content reads to pass the password wall. */
+            token: string;
+        };
+        BoardAuthForgotPasswordBody: {
+            /** Format: email */
+            email: string;
+        };
+        BoardAuthLoginBody: {
+            /** Format: email */
+            email: string;
+            password: string;
+        };
+        BoardAuthLogoutBody: {
+            refreshToken: string;
+        };
+        BoardAuthRefreshBody: {
+            refreshToken: string;
+        };
+        BoardAuthRegisterBody: {
+            /**
+             * @description Which role profile to create on the board.
+             * @enum {string}
+             */
+            role: "candidate" | "employer";
+            /**
+             * @description Registration method. Only `emailpass` is supported.
+             * @enum {string}
+             */
+            method: "emailpass";
+            /** Format: email */
+            email: string;
+            /** @description Minimum 8 characters. */
+            password: string;
+            displayName: string;
+        };
+        BoardAuthResetPasswordBody: {
+            token: string;
+            /** @description Minimum 8 characters. */
+            password: string;
+        };
+        BoardAuthSession: {
+            /** @enum {string} */
+            object: "board_auth_session";
+            /** @description Short-lived JWT (1 hour). Send as `Authorization: Bearer`. */
+            accessToken: string;
+            /** @description Opaque single-use refresh token (30 days). Each refresh returns a replacement; a reused token is rejected. */
+            refreshToken: string;
+            /** @description Access-token expiry, epoch milliseconds. */
+            expiresAt: number;
+            boardUser: components["schemas"]["BoardUser"];
+        };
+        BoardAuthVerifyEmailBody: {
+            token: string;
+        };
+        BoardSeo: {
+            /** @enum {string} */
+            object: "board_seo";
+            /** @description Verbatim `ads.txt` content, or `null` when not configured. */
+            adsTxt: string | null;
+            /** @description IndexNow key-file content, or `null` when not configured. */
+            indexNowKey: string | null;
+            /** @description Google site-verification token for the `<meta>` tag, or `null`. */
+            googleSiteVerification: string | null;
+            /**
+             * Format: uri
+             * @description The board's canonical base URL (honours a configured custom domain). Build `robots.txt`'s `Sitemap:` line (`${canonicalBase}/sitemap.xml`) and canonical links from it.
+             */
+            canonicalBase: string;
+            /** @description Absolute URLs for the board's configured favicons / app icons (null when unset). The variant key implies the role + size; build `<link rel="icon">` tags + the web-manifest icon list from these. */
+            icons: {
+                ico: string | null;
+                svg: string | null;
+                appleTouch: string | null;
+                icon192: string | null;
+                icon512: string | null;
+                iconMaskable512: string | null;
+            };
+            /** @description Web-manifest metadata; assemble `site.webmanifest` from this + `icons`. */
+            manifest: {
+                name: string;
+                themeColor: string;
+            };
+        };
+        BoardUser: {
+            /** @description Board user ID. */
+            id: string;
+            /** @enum {string} */
+            object: "board_user";
+            /** @enum {string} */
+            role: "candidate" | "employer";
+            email: string;
+            displayName: string | null;
+            emailVerified: boolean;
+        };
+        CompaniesBatchRequest: {
+            /** @description Array of sub-operations to execute. Each entry runs independently and reports its result on the corresponding entry of the response `data` array. Sub-operation `id` values must be unique within the batch. Up to 100 entries. */
+            operations: ({
+                id: string;
+                /** @enum {string} */
+                method: "POST";
+                body?: unknown;
+                action?: string;
+                resourceId?: string;
+            } | {
+                id: string;
+                /** @enum {string} */
+                method: "PATCH";
+                body?: unknown;
+                resourceId: string;
+            } | {
+                id: string;
+                /** @enum {string} */
+                method: "DELETE";
+                resourceId: string;
+            })[];
+        };
+        Company: components["schemas"]["CompanySummary"] & {
+            /** @description Long-form description of the company, or `null` if not set. */
+            description: string | null;
+            /** @description Whether automated backfill of jobs from this company is supported, or `null` if not yet evaluated. */
+            canBackfill: boolean | null;
+            /** @description Total number of jobs at this company across all statuses. */
+            jobCount: number;
+            /** @description Number of currently-published jobs at this company. */
+            publishedJobCount: number;
+        };
+        CompanyMarket: {
+            /** @enum {string} */
+            object: "company_market";
+            slug: string;
+            name: string;
+            /** @description Number of companies on the board in this market. */
+            companyCount: number;
+        };
+        CompanyPublic: {
+            /** @description Unique identifier for the object. Use this value as the `{id}` path parameter for the company endpoints (e.g. `GET /v1/companies/{id}`). */
+            id: string;
+            /**
+             * @description String representing the object's type. Objects of the same type share the same value.
+             * @enum {string}
+             */
+            object: "public_company";
+            /** @description Display name of the company. */
+            name: string;
+            /** @description URL-friendly slug for the company. */
+            slug: string;
+            /** @description Public company website URL, or `null` if not set. */
+            website: string | null;
+            /** @description URL of the company logo, or `null` if no logo is set. */
+            logoUrl: string | null;
+            /** @description Long-form description of the company, or `null` if not set. */
+            description: string | null;
+            /** @description Total number of public-facing jobs at this company. Currently mirrors `publishedJobCount`. */
+            jobCount: number;
+            /** @description Number of currently-published, non-expired jobs at this company. */
+            publishedJobCount: number;
+            links: components["schemas"]["PublicCompanyLinks"];
+        };
+        CompanySummary: {
+            /** @description Unique identifier for the object. Use this value as the `{id}` path parameter for the company endpoints (e.g. `GET /v1/companies/{id}`). */
+            id: string;
+            /**
+             * @description String representing the object's type. Objects of the same type share the same value.
+             * @enum {string}
+             */
+            object: "company";
+            /** @description Display name of the company. */
+            name: string;
+            /** @description URL-friendly slug for the company. */
+            slug: string;
+            /** @description Public company website URL, or `null` if not set. */
+            website: string | null;
+            /** @description URL of the company logo, or `null` if no logo is set. */
+            logoUrl: string | null;
+            /** @description One-line summary of the company, or `null` if not set. */
+            summary: string | null;
+            /** @description X (Twitter) profile URL, or `null` if not set. */
+            xUrl: string | null;
+            /** @description LinkedIn page URL, or `null` if not set. */
+            linkedinUrl: string | null;
+            /** @description Facebook page URL, or `null` if not set. */
+            facebookUrl: string | null;
+            /** @description Time at which the company was created. ISO 8601 datetime. */
+            createdAt: string;
+            /** @description Time at which the company was last updated, or `null` if it has never been updated. ISO 8601 datetime. */
+            updatedAt: string | null;
+            /** @description Public + admin URLs for this company. `public` may be `null` if the company lacks a slug. */
+            links: components["schemas"]["ResourceLinks"] & {
+                /**
+                 * Format: uri
+                 * @description Canonical public URL for this company on the board, or `null` when no slug is set.
+                 */
+                public?: string | null;
+            };
+        };
+        CreateAuthorBody: {
+            /** @description URL-friendly slug for the author. Auto-generated from `name` when omitted. */
+            slug?: string;
+            /** @description Short biography for the author. Sanitized HTML. */
+            bio?: string;
+            /**
+             * Format: email
+             * @description The author's email address.
+             */
+            email?: string;
+            /**
+             * @description Author visibility status. One of `active` or `inactive`.
+             * @enum {string}
+             */
+            status?: "active" | "inactive";
+            /** @description Storage ID of an uploaded avatar image (from `POST /v1/media/upload`). Pass `null` to clear an existing avatar. */
+            avatarStorageId?: string | null;
+            /** @description The author's personal website URL. Normalized to a canonical URL when stored. */
+            websiteUrl?: string;
+            /** @description The author's X (Twitter) profile URL. Stored as the canonical `https://x.com/<handle>` URL. */
+            twitterUrl?: string;
+            /** @description The author's LinkedIn profile URL. */
+            linkedinUrl?: string;
+            /** @description The author's GitHub profile URL. */
+            githubUrl?: string;
+            /** @description SEO meta title for the author page. */
+            metaTitle?: string;
+            /** @description SEO meta description for the author page. */
+            metaDescription?: string;
+            /** @description The author's display name. */
+            name: string;
+        };
+        CreateBlogPostBody: {
+            slug?: string;
+            html?: string;
+            customExcerpt?: string;
+            readingTimeMin?: number;
+            featured?: boolean;
+            authorIds?: string[];
+            tagIds?: string[];
+            coverStorageId?: string | null;
+            ogImageStorageId?: string | null;
+            featureImageAlt?: string;
+            featureImageCaption?: string;
+            seoTitle?: string;
+            seoDescription?: string;
+            /** Format: uri */
+            canonicalUrl?: string;
+            /** Format: date-time */
+            publishedAt?: string;
+            title: string;
+            /** @enum {string} */
+            status?: "draft" | "scheduled" | "published";
+        };
+        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 The company's display name. */
+            name: string;
+            /** @description URL-friendly slug for the company. Auto-generated from `name` when omitted. */
+            slug?: string;
+        };
+        CreateJobBody: {
+            /** @description The ID of an existing company. Provide either `companyId` or `company`, not both. */
+            companyId?: string;
+            /** @description Long-form description of the role. Up to 25,000 characters. */
+            description: string;
+            /** @description URL-friendly slug for the job. Auto-generated from `title` when omitted. */
+            slug?: string;
+            /**
+             * @description Employment type of the role.
+             * @enum {string}
+             */
+            employmentType?: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other";
+            /**
+             * @description Whether the role is on-site, hybrid, or fully remote.
+             * @enum {string}
+             */
+            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} */
+                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. */
+            remoteTimezones?: {
+                /** @enum {string} */
+                type: "all" | "world_region" | "continent" | "region" | "subregion" | "country" | "timezone";
+                value: string;
+                plusMinus?: number;
+            }[];
+            /**
+             * @description Whether the employer sponsors visas for remote candidates. One of `yes`, `no`, or `unknown`.
+             * @enum {string}
+             */
+            remoteSponsorship?: "yes" | "no" | "unknown";
+            /**
+             * @description Seniority level of the role.
+             * @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 (which is normalized to `mailto:` form). */
+            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}
+             */
+            salaryTimeframe?: "per_year" | "per_month" | "per_week" | "per_day" | "per_hour";
+            /** @description Whether the job appears in featured slots on the public board. */
+            isFeatured?: boolean;
+            /** @description Job expiry as a Unix epoch in milliseconds. On create, omitted or `null` defaults to 30 days from creation. On PATCH, pass `null` to clear an existing expiry. Past timestamps remove the job from the public board. */
+            expiresAt?: number | unknown | unknown;
+            /** @description Time at which the job was first published, as a Unix epoch in milliseconds. When omitted on create with `status: "published"`, the server stamps the current time. Useful for bulk-importing historical jobs while preserving original publication dates. PATCH may overwrite an existing value but cannot clear it. */
+            publishedAt?: number;
+            /** @description Required education credentials. Each value is one of `high_school`, `associate_degree`, `bachelor_degree`, `professional_certificate`, `postgraduate_degree`, or `no_requirements`. */
+            educationRequirements?: ("high_school" | "associate_degree" | "bachelor_degree" | "professional_certificate" | "postgraduate_degree" | "no_requirements")[];
+            /** @description Minimum required experience, expressed in months. */
+            experienceMonths?: number;
+            /** @description If `true`, equivalent experience may substitute for the listed education requirements. */
+            experienceInPlaceOfEducation?: boolean;
+            /**
+             * @description Period denominator for `inOfficeFrequency`.
+             * @enum {string}
+             */
+            inOfficePeriod?: "per_week" | "per_month" | "per_year";
+            /** @description How often the candidate must be in-office over `inOfficePeriod`. */
+            inOfficeFrequency?: number;
+            /** @description Physical office locations associated with the job. Each entry is forward-geocoded server-side; a country mismatch returns `400 jobs_unresolvable_location`. */
+            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. */
+            customFieldValues?: {
+                [key: string]: string | string[] | boolean | number | unknown | unknown;
+            };
+            /** @description The job title. */
+            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.
+             * @enum {string}
+             */
+            status?: "draft" | "published";
+        };
+        CreateTagBody: {
+            /** @description URL-friendly slug for the tag. Auto-generated from `name` when omitted. */
+            slug?: string;
+            /** @description Description for the tag. Sanitized HTML. */
+            description?: string;
+            /**
+             * @description Tag visibility. One of `public` or `internal`.
+             * @enum {string}
+             */
+            visibility?: "public" | "internal";
+            /** @description SEO meta title for the tag page. */
+            metaTitle?: string;
+            /** @description SEO meta description for the tag page. */
+            metaDescription?: string;
+            /** @description The display name of the tag. */
+            name: string;
+        };
+        CustomFieldDefinition: {
+            /** @description Immutable per-board slug. Use this as the key in `customFieldValues` when writing values via POST/PATCH /v1/jobs. */
+            key: string;
+            /** @description Authoring-default label; the localized public string lives in the board template. */
+            label: string;
+            /**
+             * @description Field type, which dictates the accepted value: `short_text`/`long_text` → string; `single_select` → one option key (string); `multi_select` → array of option keys; `boolean` → boolean; `number` → number.
+             * @enum {string}
+             */
+            type: "short_text" | "long_text" | "single_select" | "multi_select" | "boolean" | "number";
+            /** @description Present only for `single_select`/`multi_select`. A written value must be 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`). */
+            required: boolean;
+            /** @description Inclusive minimum for `number` fields, when set. */
+            min?: number;
+            /** @description Inclusive maximum for `number` fields, when set. */
+            max?: number;
+        };
+        CustomFieldOption: {
+            /** @description Stable option key — send this in a write, not the label. */
+            key: string;
+            /** @description Display label (authoring default; localized per board in the template). */
+            label: string;
+        };
+        DuplicateJobBody: Record<string, never>;
+        DynamicClientRegistrationRequest: {
+            /** @description Array of redirect URIs the client may use. Must be HTTPS, except for `http://localhost` URIs in development. At least one entry is required. */
+            redirect_uris: string[];
+            /** @description Human-readable client name shown to users on the consent screen. Recommended for MCP clients; defaults to "MCP client" when omitted. */
+            client_name?: string;
+            /** @description Space-separated list of scopes the client may request. When omitted, the client is registered for all scopes. */
+            scope?: string;
+            /**
+             * @description OAuth token endpoint authentication method. Use `none` for public PKCE clients that cannot keep a client secret.
+             * @enum {string}
+             */
+            token_endpoint_auth_method?: "client_secret_basic" | "none";
+        };
+        DynamicClientRegistrationResponse: {
+            /** @description Public OAuth client identifier. */
+            client_id: string;
+            /** @description Time at which the client was registered. Unix epoch in seconds. */
+            client_id_issued_at: number;
+            /** @description Plaintext OAuth client secret. Returned exactly once for confidential clients; omitted for public clients. */
+            client_secret?: string;
+            /** @description Time at which the client secret expires. Unix epoch in seconds, or `0` if the secret does not expire. Omitted for public clients. */
+            client_secret_expires_at?: number;
+            /** @description Array of redirect URIs registered for the client. */
+            redirect_uris: string[];
+            /** @description Human-readable client name shown to users on the consent screen. */
+            client_name: string;
+            /** @description OAuth grant types the client is permitted to use. */
+            grant_types: string[];
+            /** @description OAuth response types the client is permitted to use. */
+            response_types: string[];
+            /** @description Authentication method the client uses at the token endpoint. */
+            token_endpoint_auth_method: string;
+            /** @description Space-separated list of scopes the client may request. */
+            scope: string;
+        };
+        FindOrCreateCompanyBody: {
+            /** @description The company's display name. */
+            name: string;
+            /** @description Public company website URL. Used to resolve to an existing company by domain before falling back to creation. */
+            website?: string;
+            /** @description One-line summary of the company. Up to 280 characters. */
+            summary?: string;
+            /** @description If `true` (default), falls back to matching by `name` when no website match is found. Set to `false` to match by website domain only. */
+            matchByName?: boolean;
+            /** @description If `true` (default), creates a new company when no match is found. Set to `false` to receive a `404 companies_not_found` response instead. */
+            createIfMissing?: boolean;
+        };
+        /** @description An inline company payload, resolved via `find-or-create` before the job is created. Provide either `company` or `companyId`, not both. */
+        InlineCompanyInput: {
+            /** @description The company's display name. */
+            name: string;
+            /** @description Public company website URL. Used to resolve to an existing company by domain before falling back to creation. */
+            website?: string;
+            /** @description One-line summary of the company. Up to 280 characters. */
+            summary?: string;
+            /** @description If `true` (default), falls back to matching by `name` when no website match is found. Set to `false` to match by website domain only. */
+            matchByName?: boolean;
+            /** @description If `true` (default), creates a new company when no match is found. Set to `false` to receive a `404 companies_not_found` response instead. */
+            createIfMissing?: boolean;
+        };
+        Job: components["schemas"]["JobSummary"] & {
+            /** @description Public + admin URLs for this job. `public` may be `null` if the job lacks a slug or company-slug. */
+            links?: components["schemas"]["ResourceLinks"] & {
+                /**
+                 * Format: uri
+                 * @description Canonical public URL for this job, or `null` when the job has no slug or no associated company slug (so a stable URL cannot be assembled).
+                 */
+                public?: string | null;
+            };
+            /** @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. */
+            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. */
+            remotePermits: {
+                type: string;
+                value: string;
+            }[];
+            /** @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. */
+            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. */
+            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. */
+            remoteWorkPermitCountryCodes: string[];
+            /** @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`.
+             * @enum {string}
+             */
+            remoteSponsorship: "yes" | "no" | "unknown";
+            /** @description Required education credentials. Each value is one of `high_school`, `associate_degree`, `bachelor_degree`, `professional_certificate`, `postgraduate_degree`, or `no_requirements`. */
+            educationRequirements: ("high_school" | "associate_degree" | "bachelor_degree" | "professional_certificate" | "postgraduate_degree" | "no_requirements")[];
+            /** @description Minimum required experience in months, or `null` if not specified. */
+            experienceMonths: number | null;
+            /** @description If `true`, equivalent experience may substitute for the listed education requirements. `null` if not specified. */
+            experienceInPlaceOfEducation: boolean | null;
+            /**
+             * @description Period denominator for `inOfficeFrequency`, or `null` if not specified.
+             * @enum {string|null}
+             */
+            inOfficePeriod: "per_week" | "per_month" | "per_year" | null;
+            /** @description How often the candidate must be in-office over `inOfficePeriod`, or `null` if not specified. */
+            inOfficeFrequency: number | null;
+            company: components["schemas"]["JobCompany"];
+            /** @description Physical office locations associated with the job. */
+            officeLocations: components["schemas"]["JobOfficeLocation"][];
+        };
+        /** @description Embedded company resource for the job, or `null` if no company is attached. */
+        JobCompany: {
+            /** @description Unique identifier for the company. */
+            id: string;
+            /** @description Display name of the company, or `null` if not yet set. */
+            name: string | null;
+            /** @description URL slug of the company, or `null` if not yet set. */
+            slug: string | null;
+            /** @description URL of the company logo, or `null` if no logo is set. */
+            logoUrl: string | null;
+            /** @description Company website URL, or `null` if no website is set. */
+            website: string | null;
+        } | null;
+        JobFormConfig: {
+            sponsorship?: {
+                visible: boolean;
+            };
+            salary?: {
+                visible: boolean;
+                required?: boolean;
+                minBound?: number;
+                maxBound?: number;
+                allowedCurrencies?: string[];
+            };
+            seniority?: {
+                visible: boolean;
+                required?: boolean;
+                allowedOptions?: string[];
+            };
+            workArrangement?: {
+                allowedOptions: string[];
+            };
+            employmentType?: {
+                allowedOptions: string[];
+            };
+            location?: {
+                visible: boolean;
+                allowedCountries?: string[];
+            };
+            /** @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"][];
+        };
+        JobOfficeLocation: {
+            /** @description ISO 3166-1 alpha-2 country code, or `null` if the location was not resolved. */
+            countryCode: string | null;
+            /** @description Full country name, or `null` if the location was not resolved. */
+            country: string | null;
+            /** @description Neighborhood or sub-locality, or `null` if not resolved. */
+            locality: string | null;
+            /** @description City, or `null` if not resolved. */
+            city: string | null;
+            /** @description Region, state, or province name, or `null` if not resolved. */
+            region: string | null;
+            /** @description Region or state code (e.g. `CA` for California), or `null` if not resolved. */
+            regionCode: string | null;
+            /** @description Postal or ZIP code, or `null` if not resolved. */
+            postalCode: string | null;
+            /** @description Pre-formatted display name for the location, or `null` if not resolved. */
+            displayName: string | null;
+        };
+        JobOfficeLocationInput: {
+            /** @description Neighborhood or sub-locality. */
+            locality?: string;
+            /** @description City. */
+            city: string;
+            /** @description Region, state, or province. */
+            region?: string;
+            /** @description ISO 3166-1 alpha-2 country code OR recognized country name/alias. Aliases are normalized to canonical alpha-2 server-side (e.g. `US`, `USA`, `United States` → `US`; `UK`, `GB`, `United Kingdom` → `GB`). */
+            country: string;
+        } | {
+            /** @description Free-form location string (e.g. `"Berlin, Germany"`, `"Mountain View, California, USA"`). Mapbox parses + ranks candidates server-side; rejects on low confidence. */
+            query: string;
+        };
+        JobSummary: {
+            /** @description Unique identifier for the object. Use this value as the `{id}` path parameter for the job endpoints (e.g. `GET /v1/jobs/{id}`). */
+            id: string;
+            /**
+             * @description String representing the object's type. Objects of the same type share the same value.
+             * @enum {string}
+             */
+            object: "job";
+            /** @description The job title. */
+            title: string;
+            /** @description URL-friendly slug used in public board URLs, or `null` if no slug is set. */
+            slug: string | null;
+            /**
+             * @description Current status of the job. One of `draft`, `published`, `expired`, or `archived`.
+             * @enum {string}
+             */
+            status: "draft" | "published" | "expired" | "archived";
+            /** @description Identifier of the company the job belongs to, or `null` if no company is attached. */
+            companyId: string | null;
+            /**
+             * @description Employment type of the role, or `null` if not specified.
+             * @enum {string|null}
+             */
+            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.
+             * @enum {string|null}
+             */
+            remoteOption: "on_site" | "hybrid" | "remote" | null;
+            /**
+             * @description Seniority level of the role, or `null` if not specified.
+             * @enum {string|null}
+             */
+            seniority: "entry_level" | "associate" | "mid_level" | "senior" | "lead" | "principal" | "director" | "executive" | null;
+            /** @description Minimum salary in `salaryCurrency` units, or `null` if not specified. */
+            salaryMin: number | null;
+            /** @description Maximum salary in `salaryCurrency` units, or `null` if not specified. */
+            salaryMax: number | null;
+            /** @description Three-letter ISO 4217 currency code for the salary range, or `null` if no salary is specified. */
+            salaryCurrency: string | null;
+            /**
+             * @description Period the salary range is quoted against, or `null` if no salary is specified.
+             * @enum {string|null}
+             */
+            salaryTimeframe: "per_year" | "per_month" | "per_week" | "per_day" | "per_hour" | null;
+            /** @description Whether the job appears in featured slots on the public board. */
+            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. */
+            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 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. */
+            customFieldValues: {
+                [key: string]: string | string[] | boolean | number;
+            };
+            links: components["schemas"]["AdminOnlyResourceLinks"];
+        };
+        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. */
+            referencedBy: {
+                /** @description Type of the resource referencing this file. */
+                resourceType: string;
+                /** @description Identifier of the resource referencing this file. */
+                resourceId: string;
+            }[];
+        };
+        MediaUpload: {
+            /** @description Unique identifier for the object. Use this value as the `{id}` path parameter for `GET /v1/media/{id}`. */
+            id: string;
+            /**
+             * @description String representing the object's type. Objects of the same type share the same value.
+             * @enum {string}
+             */
+            object: "media_upload";
+            /** @description Signed URL where the file can be downloaded. Always set on the upload response; may be `null` on retrieval if the underlying blob has been deleted. */
+            url: string | null;
+            /** @description Time at which the signed `url` expires. Approximately 15 minutes after the response is issued. ISO 8601 datetime. */
+            urlExpiresAt: string;
+            /** @description MIME type of the uploaded file. */
+            mimeType: string;
+            /** @description Size of the uploaded file, in bytes. */
+            sizeBytes: number;
+            /**
+             * @description Resource type the file was uploaded for.
+             * @enum {string}
+             */
+            purpose: "board_logo" | "board_hero" | "account_avatar" | "company_logo" | "blog_image";
+        };
+        /** @description Error envelope, populated once the operation reaches `failed`. `null` otherwise. */
+        OperationErrorEnvelope: {
+            /** @description Machine-readable error code. */
+            code: string;
+            /** @description Human-readable error message. */
+            message: string;
+            /** @description Additional structured details about the error, when present. */
+            details?: unknown;
+            /** @description Identifier of the request that produced the error. Use this to correlate with platform logs. */
+            requestId?: string;
+        } | null;
+        /** @description Snapshot of the operation's progress, or `null` if the operation does not report progress. */
+        OperationProgress: {
+            /** @description Progress as a percentage between 0 and 100, when the operation reports a percentage. */
+            percent?: number;
+            /** @description Human-readable progress message, when available. */
+            message?: string;
+            /** @description Number of items processed so far, when applicable. */
+            processed?: number;
+            /** @description Total number of items to process, when known. */
+            total?: number;
+        } | null;
+        OperationResource: {
+            /** @description Unique identifier for the object. */
+            id: string;
+            /**
+             * @description String representing the object's type. Objects of the same type share the same value.
+             * @enum {string}
+             */
+            object: "operation";
+            /** @description Operation kind, identifying which workflow the operation runs. */
+            kind: string;
+            /**
+             * @description Current state of the operation.
+             * @enum {string}
+             */
+            state: "pending" | "running" | "succeeded" | "failed" | "cancelled";
+            /** @description Identifier of the account the operation belongs to. */
+            accountId: string;
+            progress: components["schemas"]["OperationProgress"];
+            /** @description Operation result, populated once the operation reaches `succeeded`. Shape varies by `kind`. */
+            result?: unknown;
+            error: components["schemas"]["OperationErrorEnvelope"];
+            /** @description Time at which the operation was created. ISO 8601 datetime. */
+            createdAt: string;
+            /** @description Time at which the operation was last updated. ISO 8601 datetime. */
+            updatedAt: string;
+            /** @description Time at which the operation reached a terminal state, or `null` if it has not yet completed. ISO 8601 datetime. */
+            completedAt: string | null;
+            /** @description Whether cancellation of the operation has been requested. */
+            cancelRequested: boolean;
+            /** @description Type of resource the operation acts on, or `null` for resource-less operations. */
+            resourceType: string | null;
+            /** @description Identifier of the resource the operation acts on, or `null` for resource-less operations. */
+            resourceId: string | null;
+            /** @description Identifier of the parent operation when this operation is a child of a fan-out, or `null` otherwise. */
+            parentOperationId: string | null;
+        };
+        PatchSettingsBody: {
+            /** @description Display name of the board. */
+            name?: string;
+            /** @description URL slug of the board. Lowercase alphanumeric and hyphens; reserved values (e.g. `admin`, `api`) are rejected. */
+            slug?: string;
+            /** @description Identifier of the custom domain to use as the primary public URL. */
+            primaryDomainId?: string;
+            /** @description Media storage ID returned by `POST /v1/media/upload` with `purpose=board_logo`. */
+            logoStorageId?: string;
+            /** @description Media storage ID returned by `POST /v1/media/upload` with `purpose=board_hero`. */
+            heroStorageId?: string;
+            /** @description Whether the board sits behind a password gate. Use `POST /v1/settings/password-protection` to set the actual password before enabling. */
+            passwordProtectionEnabled?: boolean;
+            /** @description Whether candidates can subscribe to email alerts for new jobs. */
+            jobAlertsEnabled?: boolean;
+            /** @description Whether candidate profiles are enabled on the board. */
+            candidatesEnabled?: boolean;
+            /** @description Whether employer self-serve flows are enabled. */
+            employersEnabled?: boolean;
+            /** @description Whether the public blog is exposed. */
+            blogEnabled?: boolean;
+            /** @description Whether the legal Impressum page is exposed (required in some jurisdictions). */
+            impressumEnabled?: boolean;
+            /** @description Whether jobs posted by employers from the free tier require admin approval before they appear on the public board. */
+            requireApprovalFreeJobs?: boolean;
+            /** @description Whether aggregated jobs (e.g. those scraped or imported from upstream sources) require admin approval before they appear on the public board. */
+            requireApprovalAggregatedJobs?: boolean;
+            /** @description Whether visitors must sign in to view jobs. */
+            registrationWallEnabled?: boolean;
+            /** @description Whether the public talent directory is enabled. */
+            talentDirectoryEnabled?: boolean;
+            /** @description Whether the Cavuno-branded footer is displayed on the public board. Plan-gated; lower-tier plans cannot disable this. */
+            showCavunoBranding?: boolean;
+            /** @description Default expiry, in days, applied to newly published jobs when no `expiresAt` is supplied. */
+            defaultJobDurationDays?: number;
+            /** @description Public contact email shown on the board. Pass `null` to clear. */
+            contactEmail?: string | "" | unknown | unknown;
+            /** @description Legal name of the entity operating the board. Pass `null` to clear. */
+            companyLegalName?: string | "" | unknown | unknown;
+            /** @description Postal address of the entity operating the board. Pass `null` to clear. */
+            companyAddress?: string | "" | unknown | unknown;
+            /** @description Public company website URL. Pass `null` to clear. */
+            companyWebsiteUrl?: string | "" | unknown | unknown;
+            /** @description Company X (Twitter) handle or profile URL. Pass `null` to clear. */
+            companyXHandle?: string | "" | unknown | unknown;
+            /** @description Company Facebook page URL. Pass `null` to clear. */
+            companyFacebookUrl?: string | "" | unknown | unknown;
+            /** @description Company LinkedIn page URL. Pass `null` to clear. */
+            companyLinkedinUrl?: string | "" | unknown | unknown;
+            /** @description Label shown for the talent directory in the public navigation. 1–50 characters. */
+            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. */
+            config?: {
+                [key: string]: unknown;
+            };
+        };
+        PublicBlogAdjacentPosts: {
+            /** @enum {string} */
+            object: "blog_adjacent_posts";
+            previous: components["schemas"]["PublicBlogPostSummary"] & unknown;
+            next: components["schemas"]["PublicBlogPostSummary"] & unknown;
+        };
+        PublicBlogAuthor: components["schemas"]["PublicBlogAuthorEmbed"] & {
+            /** @enum {string} */
+            object: "public_blog_author";
+        };
+        PublicBlogAuthorEmbed: {
+            id: string;
+            name: string;
+            slug: string;
+            bio: string | null;
+            avatarUrl: string | null;
+            websiteUrl: string | null;
+            twitterUrl: string | null;
+            linkedinUrl: string | null;
+            githubUrl: string | null;
+        };
+        PublicBlogPost: components["schemas"]["PublicBlogPostSummary"] & {
+            html: string | null;
+            ogImageUrl: string | null;
+            featureImageCaption: string | null;
+            seoTitle: string | null;
+            seoDescription: string | null;
+            redirected: boolean;
+            newSlug: string | null;
+        };
+        PublicBlogPostSummary: {
+            id: string;
+            /** @enum {string} */
+            object: "public_blog_post";
+            title: string;
+            slug: string;
+            featured: boolean;
+            coverUrl: string | null;
+            featureImageAlt: string | null;
+            customExcerpt: string | null;
+            readingTimeMin: number | null;
+            publishedAt: string | null;
+            canonicalUrl: string | null;
+            createdAt: string;
+            authors: components["schemas"]["PublicBlogAuthorEmbed"][];
+            tags: components["schemas"]["PublicBlogTagEmbed"][];
+        };
+        PublicBlogSearchBody: {
+            /** @description Free-text search query. Up to 200 characters. */
+            query: 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 50. */
+            limit?: number;
+        };
+        PublicBlogTag: components["schemas"]["PublicBlogTagEmbed"] & {
+            /** @enum {string} */
+            object: "public_blog_tag";
+        };
+        PublicBlogTagEmbed: {
+            id: string;
+            name: string;
+            slug: string;
+            description: string | null;
+        };
+        PublicBoardContext: {
+            /** @enum {string} */
+            object: "public_board";
+            /** @description Immutable board identifier (`boards_…`). */
+            id: string;
+            /** @description Mutable canonical board slug. */
+            slug: string;
+            name: string;
+            /** @description Board language (ISO code); defaults to "en". */
+            language: string;
+            logoUrl: string | null;
+            /** @description Active custom-domain hostname, or null. */
+            primaryDomain: string | null;
+            /** @description Whitelabel toggle (default `true`). Render the "Powered by Cavuno" badge unless `false`. */
+            showCavunoBranding: boolean;
+            features: {
+                jobAlerts: boolean;
+                candidates: boolean;
+                employers: boolean;
+                blog: boolean;
+                talentDirectory: boolean;
+                registrationWall: boolean;
+                passwordProtected: boolean;
+                publicJobSubmission: boolean;
+                candidatePaywall: boolean;
+                impressum: boolean;
+            };
+            analytics: {
+                ga4MeasurementId: string | null;
+                gtmId: string | null;
+                metaPixelId: string | null;
+                linkedInPartnerId: string | null;
+                cookieConsentRequired: boolean;
+            };
+            theme: {
+                mode: string;
+                schemeId: string;
+                typography: {
+                    fontSans: string;
+                    fontHeading?: string | null;
+                };
+                colors: {
+                    light: {
+                        [key: string]: unknown;
+                    };
+                    dark: {
+                        [key: string]: unknown;
+                    };
+                };
+            } | null;
+        };
+        PublicCompaniesSearchBody: {
+            /** @description Free-text search query matched against company name. Up to 200 characters. */
+            query?: 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. */
+            limit?: number;
+        };
+        /** @description Public-only links. The admin URL is intentionally omitted on public-board responses. */
+        PublicCompanyLinks: {
+            /**
+             * Format: uri
+             * @description Canonical public URL for this company on the board, or `null` when no slug is set.
+             */
+            public: string | null;
+        };
+        PublicJob: {
+            /** @description Unique identifier for the object. Use this value as the `{id}` path parameter for the job endpoints (e.g. `GET /v1/jobs/{id}`). */
+            id: string;
+            /**
+             * @description String representing the object's type. Objects of the same type share the same value.
+             * @enum {string}
+             */
+            object: "public_job";
+            /** @description The job title. */
+            title: string;
+            /** @description URL-friendly slug used in public board URLs, or `null` if no slug is set. */
+            slug: string | null;
+            /**
+             * @description Current status of the job. One of `draft`, `published`, `expired`, or `archived`.
+             * @enum {string}
+             */
+            status: "draft" | "published" | "expired" | "archived";
+            /** @description Identifier of the company the job belongs to, or `null` if no company is attached. */
+            companyId: string | null;
+            /**
+             * @description Employment type of the role, or `null` if not specified.
+             * @enum {string|null}
+             */
+            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.
+             * @enum {string|null}
+             */
+            remoteOption: "on_site" | "hybrid" | "remote" | null;
+            /**
+             * @description Seniority level of the role, or `null` if not specified.
+             * @enum {string|null}
+             */
+            seniority: "entry_level" | "associate" | "mid_level" | "senior" | "lead" | "principal" | "director" | "executive" | null;
+            /** @description Minimum salary in `salaryCurrency` units, or `null` if not specified. */
+            salaryMin: number | null;
+            /** @description Maximum salary in `salaryCurrency` units, or `null` if not specified. */
+            salaryMax: number | null;
+            /** @description Three-letter ISO 4217 currency code for the salary range, or `null` if no salary is specified. */
+            salaryCurrency: string | null;
+            /**
+             * @description Period the salary range is quoted against, or `null` if no salary is specified.
+             * @enum {string|null}
+             */
+            salaryTimeframe: "per_year" | "per_month" | "per_week" | "per_day" | "per_hour" | null;
+            /** @description Whether the job appears in featured slots on the public board. */
+            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. */
+            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;
+            links: components["schemas"]["PublicJobLinks"];
+            /** @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. */
+            applicationUrl: string | null;
+            /** @description Hierarchical permit selection authored by the board owner. The three `remoteWorkPermit*` and `remoteWorldwide` fields are read-only derived projections. */
+            remotePermits: {
+                type: string;
+                value: string;
+            }[];
+            /** @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: {
+                type: string;
+                value: string;
+                plusMinus?: number;
+            }[];
+            /** @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. */
+            remoteWorkPermitCountryCodes: string[];
+            /** @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`.
+             * @enum {string}
+             */
+            remoteSponsorship: "yes" | "no" | "unknown";
+            /** @description Required education credentials. Each value is one of `high_school`, `associate_degree`, `bachelor_degree`, `professional_certificate`, `postgraduate_degree`, or `no_requirements`. */
+            educationRequirements: ("high_school" | "associate_degree" | "bachelor_degree" | "professional_certificate" | "postgraduate_degree" | "no_requirements")[];
+            /** @description Minimum required experience in months, or `null` if not specified. */
+            experienceMonths: number | null;
+            /** @description If `true`, equivalent experience may substitute for the listed education requirements. `null` if not specified. */
+            experienceInPlaceOfEducation: boolean | null;
+            /**
+             * @description Period denominator for `inOfficeFrequency`, or `null` if not specified.
+             * @enum {string|null}
+             */
+            inOfficePeriod: "per_week" | "per_month" | "per_year" | null;
+            /** @description How often the candidate must be in-office over `inOfficePeriod`, or `null` if not specified. */
+            inOfficeFrequency: number | null;
+            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. */
+            categories: {
+                slug: string;
+                name: string;
+            }[];
+            /** @description Resolved job skills (slug + board display name). */
+            skills: {
+                slug: string;
+                name: string;
+            }[];
+            /** @description Place ancestor chain (country → region → city) for the breadcrumb; each `{slug,name}` links to `/jobs/locations/:slug`. Source-language. */
+            placeHierarchy: {
+                slug: string;
+                name: string;
+            }[];
+        };
+        PublicJobAlertConfirmation: {
+            /** @enum {string} */
+            object: "job_alert_confirmation";
+            /**
+             * @description Outcome of the confirmation. Always returned with HTTP 200 so the consumer renders by status (the token may be valid, stale, or unknown).
+             * @enum {string}
+             */
+            status: "confirmed" | "already_confirmed" | "expired" | "not_found";
+        };
+        PublicJobAlertManageResult: {
+            /** @enum {string} */
+            object: "job_alert_manage_result";
+            success: boolean;
+        };
+        PublicJobAlertManageState: {
+            /** @enum {string} */
+            object: "job_alert_manage_state";
+            email: string;
+            confirmed: boolean;
+            unsubscribed: boolean;
+            preferences: {
+                id: string;
+                label: string | null;
+                frequency: string;
+                isActive: boolean;
+                filters: {
+                    [key: string]: unknown;
+                };
+                manageToken: string;
+            }[];
+        };
+        PublicJobAlertResend: {
+            /** @enum {string} */
+            object: "job_alert_confirmation_resend";
+            /** @enum {string} */
+            status: "sent" | "not_found" | "already_confirmed" | "throttled" | "send_failed";
+        };
+        PublicJobAlertSubscription: {
+            /** @enum {string} */
+            object: "job_alert_subscription";
+            /**
+             * @description `created` on a new subscription; `duplicate` if it existed.
+             * @enum {string}
+             */
+            status: "created" | "duplicate";
+            /** @description True when a double-opt-in confirmation email was sent. */
+            requiresConfirmation: boolean;
+            /** @description True if the subscriber was already email-confirmed. */
+            confirmed: boolean;
+        };
+        PublicJobCard: {
+            id: string;
+            /** @enum {string} */
+            object: "job_card";
+            slug: string;
+            title: string;
+            /**
+             * Format: date-time
+             * @description ISO 8601 publish timestamp, or `null` if unpublished.
+             */
+            publishedAt: string | null;
+            /** @enum {string|null} */
+            employmentType: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other" | null;
+            /** @enum {string|null} */
+            remoteOption: "on_site" | "hybrid" | "remote" | null;
+            /** @description Display region label for remote jobs (e.g. "United States", "Worldwide"); `null` for non-remote jobs. */
+            remoteLocationLabel: string | null;
+            salaryMin: number | null;
+            salaryMax: number | null;
+            salaryCurrency: string | null;
+            salaryTimeframe: string | null;
+            isFeatured: boolean;
+            locationLabel: string | null;
+            /** @description Embedded company summary, or `null` if none is attached. */
+            company: {
+                slug: string;
+                name: string;
+                logoUrl: string | null;
+            } | null;
+            categories: {
+                slug: string;
+                name: string;
+            }[];
+            skills: {
+                slug: string;
+                name: string;
+            }[];
+            links: {
+                /**
+                 * Format: uri
+                 * @description Canonical public URL for this job, or `null` when no stable URL can be assembled.
+                 */
+                public: string | null;
+            };
+            /** @description Long-form description (HTML), or `null`. Present ONLY when requested via `?fields=+description`; absent on the default slim card. */
+            description?: string | null;
+        };
+        /** @description Public-only links. The admin URL is intentionally omitted on public-board responses. */
+        PublicJobLinks: {
+            /**
+             * Format: uri
+             * @description Canonical public URL for this job, or `null` when the job has no slug or no associated company slug (so a stable URL cannot be assembled).
+             */
+            public: string | null;
+        };
+        PublicPlace: {
+            /** @enum {string} */
+            object: "place";
+            /** @description Stable place identity (locations-tree edge endpoint). */
+            id: string;
+            /** @description Parent place's `id`; `null` for a root place. */
+            parentId: string | null;
+            /** @description Public slug (links to `/jobs/locations/:slug`); `null` if unslugged. */
+            slug: string | null;
+            name: string;
+            placeType: string;
+            countryCode: string | null;
+            regionCode: string | null;
+            /** @description Live published-job count for this place. */
+            jobCount: number;
+        };
+        PublicSearchJobsBody: {
+            /** @description Free-text search query matched against job title and description. Up to 200 characters. */
+            query?: string;
+            /** @description Optional faceted filters to narrow search results. Multi-value filters match jobs in any of the supplied values; range filters accept `gte` and `lte` bounds. */
+            filters?: {
+                /** @description Only return jobs at any of the given company IDs. Up to 10 values. */
+                companyId?: string[];
+                /** @description Only return jobs with any of the given remote-work options. Up to 10 values. */
+                remoteOption?: ("on_site" | "hybrid" | "remote")[];
+                /** @description Only return jobs with any of the given employment types. Up to 10 values. */
+                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 Range filter on the job's `publishedAt` timestamp. */
+                publishedAt?: {
+                    /**
+                     * Format: date-time
+                     * @description Only return jobs published at or after this ISO 8601 datetime.
+                     */
+                    gte?: string;
+                    /**
+                     * Format: date-time
+                     * @description Only return jobs published at or before this ISO 8601 datetime.
+                     */
+                    lte?: string;
+                };
+                /** @description Only return jobs near the place with this slug (geo radius search). Unresolvable slugs are ignored. */
+                location?: string;
+                /** @description Search radius in kilometres around `location` (10–250; default 50). Ignored without `location`. */
+                radius?: number;
+            };
+            /** @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;
+            /**
+             * @description A limit on the number of objects to be returned. Limit can range between 1 and 100.
+             * @example 20
+             */
+            limit?: number;
+            /**
+             * @description The number of jobs to skip — the storefront page offset. Takes precedence over `cursor`. `offset + limit` may not exceed 10,000.
+             * @example 0
+             */
+            offset?: number;
+        };
+        PublicTaxonomyResolution: {
+            /** @enum {string} */
+            object: "taxonomy_resolution";
+            /** @enum {string} */
+            type: "category" | "skill" | "place";
+            /** @description Immutable English source slug — the semantic-search key. */
+            sourceSlug: string;
+            /** @description Board-language URL slug (the `<link rel=canonical>` target). */
+            canonicalSlug: string;
+            /** @description Board-language display name. */
+            displayName: string;
+            /** @description The canonical slug to emit a 308 redirect to when the inbound slug differs; `null` otherwise. */
+            redirectTo: string | null;
+            geo: components["schemas"]["TaxonomyGeo"];
+        };
+        PublicVerifyBoardPasswordBody: {
+            /** @description The board password. */
+            password: string;
+        };
+        PublishJobBody: {
+            /**
+             * Format: date-time
+             * @description New expiry as an ISO 8601 datetime. Pass `null` to clear the expiry. When omitted, the server preserves the existing expiry **if it is still in the future**; a stored expiry in the past (e.g. left over from a prior `expire` call) is cleared automatically so a republished job does not land in an immediately-invisible state.
+             */
+            expiresAt?: string | null;
+        };
+        RedirectResolution: {
+            /** @enum {string} */
+            object: "redirect_resolution";
+            path: string;
+            /** @description The redirect target (board-relative), or `null` when no redirect matches. The consumer 308s to `target`, or 404s when `null`. */
+            target: string | null;
+        };
+        RemotePermitTaxonomyEntry: {
+            /** @description Discriminator. One of: `worldwide`, `world_region`, `continent`, `region`, `subregion`, `custom`, `country`, `subdivision`. */
+            type: string;
+            /** @description Canonical value for the type. ISO 3166-1 alpha-2 for `country`, ISO 3166-2 for `subdivision`, etc. */
+            value: string;
+            /** @description Human-readable display label. */
+            label: string;
+        };
+        RemoteTimezoneTaxonomyEntry: {
+            /** @description Discriminator. One of: `all`, `world_region`, `continent`, `region`, `subregion`, `country`, `timezone`. */
+            type: string;
+            /** @description Canonical value for the type. ISO 3166-1 alpha-2 for `country`, IANA name (e.g. `Europe/London`) for `timezone`, etc. */
+            value: string;
+            /** @description Human-readable display label. */
+            label: string;
+        };
+        ResourceLinks: {
+            /**
+             * Format: uri
+             * @description Canonical public URL for this resource on the board. Honours the configured custom domain when present, otherwise uses the board subdomain.
+             */
+            public: string;
+            /**
+             * Format: uri
+             * @description URL inside the Cavuno app where the authenticated owner can manage this resource.
+             */
+            admin: string;
+        };
+        RevokeRequest: {
+            /** @description The access or refresh token to revoke. */
+            token: string;
+            /**
+             * @description Hint indicating whether `token` is an `access_token` or `refresh_token`. Optional.
+             * @enum {string}
+             */
+            token_type_hint?: "access_token" | "refresh_token";
+            /** @description OAuth client identifier. May be supplied here or via HTTP Basic authentication. */
+            client_id?: string;
+            /** @description OAuth client secret. May be supplied here or via HTTP Basic authentication. */
+            client_secret?: string;
+        };
+        SaveJobBody: {
+            jobId: string;
+        };
+        SavedJob: {
+            /** @description Saved-job row ID. */
+            id: string;
+            /** @enum {string} */
+            object: "saved_job";
+            /** @description The saved job — also the DELETE path key. */
+            jobId: string;
+            /** Format: date-time */
+            savedAt: string;
+            job: components["schemas"]["PublicJob"];
+        };
+        SearchBlogPostsBody: {
+            query?: string;
+            /** @enum {string} */
+            status?: "draft" | "scheduled" | "published";
+            cursor?: string | null;
+            limit?: number;
+        };
+        SearchCompaniesBody: {
+            /** @description Free-text search query matched against company name. Up to 200 characters. */
+            query?: 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.
+             * @example 20
+             */
+            limit?: number;
+        };
+        SearchJobsBody: {
+            /** @description Free-text search query matched against job title and description. Up to 200 characters. */
+            query?: string;
+            /** @description Optional faceted filters to narrow search results. Multi-value filters match jobs in any of the supplied values; range filters accept `gte` and `lte` bounds. */
+            filters?: {
+                /** @description Only return jobs in any of the given statuses. Up to 10 values. */
+                status?: ("draft" | "published" | "expired" | "archived")[];
+                /** @description Only return jobs at any of the given company IDs. Up to 10 values. */
+                companyId?: string[];
+                /** @description Only return jobs with any of the given remote-work options. Up to 10 values. */
+                remoteOption?: ("on_site" | "hybrid" | "remote")[];
+                /** @description Only return jobs with any of the given employment types. Up to 10 values. */
+                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 Range filter on the job's `publishedAt` timestamp. */
+                publishedAt?: {
+                    /**
+                     * Format: date-time
+                     * @description Only return jobs published at or after this ISO 8601 datetime.
+                     */
+                    gte?: string;
+                    /**
+                     * Format: date-time
+                     * @description Only return jobs published at or before this ISO 8601 datetime.
+                     */
+                    lte?: 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;
+            /**
+             * @description A limit on the number of objects to be returned. Limit can range between 1 and 100.
+             * @example 20
+             */
+            limit?: number;
+        };
+        SettingsAdsenseBody: {
+            /** @description Whether AdSense placements are rendered on the public board. */
+            adsenseEnabled?: boolean;
+            /** @description AdSense publisher ID in `ca-pub-XXXXXXXXXXXXXXXX` format. Pass an empty string or `null` to clear. */
+            adsenseClientId?: string | "" | unknown | unknown;
+            /** @description Map of placement key to slot configuration. Placement keys are lowercase alphanumeric with `-`, `_`, `.`, or `:`. */
+            adsenseSlots?: {
+                [key: string]: components["schemas"]["SettingsAdsenseSlot"];
+            };
+            /** @description Contents to serve from `/ads.txt`. Up to 2,000 characters. Pass an empty string or `null` to clear. */
+            adsTxt?: string | "" | unknown | unknown;
+        };
+        SettingsAdsenseSlot: {
+            /** @description Whether this placement is rendered. */
+            enabled: boolean;
+            /** @description Ten-digit AdSense slot ID. Pass an empty string or `null` to clear. */
+            slotId: string | "" | unknown | unknown;
+            /** @description AdSense layout type for the placement. */
+            layout?: ("auto" | "in-article" | "in-feed" | "fluid") | "" | unknown | unknown;
+            /** @description AdSense ad format. */
+            format?: ("auto" | "horizontal" | "vertical" | "rectangle" | "responsive") | "" | unknown | unknown;
+            /** @description Visual style override for the placement. */
+            style?: ("default" | "light" | "dark" | "contrast") | "" | unknown | unknown;
+            /** @description How often the placement is shown (e.g. once every N items). */
+            frequency?: number | unknown | unknown;
+        };
+        SettingsPasswordProtectionBody: {
+            /** @description Plaintext password used to gate the public board. Must be at least 8 characters. Stored hashed and encrypted server-side. */
+            password: string;
+        };
+        SettingsPaywallBody: {
+            /** @description Whether the job-access paywall is enforced on the public board. */
+            jobAccessPaywallEnabled: boolean;
+            /** @description Number of jobs visible before the paywall locks the rest. Range 1–500. */
+            jobAccessPreviewCount?: number;
+            /** @description Heading shown on the paywall. Up to 120 characters. */
+            jobAccessLockHeading?: string;
+            /** @description Body copy shown on the paywall. Up to 600 characters. */
+            jobAccessLockDescription?: string;
+            /** @description Call-to-action label shown on the paywall. Up to 60 characters. */
+            jobAccessButtonText?: string;
+            /** @description Fine-print disclaimer shown beneath the call-to-action. Up to 200 characters. */
+            jobAccessDisclaimerText?: string;
+            /** @description Label appended to the monthly price (e.g. `/month`). Up to 60 characters. */
+            jobAccessPerMonthLabel?: string;
+            /** @description Template string used to render the savings line for annual plans. Up to 120 characters. */
+            jobAccessSavingsTemplate?: string;
+            /** @description Three-letter ISO 4217 currency code for paywall pricing. */
+            jobAccessCurrency?: string;
+            /** @description Stripe product ID associated with the paywall plan. Pass `null` to clear. */
+            jobAccessStripeProductId?: string | unknown | unknown;
+            /** @description Stripe billing-portal configuration ID used for self-serve plan management. Pass `null` to clear. */
+            jobAccessStripePortalConfigId?: string | unknown | unknown;
+        };
+        /** @description Geo for place resolutions; `null` for category/skill. */
+        TaxonomyGeo: {
+            lat: number | null;
+            lng: number | null;
+            countryCode: string | null;
+            regionCode: string | null;
+            region: string | null;
+            city: string | null;
+            locality: string | null;
+            placeType: string | null;
+        } | null;
+        TokenRequest: {
+            /**
+             * @description OAuth grant type. Either `authorization_code` to exchange an authorization code for a new token pair, or `refresh_token` to exchange a refresh token for a new token pair.
+             * @enum {string}
+             */
+            grant_type: "authorization_code" | "refresh_token";
+            /** @description Authorization code returned from the authorization endpoint. Required when `grant_type` is `authorization_code`. */
+            code?: string;
+            /** @description Redirect URI used in the original authorization request. Must match exactly. Required when `grant_type` is `authorization_code`. */
+            redirect_uri?: string;
+            /** @description PKCE code verifier whose `S256` hash matches the original `code_challenge`. Required when `grant_type` is `authorization_code`. */
+            code_verifier?: string;
+            /** @description Refresh token previously issued. Required when `grant_type` is `refresh_token`. Refresh tokens are single-use; reusing one revokes the entire token chain. */
+            refresh_token?: string;
+            /** @description OAuth client identifier. May be supplied here or via HTTP Basic authentication. */
+            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. */
+            scope?: string;
+        };
+        TokenResponse: {
+            /** @description Newly issued access token. Use as a `Bearer` token in the `Authorization` header. */
+            access_token: string;
+            /**
+             * @description Always `Bearer`.
+             * @enum {string}
+             */
+            token_type: "Bearer";
+            /** @description Lifetime of the access token, in seconds. */
+            expires_in: number;
+            /** @description Newly issued refresh token. Single-use; reusing it revokes the entire token chain. */
+            refresh_token: string;
+            /** @description Space-separated list of scopes granted on the issued token. */
+            scope: string;
+        };
+        UpdateAuthorBody: {
+            /** @description URL-friendly slug for the author. Auto-generated from `name` when omitted. */
+            slug?: string;
+            /** @description Short biography for the author. Sanitized HTML. */
+            bio?: string;
+            /**
+             * Format: email
+             * @description The author's email address.
+             */
+            email?: string;
+            /**
+             * @description Author visibility status. One of `active` or `inactive`.
+             * @enum {string}
+             */
+            status?: "active" | "inactive";
+            /** @description Storage ID of an uploaded avatar image (from `POST /v1/media/upload`). Pass `null` to clear an existing avatar. */
+            avatarStorageId?: string | null;
+            /** @description The author's personal website URL. Normalized to a canonical URL when stored. */
+            websiteUrl?: string;
+            /** @description The author's X (Twitter) profile URL. Stored as the canonical `https://x.com/<handle>` URL. */
+            twitterUrl?: string;
+            /** @description The author's LinkedIn profile URL. */
+            linkedinUrl?: string;
+            /** @description The author's GitHub profile URL. */
+            githubUrl?: string;
+            /** @description SEO meta title for the author page. */
+            metaTitle?: string;
+            /** @description SEO meta description for the author page. */
+            metaDescription?: string;
+            /** @description The author's display name. */
+            name?: string;
+        };
+        UpdateBlogPostBody: {
+            slug?: string;
+            html?: string;
+            customExcerpt?: string;
+            readingTimeMin?: number;
+            featured?: boolean;
+            authorIds?: string[];
+            tagIds?: string[];
+            coverStorageId?: string | null;
+            ogImageStorageId?: string | null;
+            featureImageAlt?: string;
+            featureImageCaption?: string;
+            seoTitle?: string;
+            seoDescription?: string;
+            /** Format: uri */
+            canonicalUrl?: string;
+            /** Format: date-time */
+            publishedAt?: string;
+            title?: string;
+            /** @enum {string} */
+            status?: "draft" | "scheduled" | "published";
+        };
+        UpdateCompanyBody: {
+            /** @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 The company's display name. */
+            name?: string;
+            /** @description URL-friendly slug for the company. */
+            slug?: string;
+        };
+        UpdateJobBody: {
+            /** @description Identifier of the company the job belongs to. */
+            companyId?: string;
+            /** @description Long-form description of the role. Up to 25,000 characters. */
+            description?: string;
+            /** @description URL-friendly slug for the job. Auto-generated from `title` when omitted. */
+            slug?: string;
+            /**
+             * @description Employment type of the role.
+             * @enum {string}
+             */
+            employmentType?: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other";
+            /**
+             * @description Whether the role is on-site, hybrid, or fully remote.
+             * @enum {string}
+             */
+            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} */
+                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. */
+            remoteTimezones?: {
+                /** @enum {string} */
+                type: "all" | "world_region" | "continent" | "region" | "subregion" | "country" | "timezone";
+                value: string;
+                plusMinus?: number;
+            }[];
+            /**
+             * @description Whether the employer sponsors visas for remote candidates. One of `yes`, `no`, or `unknown`.
+             * @enum {string}
+             */
+            remoteSponsorship?: "yes" | "no" | "unknown";
+            /**
+             * @description Seniority level of the role.
+             * @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 (which is normalized to `mailto:` form). */
+            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}
+             */
+            salaryTimeframe?: "per_year" | "per_month" | "per_week" | "per_day" | "per_hour";
+            /** @description Whether the job appears in featured slots on the public board. */
+            isFeatured?: boolean;
+            /** @description Job expiry as a Unix epoch in milliseconds. On create, omitted or `null` defaults to 30 days from creation. On PATCH, pass `null` to clear an existing expiry. Past timestamps remove the job from the public board. */
+            expiresAt?: number | unknown | unknown;
+            /** @description Time at which the job was first published, as a Unix epoch in milliseconds. When omitted on create with `status: "published"`, the server stamps the current time. Useful for bulk-importing historical jobs while preserving original publication dates. PATCH may overwrite an existing value but cannot clear it. */
+            publishedAt?: number;
+            /** @description Required education credentials. Each value is one of `high_school`, `associate_degree`, `bachelor_degree`, `professional_certificate`, `postgraduate_degree`, or `no_requirements`. */
+            educationRequirements?: ("high_school" | "associate_degree" | "bachelor_degree" | "professional_certificate" | "postgraduate_degree" | "no_requirements")[];
+            /** @description Minimum required experience, expressed in months. */
+            experienceMonths?: number;
+            /** @description If `true`, equivalent experience may substitute for the listed education requirements. */
+            experienceInPlaceOfEducation?: boolean;
+            /**
+             * @description Period denominator for `inOfficeFrequency`.
+             * @enum {string}
+             */
+            inOfficePeriod?: "per_week" | "per_month" | "per_year";
+            /** @description How often the candidate must be in-office over `inOfficePeriod`. */
+            inOfficeFrequency?: number;
+            /** @description Physical office locations associated with the job. Each entry is forward-geocoded server-side; a country mismatch returns `400 jobs_unresolvable_location`. */
+            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. */
+            customFieldValues?: {
+                [key: string]: string | string[] | boolean | number | unknown | unknown;
+            };
+            /** @description The job title. */
+            title?: string;
+        };
+        UpdateTagBody: {
+            /** @description URL-friendly slug for the tag. Auto-generated from `name` when omitted. */
+            slug?: string;
+            /** @description Description for the tag. Sanitized HTML. */
+            description?: string;
+            /**
+             * @description Tag visibility. One of `public` or `internal`.
+             * @enum {string}
+             */
+            visibility?: "public" | "internal";
+            /** @description SEO meta title for the tag page. */
+            metaTitle?: string;
+            /** @description SEO meta description for the tag page. */
+            metaDescription?: string;
+            /** @description The display name of the tag. */
+            name?: string;
+        };
+        Usage: {
+            /** @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.
+             * @enum {string}
+             */
+            object: "usage";
+            /** @description Number of jobs currently in `published` status. */
+            activeJobs: number;
+            /** @description Plan-enforced cap on the number of published jobs. */
+            activeJobsLimit: number;
+            /** @description Number of additional jobs the account may publish before hitting the limit. */
+            available: number;
+            /** @description Slug of the account's current plan. */
+            plan: string;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+
+type Schemas = components['schemas'];
+
 /**
  * Stripe-shaped success envelopes (`01-conventions.md` §5.1). The
  * server MAY add top-level fields; consumers MUST ignore unknown
@@ -34,146 +1901,16 @@ interface SearchEnvelope<T> extends StorefrontPagination {
     data: T[];
 }
 
-type RemoteOption = 'on_site' | 'hybrid' | 'remote';
-type EmploymentType = 'full_time' | 'part_time' | 'contract' | 'internship' | 'temporary' | 'volunteer' | 'other';
-type Seniority = 'entry_level' | 'associate' | 'mid_level' | 'senior' | 'lead' | 'principal' | 'director' | 'executive';
-type EducationRequirement = 'high_school' | 'associate_degree' | 'bachelor_degree' | 'professional_certificate' | 'postgraduate_degree' | 'no_requirements';
-interface OfficeLocation {
-    countryCode: string | null;
-    country: string | null;
-    locality: string | null;
-    city: string | null;
-    region: string | null;
-    regionCode: string | null;
-    postalCode: string | null;
-    displayName: string | null;
-}
-interface JobCompany {
-    id: string;
-    name: string | null;
-    slug: string | null;
-    logoUrl: string | null;
-    website: string | null;
-}
-interface RemotePermit {
-    type: string;
-    value: string;
-}
-interface RemoteTimezone {
-    type: string;
-    value: string;
-    plusMinus?: number;
-}
-interface PublicJob {
-    id: string;
-    object: 'public_job';
-    title: string;
-    slug: string | null;
-    status: string;
-    companyId: string | null;
-    employmentType: string | null;
-    remoteOption: string | null;
-    seniority: string | null;
-    salaryMin: number | null;
-    salaryMax: number | null;
-    salaryCurrency: string | null;
-    salaryTimeframe: string | null;
-    isFeatured: boolean;
-    publishedAt: string | null;
-    expiresAt: string | null;
-    createdAt: string;
-    updatedAt: string;
-    description: string | null;
-    applicationUrl: string | null;
-    /** Canonical hierarchical permit selection. */
-    remotePermits: RemotePermit[];
-    /** Read-only — derived from `remotePermits`. */
-    remoteWorldwide: boolean | null;
-    /** Canonical hierarchical timezone selection. */
-    remoteTimezones: RemoteTimezone[];
-    /** Read-only — derived from `remoteTimezones`. */
-    remoteAllowedTzOffsets: number[];
-    /** Read-only — derived from `remotePermits`. */
-    remoteWorkPermitCountryCodes: string[];
-    /** Read-only — derived from `remotePermits`. */
-    remoteWorkPermitSubdivisionCodes: string[];
-    remoteSponsorship: 'yes' | 'no' | 'unknown';
-    educationRequirements: EducationRequirement[];
-    experienceMonths: number | null;
-    experienceInPlaceOfEducation: boolean | null;
-    inOfficePeriod: 'per_week' | 'per_month' | 'per_year' | null;
-    inOfficeFrequency: number | null;
-    company: JobCompany | null;
-    officeLocations: OfficeLocation[];
-    /** Resolved taxonomy — same `{slug,name}` shape as `PublicJobCard`; names joined server-side. */
-    categories: Array<{
-        slug: string;
-        name: string;
-    }>;
-    skills: Array<{
-        slug: string;
-        name: string;
-    }>;
-    /**
-     * Place ancestor chain (country → region → city) for the breadcrumb. Each
-     * `slug` is the English SOURCE slug — the key `taxonomy.places.resolve()`
-     * accepts. On a localized board it may differ from the canonical
-     * board-language URL slug (the board router 308-redirects the source slug to
-     * the canonical one); link via `/jobs/locations/:slug`.
-     */
-    placeHierarchy: Array<{
-        slug: string;
-        name: string;
-    }>;
-    links: {
-        public: string | null;
-    };
-}
-/**
- * The slim listing card (ADR-0037 §1) returned by `jobs.list` / `jobs.search`
- * / `companies.listJobs`. Full enrichment (description, officeLocations, the
- * structured remote blocks, …) lives on `jobs.retrieve` (`PublicJob`).
- * Transcribed from `serializeJobCard`.
- */
-interface PublicJobCard {
-    id: string;
-    object: 'job_card';
-    slug: string;
-    title: string;
-    publishedAt: string | null;
-    employmentType: string | null;
-    remoteOption: string | null;
-    /** Remote-region label for remote jobs (e.g. "Worldwide"); `null` otherwise. */
-    remoteLocationLabel: string | null;
-    salaryMin: number | null;
-    salaryMax: number | null;
-    salaryCurrency: string | null;
-    salaryTimeframe: string | null;
-    isFeatured: boolean;
-    locationLabel: string | null;
-    company: {
-        slug: string;
-        name: string;
-        logoUrl: string | null;
-    } | null;
-    categories: Array<{
-        slug: string;
-        name: string;
-    }>;
-    skills: Array<{
-        slug: string;
-        name: string;
-    }>;
-    links: {
-        public: string | null;
-    };
-    /**
-     * Long-form description (HTML), or `null`. Present ONLY when the list/search
-     * was called with `fields: '+description'` (the RSS feed's sparse-fieldset
-     * opt-in); `undefined`/absent on the default slim card.
-     */
-    description?: string | null;
-}
+type PublicJob = Schemas['PublicJob'];
+type PublicJobCard = Schemas['PublicJobCard'];
+type JobCompany = Schemas['JobCompany'];
+type OfficeLocation = Schemas['JobOfficeLocation'];
+type RemoteOption = NonNullable<PublicJob['remoteOption']>;
+type EmploymentType = NonNullable<PublicJob['employmentType']>;
+type Seniority = NonNullable<PublicJob['seniority']>;
+type EducationRequirement = PublicJob['educationRequirements'][number];
+type RemotePermit = PublicJob['remotePermits'][number];
+type RemoteTimezone = PublicJob['remoteTimezones'][number];
 /** Derived category/skill suggestion on the jobs browse list (ADR-0037 §8). */
 interface RelatedSearch {
     type: 'category' | 'skill';
@@ -193,11 +1930,11 @@ type JobsListQuery = {
     limit?: number;
     /** Storefront page offset; takes precedence over `cursor`. `offset + limit` ≤ 10,000. */
     offset?: number;
-    /** Single or repeated (up to 10) — repeated params are OR-matched. */
-    companyId?: string | string[];
-    remoteOption?: RemoteOption | RemoteOption[];
-    employmentType?: EmploymentType | EmploymentType[];
-    seniority?: Seniority | Seniority[];
+    /** Repeated param (up to 10) — OR-matched. Repeat `companyId` per value. */
+    companyId?: string[];
+    remoteOption?: RemoteOption[];
+    employmentType?: EmploymentType[];
+    seniority?: Seniority[];
     /** Place slug for a geo radius search; unresolvable slugs are ignored. */
     location?: string;
     /** Radius in km around `location` (10–250; default 50). */
@@ -213,31 +1950,7 @@ type JobsSimilarQuery = {
     /** How many similar jobs to return (1–20; default 5). */
     limit?: number;
 };
-interface JobsSearchBody {
-    /** Free-text query, up to 200 characters. */
-    query?: string;
-    filters?: {
-        /** Up to 10 values each. */
-        companyId?: string[];
-        remoteOption?: RemoteOption[];
-        employmentType?: EmploymentType[];
-        seniority?: Seniority[];
-        /** ISO 8601 datetime bounds. */
-        publishedAt?: {
-            gte?: string;
-            lte?: string;
-        };
-        /** Place slug for a geo radius search. */
-        location?: string;
-        /** Radius in km around `location` (10–250; default 50). */
-        radius?: number;
-    };
-    cursor?: string;
-    /** 1–100. */
-    limit?: number;
-    /** Storefront page offset; takes precedence over `cursor`. */
-    offset?: number;
-}
+type JobsSearchBody = Schemas['PublicSearchJobsBody'];
 
 type Awaitable<T> = T | Promise<T>;
 /**
@@ -305,71 +2018,6 @@ declare class BoardClient {
     fetch<T>(path: string, init?: FetchOptions): Promise<T>;
 }
 
-interface PublicBoardFeatures {
-    jobAlerts: boolean;
-    candidates: boolean;
-    employers: boolean;
-    blog: boolean;
-    talentDirectory: boolean;
-    registrationWall: boolean;
-    passwordProtected: boolean;
-    publicJobSubmission: boolean;
-    candidatePaywall: boolean;
-}
-interface PublicBoardAnalytics {
-    ga4MeasurementId: string | null;
-    gtmId: string | null;
-    metaPixelId: string | null;
-    linkedInPartnerId: string | null;
-    cookieConsentRequired: boolean;
-}
-interface PublicBoardTheme {
-    mode: string;
-    schemeId: string;
-    typography: {
-        fontSans: string;
-        fontHeading?: string | null;
-    };
-    colors: Record<string, unknown>;
-}
-interface PublicBoard {
-    object: 'public_board';
-    /** Immutable board identifier (`boards_…`, ADR-0032). */
-    id: string;
-    /** Mutable canonical slug. */
-    slug: string;
-    name: string;
-    language: string;
-    logoUrl: string | null;
-    primaryDomain: string | null;
-    /** Whitelabel toggle (default `true`) — render the "Powered by Cavuno" badge unless `false`. */
-    showCavunoBranding: boolean;
-    features: PublicBoardFeatures;
-    analytics: PublicBoardAnalytics;
-    theme: PublicBoardTheme | null;
-}
-
-/**
- * The public SEO-infra payload (`board.seo()`). The four values a headless
- * frontend rebuilds `robots.txt` / `ads.txt` / `indexnow-key.txt` (+ the Google
- * site-verification `<meta>`) from — byte-identically to the hosted board.
- */
-interface BoardSeo {
-    object: 'board_seo';
-    /** Verbatim `ads.txt` content, or `null` when not configured. */
-    adsTxt: string | null;
-    /** IndexNow key-file content, or `null` when not configured. */
-    indexNowKey: string | null;
-    /** Google site-verification token for the `<meta>` tag, or `null`. */
-    googleSiteVerification: string | null;
-    /**
-     * The board's canonical base URL (honours a configured custom domain). Build
-     * the `robots.txt` `Sitemap:` line (`${canonicalBase}/sitemap.xml`) and
-     * canonical links from it — NOT the request origin.
-     */
-    canonicalBase: string;
-}
-
 /**
  * Error raised for every non-2xx Board API response.
  *
@@ -423,63 +2071,31 @@ declare function isConflict(e: unknown): e is BoardApiError;
  * constant because the package is platform-neutral and cannot read
  * package.json at runtime.
  */
-declare const SDK_VERSION = "1.3.0";
+declare const SDK_VERSION = "1.5.0";
 
-interface BoardUser {
-    id: string;
-    object: 'board_user';
-    role: 'candidate' | 'employer';
-    email: string;
-    displayName: string | null;
-    emailVerified: boolean;
-}
-/**
- * Bearer pair returned by register/login/refresh. `expiresAt` is the
- * ACCESS token expiry in epoch ms; the refresh token's own 30-day TTL
- * is intentionally not exposed.
- */
-interface BoardAuthSession {
-    object: 'board_auth_session';
-    accessToken: string;
-    refreshToken: string;
-    expiresAt: number;
-    boardUser: BoardUser;
-}
-interface RegisterBody {
-    role: 'candidate' | 'employer';
-    /** Only `emailpass` is supported. */
-    method: 'emailpass';
-    email: string;
-    password: string;
-    displayName: string;
-}
-interface LoginBody {
-    email: string;
-    password: string;
-}
-interface RefreshBody {
-    refreshToken: string;
-}
-interface LogoutBody {
-    refreshToken: string;
-}
-interface VerifyEmailBody {
-    token: string;
-}
-interface ForgotPasswordBody {
-    email: string;
-}
-interface ResetPasswordBody {
-    token: string;
-    password: string;
-}
+type BoardUser = Schemas['BoardUser'];
+type BoardAuthSession = Schemas['BoardAuthSession'];
+type RegisterBody = Schemas['BoardAuthRegisterBody'];
+type LoginBody = Schemas['BoardAuthLoginBody'];
+type RefreshBody = Schemas['BoardAuthRefreshBody'];
+type LogoutBody = Schemas['BoardAuthLogoutBody'];
+type VerifyEmailBody = Schemas['BoardAuthVerifyEmailBody'];
+type ForgotPasswordBody = Schemas['BoardAuthForgotPasswordBody'];
+type ResetPasswordBody = Schemas['BoardAuthResetPasswordBody'];
+
+type PublicBoard = Schemas['PublicBoardContext'];
+type PublicBoardFeatures = PublicBoard['features'];
+type PublicBoardAnalytics = PublicBoard['analytics'];
+type PublicBoardTheme = NonNullable<PublicBoard['theme']>;
 
 /**
- * Query for `board.embed.jobs()` — the embeddable, UNGATED jobs widget. Mirrors
- * the browse list's facets + geo, plus a free-text `q` keyword (the widget is
- * searchable). Deliberately has NO `category`/`skill` programmatic seeding and
- * NO `fields` sparse fieldset — the embed widget exposes none of those.
+ * The public SEO-infra payload (`board.seo()`) — the values a headless
+ * frontend rebuilds `robots.txt` / `ads.txt` / `indexnow-key.txt` (+ the
+ * Google site-verification `<meta>` + favicons/web-manifest) from,
+ * byte-identically to the hosted board.
  */
+type BoardSeo = Schemas['BoardSeo'];
+
 type EmbedJobsQuery = {
     /** Free-text search query, up to 200 characters. */
     q?: string;
@@ -488,11 +2104,11 @@ type EmbedJobsQuery = {
     limit?: number;
     /** Storefront page offset; takes precedence over `cursor`. `offset + limit` ≤ 10,000. */
     offset?: number;
-    /** Single or repeated (up to 10) — repeated params are OR-matched. */
-    companyId?: string | string[];
-    remoteOption?: RemoteOption | RemoteOption[];
-    employmentType?: EmploymentType | EmploymentType[];
-    seniority?: Seniority | Seniority[];
+    /** Repeated param (up to 10) — OR-matched. Repeat `companyId` per value. */
+    companyId?: string[];
+    remoteOption?: RemoteOption[];
+    employmentType?: EmploymentType[];
+    seniority?: Seniority[];
     /** Place slug for a geo radius search; unresolvable slugs are ignored. */
     location?: string;
     /** Radius in km around `location` (10–250; default 50). */
@@ -500,92 +2116,53 @@ type EmbedJobsQuery = {
 };
 
 /**
- * The board-access grant returned by `password.verify()`. Send `token` as the
- * `X-Board-Access` header on content reads to pass a board's password wall
- * (the SDK does this automatically once the grant is stored).
+ * The board-access grant returned by `password.verify()`. Send `token` as
+ * the `X-Board-Access` header on content reads to pass a board's password
+ * wall (the SDK does this automatically once the grant is stored).
  */
-interface BoardAccessGrant {
-    object: 'board_access_grant';
-    token: string;
-}
+type BoardAccessGrant = Schemas['BoardAccessGrant'];
 
 /**
  * The result of resolving a path against the board's configured redirects
- * (`board.redirects.resolve()`). A headless frontend 308s to `target`, or 404s
- * when it's `null`.
+ * (`board.redirects.resolve()`). A headless frontend 308s to `target`, or
+ * 404s when it's `null`.
  */
-interface RedirectResolution {
-    object: 'redirect_resolution';
-    /** The path that was resolved. */
-    path: string;
-    /** The redirect target (board-relative), or `null` when no redirect matches. */
-    target: string | null;
-}
+type RedirectResolution = Schemas['RedirectResolution'];
 
-/** Author shape embedded on posts (no `object` discriminator). */
-interface BlogAuthorEmbed {
-    id: string;
-    name: string;
-    slug: string;
-    bio: string | null;
-    avatarUrl: string | null;
-    websiteUrl: string | null;
-    twitterUrl: string | null;
-    linkedinUrl: string | null;
-    githubUrl: string | null;
-}
-/** Tag shape embedded on posts (no `object` discriminator). */
-interface BlogTagEmbed {
-    id: string;
-    name: string;
-    slug: string;
-    description: string | null;
-}
-interface PublicBlogAuthor extends BlogAuthorEmbed {
-    object: 'public_blog_author';
-}
-interface PublicBlogTag extends BlogTagEmbed {
-    object: 'public_blog_tag';
+/**
+ * A board legal/about page (ADR-0039 transitional portable-prose field). The
+ * API serves owner-authored prose as portable HTML; the starter authors the
+ * layout + JSON-LD. Impressum additionally carries structured legal-entity
+ * facts and is gated by the board's `impressumEnabled` flag (404 when off).
+ */
+type LegalPageType = 'terms-of-service' | 'privacy-policy' | 'cookie-policy' | 'about' | 'impressum';
+interface LegalEntity {
+    legalName: string | null;
+    address: string | null;
 }
-interface PublicBlogPostSummary {
-    id: string;
-    object: 'public_blog_post';
+interface PublicLegalPage {
+    object: 'legal_page';
+    type: string;
+    /** Page heading (H1), with `{{board_name}}` resolved. */
     title: string;
-    slug: string;
-    featured: boolean;
-    coverUrl: string | null;
-    /** Alt text for `coverUrl` (the cover/feature image). */
-    featureImageAlt: string | null;
-    customExcerpt: string | null;
-    readingTimeMin: number | null;
-    publishedAt: string | null;
-    /** A custom canonical URL override for this post, if set. */
-    canonicalUrl: string | null;
-    createdAt: string;
-    authors: BlogAuthorEmbed[];
-    tags: BlogTagEmbed[];
+    /** Owner-authored prose as portable HTML; `''` when the page has no body. */
+    content: string;
+    contentFormat: 'html';
+    /** Structured impressum facts; `null` for non-impressum pages. */
+    legalEntity: LegalEntity | null;
 }
+
+/** Author shape embedded on posts (no `object` discriminator). */
+type BlogAuthorEmbed = Schemas['PublicBlogAuthorEmbed'];
+/** Tag shape embedded on posts (no `object` discriminator). */
+type BlogTagEmbed = Schemas['PublicBlogTagEmbed'];
+type PublicBlogAuthor = Schemas['PublicBlogAuthor'];
+type PublicBlogTag = Schemas['PublicBlogTag'];
+type PublicBlogPostSummary = Schemas['PublicBlogPostSummary'];
 /** Detail shape — `html` appears on the single read only, never on summaries. */
-interface PublicBlogPost extends PublicBlogPostSummary {
-    html: string | null;
-    ogImageUrl: string | null;
-    featureImageCaption: string | null;
-    seoTitle: string | null;
-    seoDescription: string | null;
-    /**
-     * Slug-history resolution. When the requested slug is a renamed post's OLD
-     * slug, `redirected` is `true` and `newSlug` is the post's current slug —
-     * issue a 308 to it. Otherwise `redirected` is `false` and `newSlug` is null.
-     */
-    redirected: boolean;
-    newSlug: string | null;
-}
+type PublicBlogPost = Schemas['PublicBlogPost'];
 /** Previous (older) + next (newer) posts for the detail prev/next nav. */
-interface PublicBlogAdjacentPosts {
-    object: 'blog_adjacent_posts';
-    previous: PublicBlogPostSummary | null;
-    next: PublicBlogPostSummary | null;
-}
+type PublicBlogAdjacentPosts = Schemas['PublicBlogAdjacentPosts'];
 type BlogPostsListQuery = {
     cursor?: string;
     /** 1–100. */
@@ -599,28 +2176,9 @@ type BlogSimilarQuery = {
     /** 1–20; default 6. */
     limit?: number;
 };
-interface BlogSearchBody {
-    /** Free-text query, 1–200 characters. Required. */
-    query: string;
-    cursor?: string | null;
-    /** 1–50. */
-    limit?: number;
-}
+type BlogSearchBody = Schemas['PublicBlogSearchBody'];
 
-interface PublicCompany {
-    id: string;
-    object: 'public_company';
-    name: string;
-    slug: string;
-    website: string | null;
-    logoUrl: string | null;
-    description: string | null;
-    jobCount: number;
-    publishedJobCount: number;
-    links: {
-        public: string | null;
-    };
-}
+type PublicCompany = Schemas['CompanyPublic'];
 type CompaniesListQuery = {
     cursor?: string;
     /** 1–100. */
@@ -631,34 +2189,25 @@ type CompanyJobsListQuery = {
     /** 1–100. */
     limit?: number;
 };
-interface CompaniesSearchBody {
-    /** Free-text query, up to 200 characters. */
-    query?: string;
-    cursor?: string;
-    /** 1–100. */
+type CompanySimilarQuery = {
+    /** 1–20, default 6. */
     limit?: number;
-}
+};
+type CompanyMarket = Schemas['CompanyMarket'];
+type CompanyMarketsListQuery = {
+    /** 1–200, default 100 (a top-by-company-count preview). */
+    limit?: number;
+    search?: string;
+};
+type CompaniesSearchBody = Schemas['PublicCompaniesSearchBody'];
 
-/**
- * The embedded `job` is the SAME `public_job` shape the anonymous jobs
- * list emits — saved rows and search rows render with one component.
- */
-interface SavedJob {
-    id: string;
-    object: 'saved_job';
-    jobId: string;
-    /** ISO 8601. */
-    savedAt: string;
-    job: PublicJob;
-}
+type SavedJob = Schemas['SavedJob'];
 type SavedJobsListQuery = {
     cursor?: string;
     /** 1–100. */
     limit?: number;
 };
-interface SaveJobBody {
-    jobId: string;
-}
+type SaveJobBody = Schemas['SaveJobBody'];
 
 type JobAlertFrequency = 'daily' | 'weekly';
 type JobAlertRemoteOption = 'on_site' | 'hybrid' | 'remote';
@@ -689,55 +2238,15 @@ type JobAlertSubscribeInput = {
         jobSlug?: string;
     };
 };
-interface JobAlertSubscription {
-    object: 'job_alert_subscription';
-    status: 'created' | 'duplicate';
-    requiresConfirmation: boolean;
-    confirmed: boolean;
-}
-interface JobAlertConfirmation {
-    object: 'job_alert_confirmation';
-    status: 'confirmed' | 'already_confirmed' | 'expired' | 'not_found';
-}
-interface JobAlertResendResult {
-    object: 'job_alert_confirmation_resend';
-    status: 'sent' | 'not_found' | 'already_confirmed' | 'throttled' | 'send_failed';
-}
-interface JobAlertManageResult {
-    object: 'job_alert_manage_result';
-    success: boolean;
-}
-/**
- * The stored filter criteria surfaced on the manage page (a serializable subset
- * of the internal filter object — the fields a consumer renders). `jobFunctions`,
- * `placeIds` and `remoteOptions` are the dimensions the digest actually matches on.
- */
-interface JobAlertStoredFilters {
-    jobFunctions?: string[];
-    seniorityLevels?: string[];
-    remoteOptions?: string[];
-    placeIds?: string[];
-    salaryMin?: number | null;
-    salaryMax?: number | null;
-    salaryCurrency?: string | null;
-    frequency?: string;
-}
-interface JobAlertPreference {
-    id: string;
-    label: string | null;
-    frequency: string;
-    isActive: boolean;
-    filters: JobAlertStoredFilters;
-    /** Per-preference HMAC token for `updatePreference`/`deletePreference`. */
-    manageToken: string;
-}
-interface JobAlertManageState {
-    object: 'job_alert_manage_state';
-    email: string;
-    confirmed: boolean;
-    unsubscribed: boolean;
-    preferences: JobAlertPreference[];
-}
+type JobAlertSubscription = Schemas['PublicJobAlertSubscription'];
+type JobAlertConfirmation = Schemas['PublicJobAlertConfirmation'];
+type JobAlertResendResult = Schemas['PublicJobAlertResend'];
+type JobAlertManageResult = Schemas['PublicJobAlertManageResult'];
+type JobAlertManageState = Schemas['PublicJobAlertManageState'];
+/** One stored alert preference on the manage page. */
+type JobAlertPreference = JobAlertManageState['preferences'][number];
+/** The stored filter criteria surfaced on a manage-page preference. */
+type JobAlertStoredFilters = JobAlertPreference['filters'];
 /** Query for `jobAlerts.manage` — the HMAC manage token from the digest email. */
 type JobAlertManageQuery = {
     subscription: string;
@@ -763,36 +2272,13 @@ type JobAlertDeletePreferenceInput = {
     token: string;
 };
 
-interface TaxonomyGeo {
-    lat: number | null;
-    lng: number | null;
-    countryCode: string | null;
-    regionCode: string | null;
-    region: string | null;
-    city: string | null;
-    locality: string | null;
-    placeType: string | null;
-}
-/**
- * Page-meta for a resolved taxonomy slug. `sourceSlug` is the immutable
- * English search key; `canonicalSlug` is the board-language URL; `redirectTo`
- * is the canonical slug to 308 to when the inbound slug isn't canonical (the
- * host app emits the redirect — the SDK never navigates). `geo` is set for
- * place resolutions only.
- */
-interface TaxonomyResolution {
-    object: 'taxonomy_resolution';
-    type: 'category' | 'skill' | 'place';
-    sourceSlug: string;
-    canonicalSlug: string;
-    displayName: string;
-    redirectTo: string | null;
-    geo: TaxonomyGeo | null;
-}
+type TaxonomyGeo = Schemas['TaxonomyGeo'];
+type TaxonomyResolution = Schemas['PublicTaxonomyResolution'];
+type PublicPlace = Schemas['PublicPlace'];
 /**
- * Query for `taxonomy.places.list()`. Omit it (or `q`) for the full locations
- * directory; pass `q` (≥2 chars) for location autocomplete — the top name
- * matches ranked, what a location search field renders.
+ * Query for `taxonomy.places.list()`. Omit it (or `q`) for the full
+ * locations directory; pass `q` (≥2 chars) for location autocomplete — the
+ * top name matches ranked, what a location search field renders.
  */
 type PlacesListQuery = {
     /** Location autocomplete query; ≥2 chars → top name matches, under 2 → empty. */
@@ -800,26 +2286,6 @@ type PlacesListQuery = {
     /** Max autocomplete results when `q` is given (1–50; default 10). */
     limit?: number;
 };
-/**
- * A place in the board's locations directory (`taxonomy.places.list()` →
- * `GET /places`), the data the `/jobs/locations/` index renders. `jobCount` is
- * subtree-summed (a parent counts its descendants); `id`/`parentId` carry the
- * hierarchy so consumers rebuild the same nested tree the hosted index shows.
- */
-interface PublicPlace {
-    object: 'place';
-    /** Stable place identity (locations-tree edge endpoint). */
-    id: string;
-    /** Parent place's `id`; `null` for a root place. */
-    parentId: string | null;
-    /** Public slug (links to `/jobs/locations/:slug`); `null` if unslugged. */
-    slug: string | null;
-    name: string;
-    placeType: string;
-    countryCode: string | null;
-    regionCode: string | null;
-    jobCount: number;
-}
 
 interface CreateBoardClientOptions {
     baseUrl: string;
@@ -863,7 +2329,51 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
      * @example
      * const { name, theme } = await board.context();
      */
-    context(options?: FetchOptions): Promise<PublicBoard>;
+    context(options?: FetchOptions): Promise<{
+        object: "public_board";
+        id: string;
+        slug: string;
+        name: string;
+        language: string;
+        logoUrl: string | null;
+        primaryDomain: string | null;
+        showCavunoBranding: boolean;
+        features: {
+            jobAlerts: boolean;
+            candidates: boolean;
+            employers: boolean;
+            blog: boolean;
+            talentDirectory: boolean;
+            registrationWall: boolean;
+            passwordProtected: boolean;
+            publicJobSubmission: boolean;
+            candidatePaywall: boolean;
+            impressum: boolean;
+        };
+        analytics: {
+            ga4MeasurementId: string | null;
+            gtmId: string | null;
+            metaPixelId: string | null;
+            linkedInPartnerId: string | null;
+            cookieConsentRequired: boolean;
+        };
+        theme: {
+            mode: string;
+            schemeId: string;
+            typography: {
+                fontSans: string;
+                fontHeading?: string | null;
+            };
+            colors: {
+                light: {
+                    [key: string]: unknown;
+                };
+                dark: {
+                    [key: string]: unknown;
+                };
+            };
+        } | null;
+    }>;
     /**
      * Board SEO infra — `ads.txt`, IndexNow key, Google site-verification, and
      * the canonical base URL. Rebuild `robots.txt` / `ads.txt` /
@@ -872,53 +2382,391 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
      * @example
      * const { adsTxt, canonicalBase } = await board.seo();
      */
-    seo(options?: FetchOptions): Promise<BoardSeo>;
+    seo(options?: FetchOptions): Promise<{
+        object: "board_seo";
+        adsTxt: string | null;
+        indexNowKey: string | null;
+        googleSiteVerification: string | null;
+        canonicalBase: string;
+        icons: {
+            ico: string | null;
+            svg: string | null;
+            appleTouch: string | null;
+            icon192: string | null;
+            icon512: string | null;
+            iconMaskable512: string | null;
+        };
+        manifest: {
+            name: string;
+            themeColor: string;
+        };
+    }>;
     jobs: {
         list(query?: JobsListQuery, options?: FetchOptions): Promise<JobCardListEnvelope>;
-        retrieve(jobSlug: string, query?: Record<string, never>, options?: FetchOptions): Promise<PublicJob>;
+        retrieve(jobSlug: string, query?: Record<string, never>, options?: FetchOptions): Promise<{
+            id: string;
+            object: "public_job";
+            title: string;
+            slug: string | null;
+            status: "draft" | "published" | "expired" | "archived";
+            companyId: string | null;
+            employmentType: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other" | null;
+            remoteOption: "on_site" | "hybrid" | "remote" | null;
+            seniority: "entry_level" | "associate" | "mid_level" | "senior" | "lead" | "principal" | "director" | "executive" | null;
+            salaryMin: number | null;
+            salaryMax: number | null;
+            salaryCurrency: string | null;
+            salaryTimeframe: "per_year" | "per_month" | "per_week" | "per_day" | "per_hour" | null;
+            isFeatured: boolean;
+            publishedAt: string | null;
+            expiresAt: string | null;
+            createdAt: string;
+            updatedAt: string;
+            links: components["schemas"]["PublicJobLinks"];
+            description: string | null;
+            applicationUrl: string | null;
+            remotePermits: {
+                type: string;
+                value: string;
+            }[];
+            remoteWorldwide: boolean | null;
+            remoteTimezones: {
+                type: string;
+                value: string;
+                plusMinus?: number;
+            }[];
+            remoteAllowedTzOffsets: number[];
+            remoteWorkPermitCountryCodes: string[];
+            remoteWorkPermitSubdivisionCodes: string[];
+            remoteSponsorship: "yes" | "no" | "unknown";
+            educationRequirements: ("high_school" | "associate_degree" | "bachelor_degree" | "professional_certificate" | "postgraduate_degree" | "no_requirements")[];
+            experienceMonths: number | null;
+            experienceInPlaceOfEducation: boolean | null;
+            inOfficePeriod: "per_week" | "per_month" | "per_year" | null;
+            inOfficeFrequency: number | null;
+            company: components["schemas"]["JobCompany"];
+            officeLocations: components["schemas"]["JobOfficeLocation"][];
+            categories: {
+                slug: string;
+                name: string;
+            }[];
+            skills: {
+                slug: string;
+                name: string;
+            }[];
+            placeHierarchy: {
+                slug: string;
+                name: string;
+            }[];
+        }>;
         search(body: JobsSearchBody, query?: Record<string, never>, options?: FetchOptions): Promise<JobCardSearchEnvelope>;
-        similar(jobSlug: string, query?: JobsSimilarQuery, options?: FetchOptions): Promise<ListEnvelope<PublicJobCard>>;
+        similar(jobSlug: string, query?: JobsSimilarQuery, options?: FetchOptions): Promise<ListEnvelope<{
+            id: string;
+            object: "job_card";
+            slug: string;
+            title: string;
+            publishedAt: string | null;
+            employmentType: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other" | null;
+            remoteOption: "on_site" | "hybrid" | "remote" | null;
+            remoteLocationLabel: string | null;
+            salaryMin: number | null;
+            salaryMax: number | null;
+            salaryCurrency: string | null;
+            salaryTimeframe: string | null;
+            isFeatured: boolean;
+            locationLabel: string | null;
+            company: {
+                slug: string;
+                name: string;
+                logoUrl: string | null;
+            } | null;
+            categories: {
+                slug: string;
+                name: string;
+            }[];
+            skills: {
+                slug: string;
+                name: string;
+            }[];
+            links: {
+                public: string | null;
+            };
+            description?: string | null;
+        }>>;
     };
     embed: {
-        jobs(query?: EmbedJobsQuery, options?: FetchOptions): Promise<ListEnvelope<PublicJobCard>>;
+        jobs(query?: EmbedJobsQuery, options?: FetchOptions): Promise<ListEnvelope<{
+            id: string;
+            object: "job_card";
+            slug: string;
+            title: string;
+            publishedAt: string | null;
+            employmentType: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other" | null;
+            remoteOption: "on_site" | "hybrid" | "remote" | null;
+            remoteLocationLabel: string | null;
+            salaryMin: number | null;
+            salaryMax: number | null;
+            salaryCurrency: string | null;
+            salaryTimeframe: string | null;
+            isFeatured: boolean;
+            locationLabel: string | null;
+            company: {
+                slug: string;
+                name: string;
+                logoUrl: string | null;
+            } | null;
+            categories: {
+                slug: string;
+                name: string;
+            }[];
+            skills: {
+                slug: string;
+                name: string;
+            }[];
+            links: {
+                public: string | null;
+            };
+            description?: string | null;
+        }>>;
     };
     companies: {
-        list(query?: CompaniesListQuery, options?: FetchOptions): Promise<ListEnvelope<PublicCompany>>;
-        retrieve(companySlug: string, query?: Record<string, never>, options?: FetchOptions): Promise<PublicCompany>;
-        search(body: CompaniesSearchBody, query?: Record<string, never>, options?: FetchOptions): Promise<SearchEnvelope<PublicCompany>>;
+        list(query?: CompaniesListQuery, options?: FetchOptions): Promise<ListEnvelope<{
+            id: string;
+            object: "public_company";
+            name: string;
+            slug: string;
+            website: string | null;
+            logoUrl: string | null;
+            description: string | null;
+            jobCount: number;
+            publishedJobCount: number;
+            links: components["schemas"]["PublicCompanyLinks"];
+        }>>;
+        retrieve(companySlug: string, query?: Record<string, never>, options?: FetchOptions): Promise<{
+            id: string;
+            object: "public_company";
+            name: string;
+            slug: string;
+            website: string | null;
+            logoUrl: string | null;
+            description: string | null;
+            jobCount: number;
+            publishedJobCount: number;
+            links: components["schemas"]["PublicCompanyLinks"];
+        }>;
+        search(body: CompaniesSearchBody, query?: Record<string, never>, options?: FetchOptions): Promise<SearchEnvelope<{
+            id: string;
+            object: "public_company";
+            name: string;
+            slug: string;
+            website: string | null;
+            logoUrl: string | null;
+            description: string | null;
+            jobCount: number;
+            publishedJobCount: number;
+            links: components["schemas"]["PublicCompanyLinks"];
+        }>>;
         listJobs(companySlug: string, query?: CompanyJobsListQuery, options?: FetchOptions): Promise<JobCardListEnvelope>;
+        similar(companySlug: string, query?: CompanySimilarQuery, options?: FetchOptions): Promise<ListEnvelope<{
+            id: string;
+            object: "public_company";
+            name: string;
+            slug: string;
+            website: string | null;
+            logoUrl: string | null;
+            description: string | null;
+            jobCount: number;
+            publishedJobCount: number;
+            links: components["schemas"]["PublicCompanyLinks"];
+        }>>;
+        markets(query?: CompanyMarketsListQuery, options?: FetchOptions): Promise<ListEnvelope<{
+            object: "company_market";
+            slug: string;
+            name: string;
+            companyCount: number;
+        }>>;
     };
     blog: {
         posts: {
-            list(query?: BlogPostsListQuery, options?: FetchOptions): Promise<ListEnvelope<PublicBlogPostSummary>>;
-            retrieve(postSlug: string, query?: Record<string, never>, options?: FetchOptions): Promise<PublicBlogPost>;
-            adjacent(postSlug: string, options?: FetchOptions): Promise<PublicBlogAdjacentPosts>;
-            similar(postSlug: string, query?: BlogSimilarQuery, options?: FetchOptions): Promise<ListEnvelope<PublicBlogPostSummary>>;
+            list(query?: BlogPostsListQuery, options?: FetchOptions): Promise<ListEnvelope<{
+                id: string;
+                object: "public_blog_post";
+                title: string;
+                slug: string;
+                featured: boolean;
+                coverUrl: string | null;
+                featureImageAlt: string | null;
+                customExcerpt: string | null;
+                readingTimeMin: number | null;
+                publishedAt: string | null;
+                canonicalUrl: string | null;
+                createdAt: string;
+                authors: components["schemas"]["PublicBlogAuthorEmbed"][];
+                tags: components["schemas"]["PublicBlogTagEmbed"][];
+            }>>;
+            retrieve(postSlug: string, query?: Record<string, never>, options?: FetchOptions): Promise<{
+                id: string;
+                object: "public_blog_post";
+                title: string;
+                slug: string;
+                featured: boolean;
+                coverUrl: string | null;
+                featureImageAlt: string | null;
+                customExcerpt: string | null;
+                readingTimeMin: number | null;
+                publishedAt: string | null;
+                canonicalUrl: string | null;
+                createdAt: string;
+                authors: components["schemas"]["PublicBlogAuthorEmbed"][];
+                tags: components["schemas"]["PublicBlogTagEmbed"][];
+            } & {
+                html: string | null;
+                ogImageUrl: string | null;
+                featureImageCaption: string | null;
+                seoTitle: string | null;
+                seoDescription: string | null;
+                redirected: boolean;
+                newSlug: string | null;
+            }>;
+            adjacent(postSlug: string, options?: FetchOptions): Promise<{
+                object: "blog_adjacent_posts";
+                previous: components["schemas"]["PublicBlogPostSummary"] & unknown;
+                next: components["schemas"]["PublicBlogPostSummary"] & unknown;
+            }>;
+            similar(postSlug: string, query?: BlogSimilarQuery, options?: FetchOptions): Promise<ListEnvelope<{
+                id: string;
+                object: "public_blog_post";
+                title: string;
+                slug: string;
+                featured: boolean;
+                coverUrl: string | null;
+                featureImageAlt: string | null;
+                customExcerpt: string | null;
+                readingTimeMin: number | null;
+                publishedAt: string | null;
+                canonicalUrl: string | null;
+                createdAt: string;
+                authors: components["schemas"]["PublicBlogAuthorEmbed"][];
+                tags: components["schemas"]["PublicBlogTagEmbed"][];
+            }>>;
         };
         tags: {
-            list(query?: Record<string, never>, options?: FetchOptions): Promise<ListEnvelope<PublicBlogTag>>;
-            retrieve(tagSlug: string, query?: Record<string, never>, options?: FetchOptions): Promise<PublicBlogTag>;
+            list(query?: Record<string, never>, options?: FetchOptions): Promise<ListEnvelope<{
+                id: string;
+                name: string;
+                slug: string;
+                description: string | null;
+            } & {
+                object: "public_blog_tag";
+            }>>;
+            retrieve(tagSlug: string, query?: Record<string, never>, options?: FetchOptions): Promise<{
+                id: string;
+                name: string;
+                slug: string;
+                description: string | null;
+            } & {
+                object: "public_blog_tag";
+            }>;
         };
         authors: {
-            list(query?: Record<string, never>, options?: FetchOptions): Promise<ListEnvelope<PublicBlogAuthor>>;
-            retrieve(authorSlug: string, query?: Record<string, never>, options?: FetchOptions): Promise<PublicBlogAuthor>;
+            list(query?: Record<string, never>, options?: FetchOptions): Promise<ListEnvelope<{
+                id: string;
+                name: string;
+                slug: string;
+                bio: string | null;
+                avatarUrl: string | null;
+                websiteUrl: string | null;
+                twitterUrl: string | null;
+                linkedinUrl: string | null;
+                githubUrl: string | null;
+            } & {
+                object: "public_blog_author";
+            }>>;
+            retrieve(authorSlug: string, query?: Record<string, never>, options?: FetchOptions): Promise<{
+                id: string;
+                name: string;
+                slug: string;
+                bio: string | null;
+                avatarUrl: string | null;
+                websiteUrl: string | null;
+                twitterUrl: string | null;
+                linkedinUrl: string | null;
+                githubUrl: string | null;
+            } & {
+                object: "public_blog_author";
+            }>;
         };
-        search(body: BlogSearchBody, query?: Record<string, never>, options?: FetchOptions): Promise<SearchEnvelope<PublicBlogPostSummary>>;
+        search(body: BlogSearchBody, query?: Record<string, never>, options?: FetchOptions): Promise<SearchEnvelope<{
+            id: string;
+            object: "public_blog_post";
+            title: string;
+            slug: string;
+            featured: boolean;
+            coverUrl: string | null;
+            featureImageAlt: string | null;
+            customExcerpt: string | null;
+            readingTimeMin: number | null;
+            publishedAt: string | null;
+            canonicalUrl: string | null;
+            createdAt: string;
+            authors: components["schemas"]["PublicBlogAuthorEmbed"][];
+            tags: components["schemas"]["PublicBlogTagEmbed"][];
+        }>>;
+    };
+    legal: {
+        retrieve(type: LegalPageType, options?: FetchOptions): Promise<PublicLegalPage>;
     };
     auth: {
-        register(body: RegisterBody, options?: FetchOptions): Promise<BoardAuthSession>;
-        login(body: LoginBody, options?: FetchOptions): Promise<BoardAuthSession>;
-        refresh(body?: RefreshBody, options?: FetchOptions): Promise<BoardAuthSession>;
+        register(body: RegisterBody, options?: FetchOptions): Promise<{
+            object: "board_auth_session";
+            accessToken: string;
+            refreshToken: string;
+            expiresAt: number;
+            boardUser: components["schemas"]["BoardUser"];
+        }>;
+        login(body: LoginBody, options?: FetchOptions): Promise<{
+            object: "board_auth_session";
+            accessToken: string;
+            refreshToken: string;
+            expiresAt: number;
+            boardUser: components["schemas"]["BoardUser"];
+        }>;
+        refresh(body?: RefreshBody, options?: FetchOptions): Promise<{
+            object: "board_auth_session";
+            accessToken: string;
+            refreshToken: string;
+            expiresAt: number;
+            boardUser: components["schemas"]["BoardUser"];
+        }>;
         logout(body?: LogoutBody, options?: FetchOptions): Promise<void>;
         verifyEmail(body: VerifyEmailBody, options?: FetchOptions): Promise<void>;
         forgotPassword(body: ForgotPasswordBody, options?: FetchOptions): Promise<void>;
         resetPassword(body: ResetPasswordBody, options?: FetchOptions): Promise<void>;
     };
     me: {
-        retrieve(query?: Record<string, never>, options?: FetchOptions): Promise<BoardUser>;
+        retrieve(query?: Record<string, never>, options?: FetchOptions): Promise<{
+            id: string;
+            object: "board_user";
+            role: "candidate" | "employer";
+            email: string;
+            displayName: string | null;
+            emailVerified: boolean;
+        }>;
         savedJobs: {
-            list(query?: SavedJobsListQuery, options?: FetchOptions): Promise<ListEnvelope<SavedJob>>;
-            save(body: SaveJobBody, query?: Record<string, never>, options?: FetchOptions): Promise<SavedJob>;
+            list(query?: SavedJobsListQuery, options?: FetchOptions): Promise<ListEnvelope<{
+                id: string;
+                object: "saved_job";
+                jobId: string;
+                savedAt: string;
+                job: components["schemas"]["PublicJob"];
+            }>>;
+            save(body: SaveJobBody, query?: Record<string, never>, options?: FetchOptions): Promise<{
+                id: string;
+                object: "saved_job";
+                jobId: string;
+                savedAt: string;
+                job: components["schemas"]["PublicJob"];
+            }>;
             unsave(jobId: string, query?: Record<string, never>, options?: FetchOptions): Promise<void>;
         };
     };
@@ -927,34 +2775,110 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
     };
     taxonomy: {
         categories: {
-            resolve(slug: string, options?: FetchOptions): Promise<TaxonomyResolution>;
+            resolve(slug: string, options?: FetchOptions): Promise<{
+                object: "taxonomy_resolution";
+                type: "category" | "skill" | "place";
+                sourceSlug: string;
+                canonicalSlug: string;
+                displayName: string;
+                redirectTo: string | null;
+                geo: components["schemas"]["TaxonomyGeo"];
+            }>;
         };
         skills: {
-            resolve(slug: string, options?: FetchOptions): Promise<TaxonomyResolution>;
+            resolve(slug: string, options?: FetchOptions): Promise<{
+                object: "taxonomy_resolution";
+                type: "category" | "skill" | "place";
+                sourceSlug: string;
+                canonicalSlug: string;
+                displayName: string;
+                redirectTo: string | null;
+                geo: components["schemas"]["TaxonomyGeo"];
+            }>;
         };
         places: {
-            list(query?: PlacesListQuery, options?: FetchOptions): Promise<ListEnvelope<PublicPlace>>;
-            resolve(slug: string, options?: FetchOptions): Promise<TaxonomyResolution>;
+            list(query?: PlacesListQuery, options?: FetchOptions): Promise<ListEnvelope<{
+                object: "place";
+                id: string;
+                parentId: string | null;
+                slug: string | null;
+                name: string;
+                placeType: string;
+                countryCode: string | null;
+                regionCode: string | null;
+                jobCount: number;
+            }>>;
+            resolve(slug: string, options?: FetchOptions): Promise<{
+                object: "taxonomy_resolution";
+                type: "category" | "skill" | "place";
+                sourceSlug: string;
+                canonicalSlug: string;
+                displayName: string;
+                redirectTo: string | null;
+                geo: components["schemas"]["TaxonomyGeo"];
+            }>;
         };
     };
     redirects: {
-        resolve(path: string, options?: FetchOptions): Promise<RedirectResolution>;
+        resolve(path: string, options?: FetchOptions): Promise<{
+            object: "redirect_resolution";
+            path: string;
+            target: string | null;
+        }>;
     };
     jobAlerts: {
-        subscribe(input: JobAlertSubscribeInput, options?: FetchOptions): Promise<JobAlertSubscription>;
+        subscribe(input: JobAlertSubscribeInput, options?: FetchOptions): Promise<{
+            object: "job_alert_subscription";
+            status: "created" | "duplicate";
+            requiresConfirmation: boolean;
+            confirmed: boolean;
+        }>;
         confirm(input: {
             token: string;
-        }, options?: FetchOptions): Promise<JobAlertConfirmation>;
+        }, options?: FetchOptions): Promise<{
+            object: "job_alert_confirmation";
+            status: "confirmed" | "already_confirmed" | "expired" | "not_found";
+        }>;
         resendConfirmation(input: {
             email: string;
-        }, options?: FetchOptions): Promise<JobAlertResendResult>;
-        manage(query: JobAlertManageQuery, options?: FetchOptions): Promise<JobAlertManageState>;
-        unsubscribe(input: JobAlertManageTokenInput, options?: FetchOptions): Promise<JobAlertManageResult>;
-        resubscribe(input: JobAlertManageTokenInput, options?: FetchOptions): Promise<JobAlertManageResult>;
-        updatePreference(input: JobAlertUpdatePreferenceInput, options?: FetchOptions): Promise<JobAlertManageResult>;
-        deletePreference(input: JobAlertDeletePreferenceInput, options?: FetchOptions): Promise<JobAlertManageResult>;
+        }, options?: FetchOptions): Promise<{
+            object: "job_alert_confirmation_resend";
+            status: "sent" | "not_found" | "already_confirmed" | "throttled" | "send_failed";
+        }>;
+        manage(query: JobAlertManageQuery, options?: FetchOptions): Promise<{
+            object: "job_alert_manage_state";
+            email: string;
+            confirmed: boolean;
+            unsubscribed: boolean;
+            preferences: {
+                id: string;
+                label: string | null;
+                frequency: string;
+                isActive: boolean;
+                filters: {
+                    [key: string]: unknown;
+                };
+                manageToken: string;
+            }[];
+        }>;
+        unsubscribe(input: JobAlertManageTokenInput, options?: FetchOptions): Promise<{
+            object: "job_alert_manage_result";
+            success: boolean;
+        }>;
+        resubscribe(input: JobAlertManageTokenInput, options?: FetchOptions): Promise<{
+            object: "job_alert_manage_result";
+            success: boolean;
+        }>;
+        updatePreference(input: JobAlertUpdatePreferenceInput, options?: FetchOptions): Promise<{
+            object: "job_alert_manage_result";
+            success: boolean;
+        }>;
+        deletePreference(input: JobAlertDeletePreferenceInput, options?: FetchOptions): Promise<{
+            object: "job_alert_manage_result";
+            success: boolean;
+        }>;
     };
 };
 type BoardSdk = ReturnType<typeof createBoardClient>;
 
-export { ACCESS_TOKEN_KEY, type Awaitable, BOARD_ACCESS_GRANT_KEY, type BlogAuthorEmbed, type BlogPostsListQuery, type BlogSearchBody, type BlogSimilarQuery, type BlogTagEmbed, type BoardAccessGrant, BoardApiError, type BoardAuthSession, BoardClient, type BoardRequest, type BoardSdk, type BoardSeo, type BoardUser, type CompaniesListQuery, type CompaniesSearchBody, type CompanyJobsListQuery, type CreateBoardClientOptions, type CustomStorage, type EducationRequirement, type EmbedJobsQuery, type EmploymentType, type FetchOptions, type ForgotPasswordBody, type JobAlertConfirmation, type JobAlertDeletePreferenceInput, type JobAlertFiltersInput, type JobAlertFrequency, type JobAlertManageQuery, type JobAlertManageResult, type JobAlertManageState, type JobAlertManageTokenInput, type JobAlertPreference, type JobAlertRemoteOption, type JobAlertResendResult, type JobAlertStoredFilters, type JobAlertSubscribeInput, type JobAlertSubscription, type JobAlertUpdatePreferenceInput, type JobCardListEnvelope, type JobCardSearchEnvelope, type JobCompany, type JobsListQuery, type JobsSearchBody, type ListEnvelope, type Logger, type LoginBody, type LogoutBody, type OfficeLocation, type PlacesListQuery, type PublicBlogAdjacentPosts, type PublicBlogAuthor, type PublicBlogPost, type PublicBlogPostSummary, type PublicBlogTag, type PublicBoard, type PublicBoardAnalytics, type PublicBoardFeatures, type PublicBoardTheme, type PublicCompany, type PublicJob, type PublicJobCard, type PublicPlace, REFRESH_TOKEN_KEY, type RedirectResolution, type RefreshBody, type RegisterBody, type RelatedSearch, type RemoteOption, type RemotePermit, type RemoteTimezone, type ResetPasswordBody, SDK_VERSION, type SaveJobBody, type SavedJob, type SavedJobsListQuery, type SearchEnvelope, type Seniority, type StorageMode, type StorefrontPagination, type TaxonomyGeo, type TaxonomyResolution, type VerifyEmailBody, createBoardClient, isBoardApiError, isBoardPasswordRequired, isConflict, isForbidden, isNotFound, isRateLimited, isUnauthorized, isValidationError };
+export { ACCESS_TOKEN_KEY, type Awaitable, BOARD_ACCESS_GRANT_KEY, type BlogAuthorEmbed, type BlogPostsListQuery, type BlogSearchBody, type BlogSimilarQuery, type BlogTagEmbed, type BoardAccessGrant, BoardApiError, type BoardAuthSession, BoardClient, type BoardRequest, type BoardSdk, type BoardSeo, type BoardUser, type CompaniesListQuery, type CompaniesSearchBody, type CompanyJobsListQuery, type CompanyMarket, type CompanyMarketsListQuery, type CompanySimilarQuery, type CreateBoardClientOptions, type CustomStorage, type EducationRequirement, type EmbedJobsQuery, type EmploymentType, type FetchOptions, type ForgotPasswordBody, type JobAlertConfirmation, type JobAlertDeletePreferenceInput, type JobAlertFiltersInput, type JobAlertFrequency, type JobAlertManageQuery, type JobAlertManageResult, type JobAlertManageState, type JobAlertManageTokenInput, type JobAlertPreference, type JobAlertRemoteOption, type JobAlertResendResult, type JobAlertStoredFilters, type JobAlertSubscribeInput, type JobAlertSubscription, type JobAlertUpdatePreferenceInput, type JobCardListEnvelope, type JobCardSearchEnvelope, type JobCompany, type JobsListQuery, type JobsSearchBody, type LegalEntity, type LegalPageType, type ListEnvelope, type Logger, type LoginBody, type LogoutBody, type OfficeLocation, type PlacesListQuery, type PublicBlogAdjacentPosts, type PublicBlogAuthor, type PublicBlogPost, type PublicBlogPostSummary, type PublicBlogTag, type PublicBoard, type PublicBoardAnalytics, type PublicBoardFeatures, type PublicBoardTheme, type PublicCompany, type PublicJob, type PublicJobCard, type PublicLegalPage, type PublicPlace, REFRESH_TOKEN_KEY, type RedirectResolution, type RefreshBody, type RegisterBody, type RelatedSearch, type RemoteOption, type RemotePermit, type RemoteTimezone, type ResetPasswordBody, SDK_VERSION, type SaveJobBody, type SavedJob, type SavedJobsListQuery, type SearchEnvelope, type Seniority, type StorageMode, type StorefrontPagination, type TaxonomyGeo, type TaxonomyResolution, type VerifyEmailBody, createBoardClient, isBoardApiError, isBoardPasswordRequired, isConflict, isForbidden, isNotFound, isRateLimited, isUnauthorized, isValidationError };