@curviate/sdk 0.7.0 → 0.9.0

package/CHANGELOG.md

@@ -7,6 +7,37 @@ Versioning: semantic — minor for additive changes, patch for bug fixes; no sta
 
 ---
 
+## [0.9.0] — 2026-07-03
+
+### Added
+
+- **Account enrichment fields.** `accounts.list()` items and `accounts.get()` now carry six cached account-detail fields, populated by an async background enrichment on every successful account activation: `username`, `premium_id`, `public_identifier`, `substrate_created_at` (ISO-8601 UTC), `signatures` (`{title, content}[]`), and `groups` (`string[]`). All six are `null`/`[]` until the account's first enrichment pass completes — never `undefined`, never a missing key. Types: `AccountListPage`, `AccountDetail`.
+- `accounts.get()` gains `seat_id` (`string | null`) — the seat the account occupies, `null` for an admin seatless account. Previously only `accounts.list()` items carried this field.
+
+### Changed
+
+- `connected_at` (on both `accounts.list()` items and `accounts.get()`) and `last_checked_at` (`accounts.get()`) now consistently emit ISO-8601 UTC (`…Z`) timestamps — a prior docs-vs-runtime drift meant these could reach callers in raw Postgres wire format. No type change (already typed as `string`/`string | null`); this is a runtime-correctness fix reflected in the regenerated example values.
+- Regenerated types from the current API surface. No resource method signatures changed — purely additive response fields.
+- `quotas[]` (on `accounts.get()`) is now documented as advisory usage-safety recommendations: daily families never cause a rejected request; only `account.per_minute` is a binding limit enforced with HTTP 429. `recommended_throttle_hint` semantics documented per level (`none` / `slow_down` / `backoff` are advisory; `stop` is reserved for the binding per-minute limit). JSDoc-only — no type shape change.
+
+---
+
+## [0.8.0] — 2026-07-02
+
+### Added
+
+- **Recruiter job-lifecycle endpoints are now fully implemented server-side.** The following operations no longer return `501` and are safe to call in production: getting/rejecting an applicant, downloading an applicant's resume, listing a job's applicants, solving a job's publish checkpoint, publishing a job, and fetching a Recruiter profile. Their generated response types no longer include a `501` variant — if your code branched on it, that branch is now dead and can be removed.
+- Richer parameter documentation across the Recruiter and search surfaces: job/applicant/hiring-project IDs now describe where to obtain them (e.g. `job_id` from `GET /v1/recruiter/jobs`, `user_id` from a people-search result), and several previously-terse descriptions were corrected (e.g. the saved-search `industry` filter's cross-reference).
+- Server-side parameter defaults are now surfaced in the generated JSDoc (`@default`) wherever the API applies one when a param is omitted — link-expiry seconds, chat visibility, hiring-project list `limit`, webhook delivery `format`/`enabled`/`headers`/`data`, and more.
+- **Breaking (typed consumers):** the Sales Navigator company-search `annual_revenue.min`/`max` filter is now a bucketed numeric enum (`0 | 0.2 | 1 | 2.5 | 5 | 10 | 20 | 50 | 100 | 500 | 1000 | 1001`) instead of a free-form `number`, matching what the API actually accepts. Code passing arbitrary numbers no longer typechecks — pick the nearest bucket value. Runtime behavior is unchanged (the API already only accepted these buckets).
+
+### Changed
+
+- **Search filter guard-rails are now documented.** `search.companies` `limit` requires a minimum of 2 (was 1) — the API rejects single-result company searches. `search.jobs` `benefits` and `commitments` filters now document their accepted values. `search.people` `open_to` now documents its accepted values (`proBono`, `boardMember`). The `search.posts` request examples were corrected to use the actual `member`/`company` array filter shape instead of a `member_urn` string.
+- Regenerated types from the current API surface. No resource method signatures changed.
+
+---
+
 ## [0.7.0] — 2026-07-01
 
 ### Changed

package/dist/index.d.ts

@@ -164,8 +164,23 @@ interface paths {
                                 headline?: string | null;
                                 /** @description The seat this account occupies. */
                                 seat_id?: string | null;
-                                /** @description ISO-8601 connection timestamp. */
-                                connected_at?: string;
+                                /** @description ISO-8601 UTC connection timestamp. */
+                                connected_at?: string | null;
+                                /** @description Cached account username. Null until enriched. */
+                                username?: string | null;
+                                /** @description Cached premium-membership id. Null until enriched, or for non-premium accounts. */
+                                premium_id?: string | null;
+                                /** @description Cached public profile identifier. Null until enriched. */
+                                public_identifier?: string | null;
+                                /** @description ISO-8601 UTC creation timestamp of the underlying LinkedIn account — distinct from connected_at. Null until enriched. */
+                                substrate_created_at?: string | null;
+                                /** @description Cached signature blocks (title + content) for the account. Empty until enriched. */
+                                signatures?: {
+                                    title?: string;
+                                    content?: string;
+                                }[];
+                                /** @description Cached group names the account belongs to. Empty until enriched. */
+                                groups?: string[];
                             }[];
                             /** @description Next-page cursor; null on the last page. */
                             cursor?: string | null;
@@ -508,9 +523,28 @@ interface paths {
                             auth_method?: string;
                             full_name?: string | null;
                             headline?: string | null;
+                            /** @description ISO-8601 UTC connection timestamp. */
                             connected_at?: string | null;
+                            /** @description ISO-8601 UTC time the account state was last checked. */
                             last_checked_at?: string;
-                            /** @description Per-account quota view — one entry per tracked family (messages.daily, connection_requests.daily, profile_views.daily, inmail.daily, account.per_minute). */
+                            /** @description The seat this account occupies (null for an admin seatless account). */
+                            seat_id?: string | null;
+                            /** @description Cached account username. Null until enriched. */
+                            username?: string | null;
+                            /** @description Cached premium-membership id. Null until enriched, or for non-premium accounts. */
+                            premium_id?: string | null;
+                            /** @description Cached public profile identifier. Null until enriched. */
+                            public_identifier?: string | null;
+                            /** @description ISO-8601 UTC creation timestamp of the underlying LinkedIn account — distinct from connected_at. Null until enriched. */
+                            substrate_created_at?: string | null;
+                            /** @description Cached signature blocks (title + content) for the account. Empty until enriched. */
+                            signatures?: {
+                                title?: string;
+                                content?: string;
+                            }[];
+                            /** @description Cached group names the account belongs to. Empty until enriched. */
+                            groups?: string[];
+                            /** @description Usage-safety recommendations for this account — one entry per tracked family (messages.daily, connection_requests.daily, profile_views.daily, inmail.daily, profile.endorse, account.per_minute). These are advisory only: Curviate never rejects a request because a daily recommendation is exceeded; only account.per_minute is a binding limit enforced with HTTP 429. */
                             quotas?: {
                                 /** @description Quota family (e.g. messages.daily, account.per_minute). */
                                 quota_name?: string;
@@ -521,7 +555,7 @@ interface paths {
                                 /** @description ISO-8601 UTC time the current window resets. */
                                 reset_time?: string;
                                 /**
-                                 * @description Pacing hint.
+                                 * @description Pacing recommendation for this family, advisory only. `none` (under 80% consumed), `slow_down` (80-99% consumed), and `backoff` (100%+ consumed) never block a request. `stop` is reserved exclusively for `account.per_minute` — the sole binding limit, whose breach is enforced with HTTP 429.
                                  * @enum {string}
                                  */
                                 recommended_throttle_hint?: "none" | "slow_down" | "backoff" | "stop";
@@ -854,10 +888,14 @@ interface paths {
                         account_id?: string;
                         /**
                          * @description 'create' = new account onboarding; 'reconnect' = re-auth of existing account
+                         * @default create
                          * @enum {string}
                          */
                         purpose?: "create" | "reconnect";
-                        /** @description Seconds until the link expires (60–3600, default 900) */
+                        /**
+                         * @description Seconds until the link expires (60–3600, default 900)
+                         * @default 900
+                         */
                         expires_in_seconds?: number;
                         /** @description Optional browser return URL after the hosted flow. No credential material. */
                         redirect_url?: string;
@@ -7622,6 +7660,7 @@ interface paths {
                 };
                 header?: never;
                 path: {
+                    /** @description The target profile's public identifier (vanity slug), member ID, or URN. */
                     identifier: string;
                 };
                 cookie?: never;
@@ -7782,15 +7821,6 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Not implemented — the Recruiter profile endpoint is not available on this account configuration. */
-                501: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
                 /** @description PLATFORM_ERROR — A temporary error occurred. Please try again. */
                 502: {
                     headers: {
@@ -7872,12 +7902,12 @@ interface paths {
                         saved_search?: {
                             /** @description Saved search ID. Resolve via search/parameters?type=SAVED_SEARCHES. */
                             id: string;
-                            /** @description Project ID the saved search belongs to. Resolve via search/parameters?type=HIRING_PROJECTS. */
+                            /** @description Project ID the saved search belongs to. Resolve via search/parameters?type=SAVED_SEARCHES. */
                             project_id: string;
                             /** @description When true, returns only results new since the search was last run. */
                             newest_results_only?: boolean;
                         };
-                        /** @description INDUSTRY IDs to include or exclude. Resolve via search/parameters?type=DEPARTMENT. */
+                        /** @description INDUSTRY IDs to include or exclude. Resolve via search/parameters?type=INDUSTRY. */
                         industry?: {
                             /** @description Filter IDs to include. */
                             include?: string[];
@@ -8516,10 +8546,15 @@ interface paths {
         get: {
             parameters: {
                 query: {
+                    /** @description The Curviate account ID whose Recruiter session lists hiring projects. */
                     account_id: string;
+                    /** @description Maximum number of hiring projects to return (1–100). Defaults to 10. */
                     limit?: number;
+                    /** @description Opaque pagination cursor from a previous response. Omit for the first page. */
                     cursor?: string;
+                    /** @description Field to sort hiring projects by. Defaults to ACCESSED_TIME. */
                     sort_by?: "NAME" | "FAVORITE" | "CREATED_TIME" | "ACCESSED_TIME" | "ENGAGED_TIME" | "ENGAGEMENT_COUNT";
+                    /** @description Sort direction. Defaults to DESCENDING. */
                     sort_order?: "ASCENDING" | "DESCENDING";
                 };
                 header?: never;
@@ -8750,10 +8785,12 @@ interface paths {
         get: {
             parameters: {
                 query: {
+                    /** @description The Curviate account ID whose Recruiter session performs this call. */
                     account_id: string;
                 };
                 header?: never;
                 path: {
+                    /** @description The hiring project ID. Obtain it from the items[].id of GET /v1/recruiter/projects. */
                     project_id: string;
                 };
                 cookie?: never;
@@ -8970,6 +9007,7 @@ interface paths {
         get: {
             parameters: {
                 query: {
+                    /** @description The Curviate account ID whose Recruiter session performs this call. */
                     account_id: string;
                     /** @description Filter by job posting status. One of: active, draft, closed. Defaults to active. */
                     category?: "active" | "draft" | "closed";
@@ -9693,6 +9731,7 @@ interface paths {
                         email_address?: string;
                         /**
                          * @description Visibility of the recruiter chat. Defaults to PRIVATE.
+                         * @default PRIVATE
                          * @enum {string}
                          */
                         visibility?: "PUBLIC" | "PRIVATE" | "PROJECT";
@@ -10230,6 +10269,7 @@ interface paths {
                 query?: never;
                 header?: never;
                 path: {
+                    /** @description The member id in AEM… format. Obtain it from the `id` field of a POST /v1/recruiter/search/people result item. */
                     user_id: string;
                 };
                 cookie?: never;
@@ -10404,6 +10444,7 @@ interface paths {
                 query?: never;
                 header?: never;
                 path: {
+                    /** @description The job posting draft ID, returned as job_id in the POST /v1/recruiter/jobs response. */
                     job_id: string;
                 };
                 cookie?: never;
@@ -10589,15 +10630,6 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description PLATFORM_NOT_IMPLEMENTED — this operation is not available on the current platform tier. */
-                501: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
                 /** @description PLATFORM_ERROR — A temporary error occurred. Please try again. */
                 502: {
                     headers: {
@@ -10651,6 +10683,7 @@ interface paths {
                 query?: never;
                 header?: never;
                 path: {
+                    /** @description The job posting ID whose pending publish checkpoint is being solved. */
                     job_id: string;
                 };
                 cookie?: never;
@@ -10769,15 +10802,6 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description PLATFORM_NOT_IMPLEMENTED — this operation is not available on the current platform tier. */
-                501: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
                 /** @description PLATFORM_ERROR — A temporary error occurred. Please try again. */
                 502: {
                     headers: {
@@ -10916,15 +10940,6 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description The real adapter for this endpoint is not yet wired. */
-                501: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
                 /** @description The platform returned an error. */
                 502: {
                     headers: {
@@ -11160,15 +11175,6 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description The real adapter for this endpoint is not yet wired. */
-                501: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
                 /** @description The platform returned an error. */
                 502: {
                     headers: {
@@ -11251,6 +11257,7 @@ interface paths {
                 };
                 header?: never;
                 path: {
+                    /** @description The job posting ID whose applicants to list. Obtain it from GET /v1/recruiter/jobs. */
                     job_id: string;
                 };
                 cookie?: never;
@@ -11421,15 +11428,6 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description The real adapter for this endpoint is not yet wired. */
-                501: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
                 /** @description The platform returned an error. */
                 502: {
                     headers: {
@@ -12121,10 +12119,16 @@ interface paths {
                         annual_revenue?: {
                             /** @description ISO 4217 three-character currency code (e.g. 'USD'). */
                             currency: string;
-                            /** @description Minimum revenue in the given currency. */
-                            min: number;
-                            /** @description Maximum revenue. Use 1001 for '1000+' (open-ended upper bound). */
-                            max: number;
+                            /**
+                             * @description Minimum revenue bucket. One of the enumerated values; 1001 means '1000+'.
+                             * @enum {number}
+                             */
+                            min: 0 | 0.2 | 1 | 2.5 | 5 | 10 | 20 | 50 | 100 | 500 | 1000 | 1001;
+                            /**
+                             * @description Maximum revenue bucket. Use 1001 for '1000+' (open-ended upper bound).
+                             * @enum {number}
+                             */
+                            max: 0 | 0.2 | 1 | 2.5 | 5 | 10 | 20 | 50 | 100 | 500 | 1000 | 1001;
                         };
                         /** @description Connection distance: 1 (1st), 2 (2nd), 3 (3rd+). No GROUP value for companies. */
                         network_distance?: (1 | 2 | 3)[];
@@ -13244,7 +13248,7 @@ interface paths {
                         network_distance?: (1 | 2 | 3)[];
                         /** @description Filter by profile language codes. */
                         profile_language?: string[];
-                        /** @description Filter by open-to opportunity types. */
+                        /** @description Filter by open-to opportunity types. Valid values: proBono, boardMember. */
                         open_to?: string[];
                     };
                 };
@@ -13473,7 +13477,7 @@ interface paths {
                 query: {
                     /** @description The linked LinkedIn account to search on behalf of. */
                     account_id: string;
-                    /** @description Maximum results per page (1–50, default 10). */
+                    /** @description Maximum results per page (2–50, default 10). Company search requires a minimum of 2. */
                     limit?: number;
                     /** @description Opaque pagination cursor returned from a previous response. */
                     cursor?: string;
@@ -14030,9 +14034,9 @@ interface paths {
                              */
                             value: 20 | 30 | 40 | 50 | 60 | 70 | 80 | 90 | 100;
                         };
-                        /** @description Filter by offered benefits. */
+                        /** @description Filter by offered benefits. Valid values: medical_insurance, vision_insurance, dental_insurance, 401(k), pension_plan, commuter_benefits. */
                         benefits?: string[];
-                        /** @description Filter by company commitments. */
+                        /** @description Filter by company commitments. Valid values: career_growth_and_learning, diversity_equity_and_inclusion, environmental_sustainability, social_impact, work_life_balance. */
                         commitments?: string[];
                         /** @description Filter to jobs with LinkedIn verification badges. */
                         has_verifications?: boolean;
@@ -14334,21 +14338,31 @@ interface paths {
                         name?: string;
                         /**
                          * @description Delivery body encoding (default: json)
+                         * @default json
                          * @enum {string}
                          */
                         format?: "json" | "form";
                         /** @description Per-account targeting. Required and non-empty — each id must be an acc_-prefixed id owned by the tenant. */
                         account_ids: string[];
-                        /** @description A disabled webhook is created but delivers nothing */
+                        /**
+                         * @description A disabled webhook is created but delivers nothing
+                         * @default true
+                         */
                         enabled?: boolean;
-                        /** @description Custom headers added to each delivery POST */
+                        /**
+                         * @description Custom headers added to each delivery POST
+                         * @default []
+                         */
                         headers?: {
                             key: string;
                             value: string;
                         }[];
                         /** @description Messaging events to subscribe to (default: [message.received]) */
                         events?: ("message.received" | "message.delivered" | "message.read" | "message.reaction" | "message.edited" | "message.deleted")[];
-                        /** @description Field-remapping keys for the messaging delivery payload */
+                        /**
+                         * @description Field-remapping keys for the messaging delivery payload
+                         * @default []
+                         */
                         data?: string[];
                     } | {
                         /** @constant */
@@ -14359,21 +14373,31 @@ interface paths {
                         name?: string;
                         /**
                          * @description Delivery body encoding (default: json)
+                         * @default json
                          * @enum {string}
                          */
                         format?: "json" | "form";
                         /** @description Per-account targeting. Required and non-empty — each id must be an acc_-prefixed id owned by the tenant. */
                         account_ids: string[];
-                        /** @description A disabled webhook is created but delivers nothing */
+                        /**
+                         * @description A disabled webhook is created but delivers nothing
+                         * @default true
+                         */
                         enabled?: boolean;
-                        /** @description Custom headers added to each delivery POST */
+                        /**
+                         * @description Custom headers added to each delivery POST
+                         * @default []
+                         */
                         headers?: {
                             key: string;
                             value: string;
                         }[];
                         /** @description User/relation events to subscribe to (default: [connection.accepted]) */
                         events?: "connection.accepted"[];
-                        /** @description Field-remapping keys for the user/relation delivery payload */
+                        /**
+                         * @description Field-remapping keys for the user/relation delivery payload
+                         * @default []
+                         */
                         data?: ("user_provider_id" | "user_full_name" | "user_public_identifier" | "user_profile_url" | "user_picture_url")[];
                     } | {
                         /** @constant */
@@ -14384,14 +14408,21 @@ interface paths {
                         name?: string;
                         /**
                          * @description Delivery body encoding (default: json)
+                         * @default json
                          * @enum {string}
                          */
                         format?: "json" | "form";
                         /** @description Per-account targeting. Required and non-empty — each id must be an acc_-prefixed id owned by the tenant. */
                         account_ids: string[];
-                        /** @description A disabled webhook is created but delivers nothing */
+                        /**
+                         * @description A disabled webhook is created but delivers nothing
+                         * @default true
+                         */
                         enabled?: boolean;
-                        /** @description Custom headers added to each delivery POST */
+                        /**
+                         * @description Custom headers added to each delivery POST
+                         * @default []
+                         */
                         headers?: {
                             key: string;
                             value: string;
@@ -15050,6 +15081,11 @@ declare class AccountsResource {
     /**
      * List the tenant's connected LinkedIn accounts, cursor-paginated.
      *
+     * Each item also carries a small set of cached account-detail fields
+     * (`username`, `premium_id`, `public_identifier`, `substrate_created_at`,
+     * `signatures`, `groups`) populated by an async background enrichment —
+     * `null`/`[]` until the account's first enrichment pass completes.
+     *
      * @param params - optional `limit` (1–250) and `cursor` (from a prior page).
      * @returns a page of accounts and the next-page `cursor` (null when exhausted).
      *
@@ -15080,7 +15116,14 @@ declare class AccountsResource {
     createConnectLink(body: AccountConnectLinkBody): Promise<AccountConnectLinkResult>;
     /**
      * Return metadata and current state for one connected account, including the
-     * central `quotas[]` view for all tracked quota families.
+     * central `quotas[]` view for all tracked quota families and `seat_id` (the
+     * seat this account occupies, `null` for an admin seatless account).
+     *
+     * This is a stale-while-revalidate read — it always returns immediately
+     * from the cached row (never blocks on a live substrate call), and the
+     * six cached enrichment fields (`username`, `premium_id`,
+     * `public_identifier`, `substrate_created_at`, `signatures`, `groups`) are
+     * `null`/`[]` until the account's first enrichment pass completes.
      */
     get(accountId: string): Promise<AccountDetail>;
     /**

package/dist/index.js

@@ -308,6 +308,11 @@ var AccountsResource = class {
   /**
    * List the tenant's connected LinkedIn accounts, cursor-paginated.
    *
+   * Each item also carries a small set of cached account-detail fields
+   * (`username`, `premium_id`, `public_identifier`, `substrate_created_at`,
+   * `signatures`, `groups`) populated by an async background enrichment —
+   * `null`/`[]` until the account's first enrichment pass completes.
+   *
    * @param params - optional `limit` (1–250) and `cursor` (from a prior page).
    * @returns a page of accounts and the next-page `cursor` (null when exhausted).
    *
@@ -368,7 +373,14 @@ var AccountsResource = class {
   }
   /**
    * Return metadata and current state for one connected account, including the
-   * central `quotas[]` view for all tracked quota families.
+   * central `quotas[]` view for all tracked quota families and `seat_id` (the
+   * seat this account occupies, `null` for an admin seatless account).
+   *
+   * This is a stale-while-revalidate read — it always returns immediately
+   * from the cached row (never blocks on a live substrate call), and the
+   * six cached enrichment fields (`username`, `premium_id`,
+   * `public_identifier`, `substrate_created_at`, `signatures`, `groups`) are
+   * `null`/`[]` until the account's first enrichment pass completes.
    */
   get(accountId) {
     return this.ctx.request({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curviate/sdk",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "private": false,
   "description": "TypeScript SDK for the Curviate API.",
   "license": "MIT",

package/src/generated/types.ts

@@ -55,8 +55,23 @@ export interface paths {
                                 headline?: string | null;
                                 /** @description The seat this account occupies. */
                                 seat_id?: string | null;
-                                /** @description ISO-8601 connection timestamp. */
-                                connected_at?: string;
+                                /** @description ISO-8601 UTC connection timestamp. */
+                                connected_at?: string | null;
+                                /** @description Cached account username. Null until enriched. */
+                                username?: string | null;
+                                /** @description Cached premium-membership id. Null until enriched, or for non-premium accounts. */
+                                premium_id?: string | null;
+                                /** @description Cached public profile identifier. Null until enriched. */
+                                public_identifier?: string | null;
+                                /** @description ISO-8601 UTC creation timestamp of the underlying LinkedIn account — distinct from connected_at. Null until enriched. */
+                                substrate_created_at?: string | null;
+                                /** @description Cached signature blocks (title + content) for the account. Empty until enriched. */
+                                signatures?: {
+                                    title?: string;
+                                    content?: string;
+                                }[];
+                                /** @description Cached group names the account belongs to. Empty until enriched. */
+                                groups?: string[];
                             }[];
                             /** @description Next-page cursor; null on the last page. */
                             cursor?: string | null;
@@ -399,9 +414,28 @@ export interface paths {
                             auth_method?: string;
                             full_name?: string | null;
                             headline?: string | null;
+                            /** @description ISO-8601 UTC connection timestamp. */
                             connected_at?: string | null;
+                            /** @description ISO-8601 UTC time the account state was last checked. */
                             last_checked_at?: string;
-                            /** @description Per-account quota view — one entry per tracked family (messages.daily, connection_requests.daily, profile_views.daily, inmail.daily, account.per_minute). */
+                            /** @description The seat this account occupies (null for an admin seatless account). */
+                            seat_id?: string | null;
+                            /** @description Cached account username. Null until enriched. */
+                            username?: string | null;
+                            /** @description Cached premium-membership id. Null until enriched, or for non-premium accounts. */
+                            premium_id?: string | null;
+                            /** @description Cached public profile identifier. Null until enriched. */
+                            public_identifier?: string | null;
+                            /** @description ISO-8601 UTC creation timestamp of the underlying LinkedIn account — distinct from connected_at. Null until enriched. */
+                            substrate_created_at?: string | null;
+                            /** @description Cached signature blocks (title + content) for the account. Empty until enriched. */
+                            signatures?: {
+                                title?: string;
+                                content?: string;
+                            }[];
+                            /** @description Cached group names the account belongs to. Empty until enriched. */
+                            groups?: string[];
+                            /** @description Usage-safety recommendations for this account — one entry per tracked family (messages.daily, connection_requests.daily, profile_views.daily, inmail.daily, profile.endorse, account.per_minute). These are advisory only: Curviate never rejects a request because a daily recommendation is exceeded; only account.per_minute is a binding limit enforced with HTTP 429. */
                             quotas?: {
                                 /** @description Quota family (e.g. messages.daily, account.per_minute). */
                                 quota_name?: string;
@@ -412,7 +446,7 @@ export interface paths {
                                 /** @description ISO-8601 UTC time the current window resets. */
                                 reset_time?: string;
                                 /**
-                                 * @description Pacing hint.
+                                 * @description Pacing recommendation for this family, advisory only. `none` (under 80% consumed), `slow_down` (80-99% consumed), and `backoff` (100%+ consumed) never block a request. `stop` is reserved exclusively for `account.per_minute` — the sole binding limit, whose breach is enforced with HTTP 429.
                                  * @enum {string}
                                  */
                                 recommended_throttle_hint?: "none" | "slow_down" | "backoff" | "stop";
@@ -745,10 +779,14 @@ export interface paths {
                         account_id?: string;
                         /**
                          * @description 'create' = new account onboarding; 'reconnect' = re-auth of existing account
+                         * @default create
                          * @enum {string}
                          */
                         purpose?: "create" | "reconnect";
-                        /** @description Seconds until the link expires (60–3600, default 900) */
+                        /**
+                         * @description Seconds until the link expires (60–3600, default 900)
+                         * @default 900
+                         */
                         expires_in_seconds?: number;
                         /** @description Optional browser return URL after the hosted flow. No credential material. */
                         redirect_url?: string;
@@ -7513,6 +7551,7 @@ export interface paths {
                 };
                 header?: never;
                 path: {
+                    /** @description The target profile's public identifier (vanity slug), member ID, or URN. */
                     identifier: string;
                 };
                 cookie?: never;
@@ -7673,15 +7712,6 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Not implemented — the Recruiter profile endpoint is not available on this account configuration. */
-                501: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
                 /** @description PLATFORM_ERROR — A temporary error occurred. Please try again. */
                 502: {
                     headers: {
@@ -7763,12 +7793,12 @@ export interface paths {
                         saved_search?: {
                             /** @description Saved search ID. Resolve via search/parameters?type=SAVED_SEARCHES. */
                             id: string;
-                            /** @description Project ID the saved search belongs to. Resolve via search/parameters?type=HIRING_PROJECTS. */
+                            /** @description Project ID the saved search belongs to. Resolve via search/parameters?type=SAVED_SEARCHES. */
                             project_id: string;
                             /** @description When true, returns only results new since the search was last run. */
                             newest_results_only?: boolean;
                         };
-                        /** @description INDUSTRY IDs to include or exclude. Resolve via search/parameters?type=DEPARTMENT. */
+                        /** @description INDUSTRY IDs to include or exclude. Resolve via search/parameters?type=INDUSTRY. */
                         industry?: {
                             /** @description Filter IDs to include. */
                             include?: string[];
@@ -8407,10 +8437,15 @@ export interface paths {
         get: {
             parameters: {
                 query: {
+                    /** @description The Curviate account ID whose Recruiter session lists hiring projects. */
                     account_id: string;
+                    /** @description Maximum number of hiring projects to return (1–100). Defaults to 10. */
                     limit?: number;
+                    /** @description Opaque pagination cursor from a previous response. Omit for the first page. */
                     cursor?: string;
+                    /** @description Field to sort hiring projects by. Defaults to ACCESSED_TIME. */
                     sort_by?: "NAME" | "FAVORITE" | "CREATED_TIME" | "ACCESSED_TIME" | "ENGAGED_TIME" | "ENGAGEMENT_COUNT";
+                    /** @description Sort direction. Defaults to DESCENDING. */
                     sort_order?: "ASCENDING" | "DESCENDING";
                 };
                 header?: never;
@@ -8641,10 +8676,12 @@ export interface paths {
         get: {
             parameters: {
                 query: {
+                    /** @description The Curviate account ID whose Recruiter session performs this call. */
                     account_id: string;
                 };
                 header?: never;
                 path: {
+                    /** @description The hiring project ID. Obtain it from the items[].id of GET /v1/recruiter/projects. */
                     project_id: string;
                 };
                 cookie?: never;
@@ -8861,6 +8898,7 @@ export interface paths {
         get: {
             parameters: {
                 query: {
+                    /** @description The Curviate account ID whose Recruiter session performs this call. */
                     account_id: string;
                     /** @description Filter by job posting status. One of: active, draft, closed. Defaults to active. */
                     category?: "active" | "draft" | "closed";
@@ -9584,6 +9622,7 @@ export interface paths {
                         email_address?: string;
                         /**
                          * @description Visibility of the recruiter chat. Defaults to PRIVATE.
+                         * @default PRIVATE
                          * @enum {string}
                          */
                         visibility?: "PUBLIC" | "PRIVATE" | "PROJECT";
@@ -10121,6 +10160,7 @@ export interface paths {
                 query?: never;
                 header?: never;
                 path: {
+                    /** @description The member id in AEM… format. Obtain it from the `id` field of a POST /v1/recruiter/search/people result item. */
                     user_id: string;
                 };
                 cookie?: never;
@@ -10295,6 +10335,7 @@ export interface paths {
                 query?: never;
                 header?: never;
                 path: {
+                    /** @description The job posting draft ID, returned as job_id in the POST /v1/recruiter/jobs response. */
                     job_id: string;
                 };
                 cookie?: never;
@@ -10480,15 +10521,6 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description PLATFORM_NOT_IMPLEMENTED — this operation is not available on the current platform tier. */
-                501: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
                 /** @description PLATFORM_ERROR — A temporary error occurred. Please try again. */
                 502: {
                     headers: {
@@ -10542,6 +10574,7 @@ export interface paths {
                 query?: never;
                 header?: never;
                 path: {
+                    /** @description The job posting ID whose pending publish checkpoint is being solved. */
                     job_id: string;
                 };
                 cookie?: never;
@@ -10660,15 +10693,6 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description PLATFORM_NOT_IMPLEMENTED — this operation is not available on the current platform tier. */
-                501: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
                 /** @description PLATFORM_ERROR — A temporary error occurred. Please try again. */
                 502: {
                     headers: {
@@ -10807,15 +10831,6 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description The real adapter for this endpoint is not yet wired. */
-                501: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
                 /** @description The platform returned an error. */
                 502: {
                     headers: {
@@ -11051,15 +11066,6 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description The real adapter for this endpoint is not yet wired. */
-                501: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
                 /** @description The platform returned an error. */
                 502: {
                     headers: {
@@ -11142,6 +11148,7 @@ export interface paths {
                 };
                 header?: never;
                 path: {
+                    /** @description The job posting ID whose applicants to list. Obtain it from GET /v1/recruiter/jobs. */
                     job_id: string;
                 };
                 cookie?: never;
@@ -11312,15 +11319,6 @@ export interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description The real adapter for this endpoint is not yet wired. */
-                501: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
                 /** @description The platform returned an error. */
                 502: {
                     headers: {
@@ -12012,10 +12010,16 @@ export interface paths {
                         annual_revenue?: {
                             /** @description ISO 4217 three-character currency code (e.g. 'USD'). */
                             currency: string;
-                            /** @description Minimum revenue in the given currency. */
-                            min: number;
-                            /** @description Maximum revenue. Use 1001 for '1000+' (open-ended upper bound). */
-                            max: number;
+                            /**
+                             * @description Minimum revenue bucket. One of the enumerated values; 1001 means '1000+'.
+                             * @enum {number}
+                             */
+                            min: 0 | 0.2 | 1 | 2.5 | 5 | 10 | 20 | 50 | 100 | 500 | 1000 | 1001;
+                            /**
+                             * @description Maximum revenue bucket. Use 1001 for '1000+' (open-ended upper bound).
+                             * @enum {number}
+                             */
+                            max: 0 | 0.2 | 1 | 2.5 | 5 | 10 | 20 | 50 | 100 | 500 | 1000 | 1001;
                         };
                         /** @description Connection distance: 1 (1st), 2 (2nd), 3 (3rd+). No GROUP value for companies. */
                         network_distance?: (1 | 2 | 3)[];
@@ -13135,7 +13139,7 @@ export interface paths {
                         network_distance?: (1 | 2 | 3)[];
                         /** @description Filter by profile language codes. */
                         profile_language?: string[];
-                        /** @description Filter by open-to opportunity types. */
+                        /** @description Filter by open-to opportunity types. Valid values: proBono, boardMember. */
                         open_to?: string[];
                     };
                 };
@@ -13364,7 +13368,7 @@ export interface paths {
                 query: {
                     /** @description The linked LinkedIn account to search on behalf of. */
                     account_id: string;
-                    /** @description Maximum results per page (1–50, default 10). */
+                    /** @description Maximum results per page (2–50, default 10). Company search requires a minimum of 2. */
                     limit?: number;
                     /** @description Opaque pagination cursor returned from a previous response. */
                     cursor?: string;
@@ -13921,9 +13925,9 @@ export interface paths {
                              */
                             value: 20 | 30 | 40 | 50 | 60 | 70 | 80 | 90 | 100;
                         };
-                        /** @description Filter by offered benefits. */
+                        /** @description Filter by offered benefits. Valid values: medical_insurance, vision_insurance, dental_insurance, 401(k), pension_plan, commuter_benefits. */
                         benefits?: string[];
-                        /** @description Filter by company commitments. */
+                        /** @description Filter by company commitments. Valid values: career_growth_and_learning, diversity_equity_and_inclusion, environmental_sustainability, social_impact, work_life_balance. */
                         commitments?: string[];
                         /** @description Filter to jobs with LinkedIn verification badges. */
                         has_verifications?: boolean;
@@ -14225,21 +14229,31 @@ export interface paths {
                         name?: string;
                         /**
                          * @description Delivery body encoding (default: json)
+                         * @default json
                          * @enum {string}
                          */
                         format?: "json" | "form";
                         /** @description Per-account targeting. Required and non-empty — each id must be an acc_-prefixed id owned by the tenant. */
                         account_ids: string[];
-                        /** @description A disabled webhook is created but delivers nothing */
+                        /**
+                         * @description A disabled webhook is created but delivers nothing
+                         * @default true
+                         */
                         enabled?: boolean;
-                        /** @description Custom headers added to each delivery POST */
+                        /**
+                         * @description Custom headers added to each delivery POST
+                         * @default []
+                         */
                         headers?: {
                             key: string;
                             value: string;
                         }[];
                         /** @description Messaging events to subscribe to (default: [message.received]) */
                         events?: ("message.received" | "message.delivered" | "message.read" | "message.reaction" | "message.edited" | "message.deleted")[];
-                        /** @description Field-remapping keys for the messaging delivery payload */
+                        /**
+                         * @description Field-remapping keys for the messaging delivery payload
+                         * @default []
+                         */
                         data?: string[];
                     } | {
                         /** @constant */
@@ -14250,21 +14264,31 @@ export interface paths {
                         name?: string;
                         /**
                          * @description Delivery body encoding (default: json)
+                         * @default json
                          * @enum {string}
                          */
                         format?: "json" | "form";
                         /** @description Per-account targeting. Required and non-empty — each id must be an acc_-prefixed id owned by the tenant. */
                         account_ids: string[];
-                        /** @description A disabled webhook is created but delivers nothing */
+                        /**
+                         * @description A disabled webhook is created but delivers nothing
+                         * @default true
+                         */
                         enabled?: boolean;
-                        /** @description Custom headers added to each delivery POST */
+                        /**
+                         * @description Custom headers added to each delivery POST
+                         * @default []
+                         */
                         headers?: {
                             key: string;
                             value: string;
                         }[];
                         /** @description User/relation events to subscribe to (default: [connection.accepted]) */
                         events?: "connection.accepted"[];
-                        /** @description Field-remapping keys for the user/relation delivery payload */
+                        /**
+                         * @description Field-remapping keys for the user/relation delivery payload
+                         * @default []
+                         */
                         data?: ("user_provider_id" | "user_full_name" | "user_public_identifier" | "user_profile_url" | "user_picture_url")[];
                     } | {
                         /** @constant */
@@ -14275,14 +14299,21 @@ export interface paths {
                         name?: string;
                         /**
                          * @description Delivery body encoding (default: json)
+                         * @default json
                          * @enum {string}
                          */
                         format?: "json" | "form";
                         /** @description Per-account targeting. Required and non-empty — each id must be an acc_-prefixed id owned by the tenant. */
                         account_ids: string[];
-                        /** @description A disabled webhook is created but delivers nothing */
+                        /**
+                         * @description A disabled webhook is created but delivers nothing
+                         * @default true
+                         */
                         enabled?: boolean;
-                        /** @description Custom headers added to each delivery POST */
+                        /**
+                         * @description Custom headers added to each delivery POST
+                         * @default []
+                         */
                         headers?: {
                             key: string;
                             value: string;