@cavuno/board 1.4.0 → 1.5.0

package/dist/index.d.ts

@@ -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,89 +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;
-    /**
-     * 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;
-    };
-    /** Web-manifest metadata; assemble `site.webmanifest` from this + `icons`. */
-    manifest: {
-        name: string;
-        themeColor: string;
-    };
-}
-
 /**
  * Error raised for every non-2xx Board API response.
  *
@@ -441,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.4.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;
@@ -506,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). */
@@ -518,27 +2116,18 @@ 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'];
 
 /**
  * A board legal/about page (ADR-0039 transitional portable-prose field). The
@@ -564,69 +2153,16 @@ interface PublicLegalPage {
 }
 
 /** 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;
-}
+type BlogAuthorEmbed = Schemas['PublicBlogAuthorEmbed'];
 /** 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';
-}
-interface PublicBlogPostSummary {
-    id: string;
-    object: 'public_blog_post';
-    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[];
-}
+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. */
@@ -640,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. */
@@ -676,45 +2193,21 @@ type CompanySimilarQuery = {
     /** 1–20, default 6. */
     limit?: number;
 };
-interface CompanyMarket {
-    object: 'company_market';
-    slug: string;
-    name: string;
-    companyCount: number;
-}
+type CompanyMarket = Schemas['CompanyMarket'];
 type CompanyMarketsListQuery = {
     /** 1–200, default 100 (a top-by-company-count preview). */
     limit?: number;
     search?: string;
 };
-interface CompaniesSearchBody {
-    /** Free-text query, up to 200 characters. */
-    query?: string;
-    cursor?: string;
-    /** 1–100. */
-    limit?: number;
-}
+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';
@@ -745,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;
@@ -819,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. */
@@ -856,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;
@@ -919,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` /
@@ -928,58 +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<PublicCompany>>;
-        markets(query?: CompanyMarketsListQuery, options?: FetchOptions): Promise<ListEnvelope<CompanyMarket>>;
+        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>;
         };
     };
@@ -988,32 +2775,108 @@ 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>;