@lovable.dev/sdk 1.6.1 → 1.7.0

package/dist/index.d.ts

@@ -2054,7 +2054,7 @@ interface paths {
     put?: never;
     /**
      * Export workspace messages (Preview)
-     * @description Allows workspace admins and owners to start a one-off export of user-authored messages from projects visible to them. Project and user filters may be combined; when both are supplied, only messages matching both are exported. The warehouse-backed snapshot can lag by up to 26 hours, defaults to the preceding 90 days, and is delivered as a ZIP containing JSONL. Poll the returned export ID; completed files expire after seven days. Filter options and delivery metadata may change before graduation.
+     * @description Allows workspace admins and owners to start a one-off export of user-authored messages from the current main chat history of projects visible to them. Project and user filters may be combined; when both are supplied, only messages matching both are exported. The export defaults to the preceding 90 days and is delivered as a ZIP containing JSONL. Poll the returned export ID; completed files expire after seven days. Filter options and delivery metadata may change before graduation.
      *
      *     This operation is in public preview (beta) and served under `/v1beta`. Request and response shapes may change before it graduates to the stable `/v1` surface.
      */
@@ -2122,9 +2122,25 @@ interface components {
        */
       who_can_create: "editors_and_admins" | "admins_only";
     };
-    CommonSeamlessConnectorCreator: {
-      name: string;
-      url: string;
+    ChannelAnalytics: {
+      lists: components["schemas"]["ChannelListsGroup"];
+      timeSeries: components["schemas"]["ChannelTimeSeriesGroup"];
+    };
+    ChannelListsGroup: {
+      page: components["schemas"]["ListData"];
+      source: components["schemas"]["ListData"];
+    };
+    ChannelTimeSeriesGroup: {
+      /** @description Bounced sessions divided by sessions, as a percentage. Legacy bounces have identical first and last page-view times; user_app_events bounces have fewer than two views and under ten seconds engagement. */
+      bounceRate: components["schemas"]["TimeSeriesData"];
+      /** @description Page views from sessions attributed to this channel. */
+      pageviews: components["schemas"]["TimeSeriesData"];
+      /** @description Page views divided by bucket session counts. */
+      pageviewsPerVisit: components["schemas"]["TimeSeriesData"];
+      /** @description Mean session seconds per bucket, weighted by bucket session counts for the total. Legacy uses first-to-last page view; user_app_events uses measured engagement with first-to-last fallback. */
+      sessionDuration: components["schemas"]["TimeSeriesData"];
+      /** @description Unique sessions active per bucket. The total sums bucket counts, matching the unfiltered analytics total. */
+      visitors: components["schemas"]["TimeSeriesData"];
     };
     CommonSeamlessConnectorFeature: {
       body?: string;
@@ -2139,44 +2155,69 @@ interface components {
       is_primary?: boolean;
       name: string;
     };
-    Creator: {
+    CompanyCreator: {
+      logo_url?: string;
       name: string;
+      /**
+       * @description discriminator enum property added by openapi-typescript
+       * @enum {string}
+       */
+      type: "company";
       url: string;
     };
+    Creator: components["schemas"]["LovableCreator"] | components["schemas"]["UserCreator"] | components["schemas"]["CompanyCreator"];
     CursorListResponseProjectPIIFindingDTO: {
+      /** @description Items in this page. */
       data: components["schemas"]["ProjectPIIFindingDTO"][] | null;
+      /** @description Pagination cursors for fetching adjacent pages. */
       pagination: components["schemas"]["Pagination"];
     };
     CursorListResponsePublicV1ConnectorItem: {
+      /** @description Items in this page. */
       data: components["schemas"]["PublicV1ConnectorItem"][] | null;
+      /** @description Pagination cursors for fetching adjacent pages. */
       pagination: components["schemas"]["Pagination"];
     };
     CursorListResponsePublicV1ProjectListItem: {
+      /** @description Items in this page. */
       data: components["schemas"]["PublicV1ProjectListItem"][] | null;
+      /** @description Pagination cursors for fetching adjacent pages. */
       pagination: components["schemas"]["Pagination"];
     };
     CursorListResponseV1EditSummary: {
+      /** @description Items in this page. */
       data: components["schemas"]["V1EditSummary"][] | null;
+      /** @description Pagination cursors for fetching adjacent pages. */
       pagination: components["schemas"]["Pagination"];
     };
     CursorListResponseV1MessageListItem: {
+      /** @description Items in this page. */
       data: components["schemas"]["V1MessageListItem"][] | null;
+      /** @description Pagination cursors for fetching adjacent pages. */
       pagination: components["schemas"]["Pagination"];
     };
     CursorListResponseV1ProjectCollaborator: {
+      /** @description Items in this page. */
       data: components["schemas"]["V1ProjectCollaborator"][] | null;
+      /** @description Pagination cursors for fetching adjacent pages. */
       pagination: components["schemas"]["Pagination"];
     };
     CursorListResponseV1ProjectSkillDTO: {
+      /** @description Items in this page. */
       data: components["schemas"]["V1ProjectSkillDTO"][] | null;
+      /** @description Pagination cursors for fetching adjacent pages. */
       pagination: components["schemas"]["Pagination"];
     };
     CursorListResponseV1SecurityScanSummary: {
+      /** @description Items in this page. */
       data: components["schemas"]["V1SecurityScanSummary"][] | null;
+      /** @description Pagination cursors for fetching adjacent pages. */
       pagination: components["schemas"]["Pagination"];
     };
     CursorListResponseV1WorkspaceMember: {
+      /** @description Items in this page. */
       data: components["schemas"]["V1WorkspaceMember"][] | null;
+      /** @description Pagination cursors for fetching adjacent pages. */
       pagination: components["schemas"]["Pagination"];
     };
     DiffHunk: {
@@ -2252,21 +2293,39 @@ interface components {
       total: number;
     };
     GetMeOutputBody: {
-      /** @description User email address */
+      /**
+       * @description User email address
+       * @example jane.cooper@acme.com
+       */
       email: string;
-      /** @description User ID */
+      /**
+       * @description User ID
+       * @example Xy7Kd2Lm9Qp4Rt6Vw8Zc1Bn3Fh5
+       */
       id: string;
-      /** @description User display name */
+      /**
+       * @description User display name
+       * @example Jane Cooper
+       */
       name: string;
       /** @description Workspaces the user belongs to */
       workspaces: components["schemas"]["GetMeWorkspace"][] | null;
     };
     GetMeWorkspace: {
-      /** @description Workspace ID */
+      /**
+       * @description Workspace ID
+       * @example workspace_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       id: string;
-      /** @description Workspace display name */
+      /**
+       * @description Workspace display name
+       * @example Acme Inc
+       */
       name: string;
-      /** @description Caller's role in the workspace. One of: owner, admin, member, viewer, collaborator. More values may be added; clients must tolerate unknown values. */
+      /**
+       * @description Caller's role in the workspace. One of: owner, admin, member, viewer, collaborator. More values may be added; clients must tolerate unknown values.
+       * @example admin
+       */
       role: string;
     };
     GitFileEntry: {
@@ -2294,20 +2353,46 @@ interface components {
       updated_at: string;
     };
     ListData: {
+      /** @description Ranked items in this breakdown. */
       data: components["schemas"]["ListDataPoint"][] | null;
+      /**
+       * @description Human-readable name of this breakdown dimension.
+       * @example Top Pages
+       */
       label: string;
     };
     ListDataPoint: {
+      /**
+       * @description Name of this item within the breakdown.
+       * @example /pricing
+       */
       label: string;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Count of visits or events attributed to this item.
+       * @example 1280
+       */
       value: number;
     };
     ListsGroup: {
+      /** @description Breakdown of traffic by visitor country. */
       country: components["schemas"]["ListData"];
+      /** @description Breakdown of traffic by device type. */
       device: components["schemas"]["ListData"];
+      /** @description Breakdown of traffic by top page. */
       page: components["schemas"]["ListData"];
+      /** @description Breakdown of traffic by referral source. */
       source: components["schemas"]["ListData"];
     };
+    LovableCreator: {
+      name: string;
+      /**
+       * @description discriminator enum property added by openapi-typescript
+       * @enum {string}
+       */
+      type: "lovable";
+      url: string;
+    };
     MCPConnector: {
       app_mcp_auth_method?: string;
       app_mcp_project_id?: string;
@@ -2319,7 +2404,7 @@ interface components {
       connect_interaction?: "desktop_app_download";
       connection_id?: string;
       connector_id?: string;
-      creator: components["schemas"]["MCPConnectorCreatorStruct"];
+      creator: components["schemas"]["Creator"];
       custom_url_hint?: string;
       display_name: string;
       documentation_url?: string;
@@ -2344,17 +2429,25 @@ interface components {
       url?: string;
       url_placeholder?: string;
     };
-    MCPConnectorCreatorStruct: {
-      name: string;
-      url: string;
-    };
     Pagination: {
-      /** @description Whether more results are available beyond this page */
+      /**
+       * @description Whether more results are available beyond this page
+       * @example true
+       */
       has_more: boolean;
-      /** @description Cursor for the next page; null when there are no more results */
+      /**
+       * @description Cursor for the next page; null when there are no more results
+       * @example eyJ2IjoxLCJpZCI6InByal8wMWp3M2s5In0
+       */
       next_cursor: string | null;
     };
     ProjectAnalyticsResponse: {
+      /** @description Sessions attributed to their first eligible page view within the requested window. Includes search_ai as the union of search and ai; do not sum it with those channels. */
+      channels?: {
+        [key: string]: components["schemas"]["ChannelAnalytics"];
+      };
+      /** @enum {string} */
+      channelsSource?: "legacy" | "user_app_events";
       lists: components["schemas"]["ListsGroup"];
       timeSeries: components["schemas"]["TimeSeriesGroup"];
     };
@@ -2367,7 +2460,10 @@ interface components {
       sizeExceeded: boolean;
     };
     ProjectPIIFindingDTO: {
-      /** @description Trajectory event ID for chat-source labels */
+      /**
+       * @description Trajectory event ID for chat-source labels
+       * @example default:user#12#01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       chat_message_id?: string;
       /** @description Uploaded file ID for upload-source labels */
       chat_upload_id?: string;
@@ -2376,32 +2472,62 @@ interface components {
       /**
        * Format: date-time
        * @description When the label was recorded
+       * @example 2026-01-15T09:30:00Z
        */
       found_at: string;
-      /** @description PII label ID */
+      /**
+       * @description PII label ID
+       * @example pii_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       id: string;
-      /** @description DLP info type, such as EMAIL_ADDRESS */
+      /**
+       * @description DLP info type, such as EMAIL_ADDRESS
+       * @example EMAIL_ADDRESS
+       */
       info_type?: string;
-      /** @description DLP likelihood: VERY_UNLIKELY, UNLIKELY, POSSIBLE, LIKELY, or VERY_LIKELY */
+      /**
+       * @description DLP likelihood: VERY_UNLIKELY, UNLIKELY, POSSIBLE, LIKELY, or VERY_LIKELY
+       * @example LIKELY
+       */
       likelihood?: string;
-      /** @description Masked sample of the detected value */
+      /**
+       * @description Masked sample of the detected value
+       * @example j***@acme.com
+       */
       quote?: string;
-      /** @description Workflow scan run ID that recorded the label */
+      /**
+       * @description Workflow scan run ID that recorded the label
+       * @example pii-scan-prj_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       scan_id?: string;
-      /** @description Sensitivity bucket: low, mid, or high */
+      /**
+       * @description Sensitivity bucket: low, mid, or high
+       * @example high
+       */
       sensitivity?: string;
-      /** @description Where the PII was detected: chat, upload, cloud_storage, or cloud_sql */
+      /**
+       * @description Where the PII was detected: chat, upload, cloud_storage, or cloud_sql
+       * @example chat
+       */
       source: string;
       /** @description Database location for cloud_sql labels */
       sql_location?: string;
-      /** @description Label status: open, ignored, or fixed */
+      /**
+       * @description Label status: open, ignored, or fixed
+       * @example open
+       */
       status: string;
       /** @description Cloud storage object path for cloud_storage labels */
       storage_path?: string;
     };
     ProjectTrendResponse: {
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of visitors currently active on the site.
+       * @example 12
+       */
       currentVisitors: number;
+      /** @description Time-ordered visit trend buckets. */
       data: components["schemas"]["TrendDataPoint"][] | null;
     };
     PublicV1ConnectorItem: {
@@ -2435,33 +2561,75 @@ interface components {
       types?: string[];
     };
     PublicV1CreateProjectResponse: {
-      /** @description Description supplied by the caller on create or update */
+      /**
+       * @description Description supplied by the caller on create or update
+       * @example A landing page for Acme with a hero, features, and pricing.
+       */
       description?: string;
-      /** @description Project display name */
+      /**
+       * @description Project display name
+       * @example Acme Landing Page
+       */
       display_name?: string;
-      /** @description Project ID */
+      /**
+       * @description Project ID
+       * @example prj_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       id?: string;
-      /** @description Whether the project is published */
+      /**
+       * @description Whether the project is published
+       * @example true
+       */
       is_published?: boolean;
-      /** @description Remix job ID for tracking progress when source_project_id is provided */
+      /**
+       * @description Remix job ID for tracking progress when source_project_id is provided
+       * @example job_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       job_id?: string;
-      /** @description SHA of the latest commit */
+      /**
+       * @description SHA of the latest commit
+       * @example 9f3c2a1b8d4e5f6a7b8c9d0e1f2a3b4c5d6e7f80
+       */
       latest_commit_sha?: string;
-      /** @description URL of the latest screenshot */
+      /**
+       * @description URL of the latest screenshot
+       * @example https://lovable.dev/cdn/projects/acme-landing-page/screenshot.png
+       */
       latest_screenshot_url?: string;
-      /** @description User message ID, present when initial_message was provided */
+      /**
+       * @description User message ID, present when initial_message was provided
+       * @example msg_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       message_id?: string;
-      /** @description Project slug */
+      /**
+       * @description Project slug
+       * @example acme-landing-page
+       */
       name?: string;
-      /** @description Static-preview URL for the project, on the workspace's branded host when it has one. Resolves once the first build completes. Absent on remix creates, which return job_id before the project exists. */
+      /**
+       * @description Static-preview URL for the project, on the workspace's branded host when it has one. Resolves once the first build completes. Absent on remix creates, which return job_id before the project exists.
+       * @example https://acme-landing-page.lovable.app/
+       */
       preview_url?: string;
-      /** @description Provisioning status of the project, not agent build progress. 'completed' means the project scaffold was created, and is set before the agent has finished the initial message, so the code at that point is often an empty starter page. To check whether the agent finished building, poll GET /v1/messages/{message_id}. One of: in_progress, completed, failed. More values may be added; clients must tolerate unknown values. */
+      /**
+       * @description Provisioning status of the project, not agent build progress. 'completed' means the project scaffold was created, and is set before the agent has finished the initial message, so the code at that point is often an empty starter page. To check whether the agent finished building, poll GET /v1/messages/{message_id}. One of: in_progress, completed, failed. More values may be added; clients must tolerate unknown values.
+       * @example completed
+       */
       status?: string;
-      /** @description Published project URL */
+      /**
+       * @description Published project URL
+       * @example https://acme-landing-page.lovable.app
+       */
       url?: string;
-      /** @description Project visibility: draft, private, workspace_view, public */
+      /**
+       * @description Project visibility: draft, private, workspace_view, public
+       * @example private
+       */
       visibility?: string;
-      /** @description Workspace ID */
+      /**
+       * @description Workspace ID
+       * @example workspace_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       workspace_id?: string;
     };
     PublicV1DeployProjectInputBody: {
@@ -2487,12 +2655,19 @@ interface components {
       ref: string;
     };
     PublicV1PatchProjectBody: {
-      /** @description Project description. Does not affect generated_description, which the agent maintains on its own. */
+      /**
+       * @description Project description. Does not affect generated_description, which the agent maintains on its own.
+       * @example A landing page for my SaaS product with a hero, features, and pricing.
+       */
       description?: string;
-      /** @description Project display name */
+      /**
+       * @description Project display name
+       * @example Acme Landing Page
+       */
       display_name?: string;
       /**
        * @description Project visibility
+       * @example private
        * @enum {string}
        */
       visibility?: "draft" | "private" | "public" | "workspace_view";
@@ -2506,9 +2681,15 @@ interface components {
       trend?: components["schemas"]["ProjectTrendResponse"];
     };
     PublicV1ProjectCreateInputBody: {
-      /** @description Project description */
+      /**
+       * @description Project description
+       * @example A landing page for my SaaS product with a hero, features, and pricing.
+       */
       description: string;
-      /** @description Human-facing project name */
+      /**
+       * @description Human-facing project name
+       * @example Acme Landing Page
+       */
       display_name?: string;
       /**
        * @deprecated
@@ -2522,24 +2703,40 @@ interface components {
        * @description Deprecated (ENT-3330): both create-time file fields are slated for removal in favor of a unified attachment mechanism; use ephemeral_files meanwhile. Pre-uploaded user-scoped file references ("{user_id}/{uuid}/{name}" from the deprecated POST /v1/files/upload-url endpoint), attached in place without copying; requires initial_message.
        */
       files?: components["schemas"]["V1UnscopedFile"][] | null;
-      /** @description Initial chat message to send after creation */
+      /**
+       * @description Initial chat message to send after creation
+       * @example A landing page for my SaaS product with a hero, features, and pricing.
+       */
       initial_message?: string;
-      /** @description Sandbox runtime template for the new project. Omit for the default stack; requires a workspace with access to the requested template. */
+      /**
+       * @description Sandbox runtime template for the new project. Omit for the default stack; requires a workspace with access to the requested template.
+       * @example lovable-on-lovable
+       */
       sandbox_template?: string;
       /** @description Design system library projects to connect to the new project */
       selected_libraries?: components["schemas"]["V1SelectedLibrary"][] | null;
       /** @description Ignored when null, empty, or whitespace. Set a non-empty value to remix from a source project. */
       source_project_id?: string | null;
-      /** @description Technology stack (default: vite) */
+      /**
+       * @description Technology stack (default: vite)
+       * @example vite
+       */
       tech_stack?: string;
-      /** @description Template project ID to clone from (from list_template_projects) */
+      /**
+       * @description Template project ID to clone from (from list_template_projects)
+       * @example prj_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       template_project_id?: string;
       /**
        * @description Project visibility: draft, private, workspace_view, public
+       * @example private
        * @enum {string}
        */
       visibility?: "draft" | "private" | "public" | "workspace_view";
-      /** @description Workspace ID */
+      /**
+       * @description Workspace ID
+       * @example workspace_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       workspace_id: string;
     };
     PublicV1ProjectFileUploadURLInputBody: {
@@ -2552,78 +2749,163 @@ interface components {
       /**
        * Format: date-time
        * @description When the project was created.
+       * @example 2026-01-15T09:30:00Z
        */
       created_at?: string;
-      /** @description Description supplied by the caller on create or update. */
+      /**
+       * @description Description supplied by the caller on create or update.
+       * @example Marketing landing page for Acme's product launch.
+       */
       description?: string;
-      /** @description Human-readable project name. */
+      /**
+       * @description Human-readable project name.
+       * @example Acme Landing Page
+       */
       display_name?: string;
-      /** @description Folder the project belongs to, if any. */
+      /**
+       * @description Folder the project belongs to, if any.
+       * @example fold_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       folder_id?: string;
-      /** @description AI-written summary of what the project does. Absent until the agent has completed a response for the project. */
+      /**
+       * @description AI-written summary of what the project does. Absent until the agent has completed a response for the project.
+       * @example A landing page for Acme with a hero, features, and pricing.
+       */
       generated_description?: string;
-      /** @description Project ID. */
+      /**
+       * @description Project ID.
+       * @example prj_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       id: string;
-      /** @description Whether the project is published. */
+      /**
+       * @description Whether the project is published.
+       * @example true
+       */
       is_published?: boolean;
       /**
        * Format: date-time
        * @description When the project was last edited.
+       * @example 2026-01-15T09:30:00Z
        */
       last_edited_at?: string;
-      /** @description URL of the latest screenshot. */
+      /**
+       * @description URL of the latest screenshot.
+       * @example https://screenshot2.lovable.dev/acme-landing-page.png
+       */
       latest_screenshot_url?: string;
-      /** @description Project slug. */
+      /**
+       * @description Project slug.
+       * @example acme-landing-page
+       */
       name?: string;
-      /** @description Open Graph image URL. */
+      /**
+       * @description Open Graph image URL.
+       * @example https://lovable.dev/cdn/projects/acme-landing-page/og.png
+       */
       og_image_url?: string;
-      /** @description Project type. One of: project, library. Absent on older projects. More values may be added; clients must tolerate unknown values. */
+      /**
+       * @description Project type. One of: project, library. Absent on older projects. More values may be added; clients must tolerate unknown values.
+       * @example project
+       */
       project_type?: string;
-      /** @description Published visibility. One of: public, private. More values may be added; clients must tolerate unknown values. */
+      /**
+       * @description Published visibility. One of: public, private. More values may be added; clients must tolerate unknown values.
+       * @example public
+       */
       publish_visibility?: string;
-      /** @description Provisioning status of the project, not agent build progress. 'completed' means the project scaffold was created, and is set before the agent has finished the initial message, so the code at that point is often an empty starter page. To check whether the agent finished building, poll GET /v1/messages/{message_id}. One of: in_progress, completed, failed. More values may be added; clients must tolerate unknown values. */
+      /**
+       * @description Provisioning status of the project, not agent build progress. 'completed' means the project scaffold was created, and is set before the agent has finished the initial message, so the code at that point is often an empty starter page. To check whether the agent finished building, poll GET /v1/messages/{message_id}. One of: in_progress, completed, failed. More values may be added; clients must tolerate unknown values.
+       * @example completed
+       */
       status?: string;
-      /** @description Project tech stack. */
+      /**
+       * @description Project tech stack.
+       * @example vite_react_shadcn_ts
+       */
       tech_stack?: string;
       /**
        * Format: date-time
        * @description When the project was last updated.
+       * @example 2026-01-15T09:30:00Z
        */
       updated_at?: string;
-      /** @description Published project URL. */
+      /**
+       * @description Published project URL.
+       * @example https://acme-landing-page.lovable.app
+       */
       url?: string;
-      /** @description Project owner user ID. */
+      /**
+       * @description Project owner user ID.
+       * @example Xy7Kd2Lm9Qp4Rt6Vw8Zc1Bn3Fh5
+       */
       user_id?: string;
-      /** @description Project visibility: draft, private, workspace_view, or public. */
+      /**
+       * @description Project visibility: draft, private, workspace_view, or public.
+       * @example public
+       */
       visibility?: string;
-      /** @description Workspace the project belongs to. */
+      /**
+       * @description Workspace the project belongs to.
+       * @example workspace_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       workspace_id: string;
     };
     PublicV1ProjectRemixInputBody: {
-      /** @description Project description */
+      /**
+       * @description Project description
+       * @example A landing page for my SaaS product with a hero, features, and pricing.
+       */
       description?: string;
-      /** @description Human-facing project name */
+      /**
+       * @description Human-facing project name
+       * @example Acme Landing Page
+       */
       display_name?: string;
-      /** @description Whether remix-style creation should copy custom knowledge */
+      /**
+       * @description Whether remix-style creation should copy custom knowledge
+       * @example true
+       */
       include_custom_knowledge?: boolean;
-      /** @description Whether remix-style creation should include chat history */
+      /**
+       * @description Whether remix-style creation should include chat history
+       * @example true
+       */
       include_history?: boolean;
-      /** @description Initial chat message to send after remix */
+      /**
+       * @description Initial chat message to send after remix
+       * @example A landing page for my SaaS product with a hero, features, and pricing.
+       */
       initial_message?: string;
-      /** @description Message ID to remix from */
+      /**
+       * @description Message ID to remix from
+       * @example msg_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       message_id?: string;
       /**
        * @description How to apply message_id: before starts before the message, including includes that message's completed turn. Defaults to including.
+       * @example including
        * @enum {string}
        */
       remix_mode?: "before" | "including";
-      /** @description Suppress the default remix success message */
+      /**
+       * @description Suppress the default remix success message
+       * @example false
+       */
       skip_initial_remix_message?: boolean;
-      /** @description Skip remixing integrations */
+      /**
+       * @description Skip remixing integrations
+       * @example false
+       */
       skip_integrations?: boolean;
-      /** @description Source project ID for remix-style creation */
+      /**
+       * @description Source project ID for remix-style creation
+       * @example prj_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       source_project_id: string;
-      /** @description Workspace ID */
+      /**
+       * @description Workspace ID
+       * @example workspace_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       workspace_id: string;
     };
     PublicV1PublishAudienceTarget: {
@@ -2730,26 +3012,44 @@ interface components {
       /**
        * Format: date-time
        * @description When the workspace was created.
+       * @example 2026-01-15T09:30:00Z
        */
       created_at?: string;
-      /** @description Workspace description. */
+      /**
+       * @description Workspace description.
+       * @example Marketing site and internal tools for Acme.
+       */
       description?: string;
-      /** @description Workspace ID. */
+      /**
+       * @description Workspace ID.
+       * @example workspace_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       id: string;
-      /** @description Workspace image URL. */
+      /**
+       * @description Workspace image URL.
+       * @example https://lovable.dev/cdn/workspaces/acme/avatar.png
+       */
       image_url?: string;
-      /** @description Workspace display name. */
+      /**
+       * @description Workspace display name.
+       * @example Acme Inc
+       */
       name: string;
       /**
        * Format: int64
        * @description Number of projects in the workspace.
+       * @example 12
        */
       num_projects: number;
-      /** @description Plan tier. One of: free, pro, business, enterprise. More values may be added; clients must tolerate unknown values. */
+      /**
+       * @description Plan tier. One of: free, pro, business, enterprise. More values may be added; clients must tolerate unknown values.
+       * @example pro
+       */
       plan: string;
       /**
        * Format: date-time
        * @description When the workspace was last updated.
+       * @example 2026-01-15T09:30:00Z
        */
       updated_at?: string;
     };
@@ -2757,39 +3057,64 @@ interface components {
       /**
        * Format: date-time
        * @description When the caller joined the workspace.
+       * @example 2026-01-15T09:30:00Z
        */
       joined_at?: string;
-      /** @description Caller's role in the workspace. One of: owner, admin, member, viewer, collaborator. More values may be added; clients must tolerate unknown values. */
+      /**
+       * @description Caller's role in the workspace. One of: owner, admin, member, viewer, collaborator. More values may be added; clients must tolerate unknown values.
+       * @example admin
+       */
       role: string;
-      /** @description Caller's user ID. */
+      /**
+       * @description Caller's user ID.
+       * @example Xy7Kd2Lm9Qp4Rt6Vw8Zc1Bn3Fh5
+       */
       user_id: string;
     };
     PublicV1WorkspaceWithMembership: {
       /**
        * Format: date-time
        * @description When the workspace was created.
+       * @example 2026-01-15T09:30:00Z
        */
       created_at?: string;
-      /** @description Workspace description. */
+      /**
+       * @description Workspace description.
+       * @example Marketing site and internal tools for Acme.
+       */
       description?: string;
-      /** @description Workspace ID. */
+      /**
+       * @description Workspace ID.
+       * @example workspace_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       id: string;
-      /** @description Workspace image URL. */
+      /**
+       * @description Workspace image URL.
+       * @example https://lovable.dev/cdn/workspaces/acme/avatar.png
+       */
       image_url?: string;
       /** @description Caller's membership in this workspace. */
       membership?: components["schemas"]["PublicV1WorkspaceMember"];
-      /** @description Workspace display name. */
+      /**
+       * @description Workspace display name.
+       * @example Acme Inc
+       */
       name: string;
       /**
        * Format: int64
        * @description Number of projects in the workspace.
+       * @example 12
        */
       num_projects: number;
-      /** @description Plan tier. One of: free, pro, business, enterprise. More values may be added; clients must tolerate unknown values. */
+      /**
+       * @description Plan tier. One of: free, pro, business, enterprise. More values may be added; clients must tolerate unknown values.
+       * @example pro
+       */
       plan: string;
       /**
        * Format: date-time
        * @description When the workspace was last updated.
+       * @example 2026-01-15T09:30:00Z
        */
       updated_at?: string;
     };
@@ -2806,13 +3131,15 @@ interface components {
     };
     RemixWarning: {
       /** @enum {string} */
-      code: "edge_functions_not_deployed";
+      code: "edge_functions_not_deployed" | "integration_skipped";
       failed_edge_functions?: string[] | null;
+      reason?: string;
+      skipped_integration?: string;
     };
     SeamlessConnectorAPI: {
       alias?: string;
       categories: string[] | null;
-      creator: components["schemas"]["CommonSeamlessConnectorCreator"];
+      creator: components["schemas"]["Creator"];
       description: string;
       display_name: string;
       documentation_url: string;
@@ -2941,6 +3268,8 @@ interface components {
       is_enabled_for_workspace: boolean;
       /** @description True when the connector is gated behind a feature flag rollout */
       is_new?: boolean;
+      /** @description Optional HTTPS logo URL */
+      logo_url?: string;
       promotion?: components["schemas"]["StandardConnectorPromotion"];
       /** @description Search keywords (empty array when none) */
       searchTags: string[];
@@ -2983,20 +3312,28 @@ interface components {
     TimeSeriesData: {
       /** @description Per-bucket values ordered by date, one entry per bucket in the range (bucket size set by the granularity parameter). */
       data: components["schemas"]["TimeSeriesDataPoint"][] | null;
-      /** @description Metric identifier, e.g. "sessionDuration". */
+      /**
+       * @description Metric identifier, e.g. "sessionDuration".
+       * @example visitors
+       */
       label: string;
       /**
        * Format: double
        * @description Period-level aggregate for this metric over the requested range. How it is computed (sum, ratio, or average) and its unit depend on the metric — see the metric field's description.
+       * @example 1280
        */
       total: number;
     };
     TimeSeriesDataPoint: {
-      /** @description Bucket start as "YYYY-MM-DD HH:MM:SS" in UTC. */
+      /**
+       * @description Bucket start as "YYYY-MM-DD HH:MM:SS" in UTC.
+       * @example 2026-01-15 00:00:00
+       */
       date: string;
       /**
        * Format: double
        * @description Metric value for this bucket. Unit matches the parent metric — see its description.
+       * @example 1280
        */
       value: number;
     };
@@ -3021,10 +3358,26 @@ interface components {
       title?: string;
     };
     TrendDataPoint: {
+      /**
+       * @description Bucket start as "YYYY-MM-DD HH:MM:SS" in UTC.
+       * @example 2026-01-15 09:30:00
+       */
       time: string;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of visits recorded in this bucket.
+       * @example 42
+       */
       visits: number;
     };
+    UserCreator: {
+      /**
+       * @description discriminator enum property added by openapi-typescript
+       * @enum {string}
+       */
+      type: "user";
+      user_id: string;
+    };
     V1AIResponseSummary: {
       /** @description Pending human-in-the-loop tool input, only present when status is awaiting_input */
       awaiting_input?: components["schemas"]["V1AwaitingInputSummary"];
@@ -3107,61 +3460,80 @@ interface components {
       user_id: string;
     };
     V1BillingCreditLimitsBody: {
+      /** @description Items in this page. */
       data: components["schemas"]["V1BillingCreditLimitRow"][] | null;
       /**
        * Format: double
        * @description Workspace default cap applied to members without an explicit per-member limit. Absent when unset (members are bounded only by the workspace balance).
        */
       default_monthly_credit_limit?: number;
+      /** @description Pagination cursors for fetching adjacent pages. */
       pagination: components["schemas"]["Pagination"];
     };
     V1BillingPeriod: {
       /**
        * Format: date-time
        * @description Exclusive end of the period these credit figures cover (RFC3339, UTC).
+       * @example 2026-02-01T00:00:00Z
        */
       end: string;
       /**
        * Format: date-time
        * @description Inclusive start of the period these credit figures cover (RFC3339, UTC).
+       * @example 2026-01-01T00:00:00Z
        */
       start: string;
     };
     V1BillingUsageBody: {
+      /** @description Items in this page. */
       data: components["schemas"]["V1BillingUsageRow"][] | null;
       /**
        * Format: int64
        * @description Number of grouped entities across all pages; group_by queries only.
+       * @example 12
        */
       entity_count?: number;
+      /** @description Pagination cursors for fetching adjacent pages. */
       pagination: components["schemas"]["Pagination"];
       /** @description The resolved window these rows cover, echoed so callers can see what the server applied. */
       period: components["schemas"]["V1BillingUsagePeriod"];
       /**
        * Format: double
        * @description Total matching credits across the whole window — same on every page, not just this page's rows.
+       * @example 500
        */
       workspace_total: number;
     };
     V1BillingUsagePeriod: {
-      /** @description Inclusive end of the covered window (YYYY-MM-DD, UTC). */
+      /**
+       * @description Inclusive end of the covered window (YYYY-MM-DD, UTC).
+       * @example 2026-01-31
+       */
       end: string;
-      /** @description Grouping dimension the rows use; group_by queries only. */
+      /**
+       * @description Grouping dimension the rows use; group_by queries only.
+       * @example member
+       */
       group_by?: string;
       /** @description Bucket size the rows use; interval queries only. */
       interval?: string;
-      /** @description Inclusive start of the covered window (YYYY-MM-DD, UTC). */
+      /**
+       * @description Inclusive start of the covered window (YYYY-MM-DD, UTC).
+       * @example 2026-01-01
+       */
       start: string;
     };
     V1BillingUsageRow: {
       /**
        * Format: double
        * @description Build-time credits.
+       * @example 120
        */
       build: number;
       /**
        * Format: double
        * @description Connector credits, e.g. Google Maps requests.
+       * @example 10
        */
       connectors: number;
       /** @description Per-connector breakdown. Interval buckets only. */
@@ -3169,22 +3541,31 @@ interface components {
       /**
        * Format: double
        * @description Database credits.
+       * @example 30
        */
       database: number;
       /** @description Database server/storage breakdown. Interval buckets only. */
       database_breakdown?: components["schemas"]["V1WorkspaceUsageDatabaseBreakdown"][] | null;
-      /** @description Member display name. Present on member-attributed rows (group_by=member, or a query filtered to one user_id) when the caller also holds the members:read scope. */
+      /**
+       * @description Member display name. Present on member-attributed rows (group_by=member, or a query filtered to one user_id) when the caller also holds the members:read scope.
+       * @example Jane Cooper
+       */
       display_name?: string;
-      /** @description Member email as stored on the workspace membership (not the user's primary/personal email). Present on member-attributed rows when the caller also holds the members:read scope. */
+      /**
+       * @description Member email as stored on the workspace membership (not the user's primary/personal email). Present on member-attributed rows when the caller also holds the members:read scope.
+       * @example jane.cooper@acme.com
+       */
       email?: string;
       /**
        * Format: double
        * @description Compute credits from functions and workers.
+       * @example 60
        */
       functions: number;
       /**
        * Format: double
        * @description AI Gateway credits.
+       * @example 200
        */
       gateway: number;
       /** @description Per-model AI Gateway breakdown. Interval buckets only. */
@@ -3192,6 +3573,7 @@ interface components {
       /**
        * Format: double
        * @description Network data-transfer credits.
+       * @example 10
        */
       network: number;
       /** @description Inclusive row end (YYYY-MM-DD, UTC), clamped to the requested window at the edges. */
@@ -3203,24 +3585,31 @@ interface components {
       /**
        * Format: double
        * @description Realtime credits.
+       * @example 40
        */
       realtime: number;
       /**
        * Format: double
        * @description Run-time credits (sum of the per-category fields below).
+       * @example 380
        */
       run: number;
       /**
        * Format: double
        * @description Storage credits.
+       * @example 30
        */
       storage: number;
       /**
        * Format: double
        * @description Total credits in this row.
+       * @example 500
        */
       total: number;
-      /** @description Member this row aggregates (group_by=member) or is filtered to (user_id). */
+      /**
+       * @description Member this row aggregates (group_by=member) or is filtered to (user_id).
+       * @example Xy7Kd2Lm9Qp4Rt6Vw8Zc1Bn3Fh5
+       */
       user_id?: string;
     };
     V1BulkMemberCreditLimitItem: {
@@ -3229,19 +3618,32 @@ interface components {
       /**
        * Format: double
        * @description A number (0 blocks all spend) to set the cap, or null to clear it (the member inherits the workspace default).
+       * @example 500
        */
       monthly_credit_limit: number | null;
-      /** @description Member user_id (from GET /v1/workspaces/{workspace_id}/members; active members only). Provide exactly one of user_id or email. */
+      /**
+       * @description Member user_id (from GET /v1/workspaces/{workspace_id}/members; active members only). Provide exactly one of user_id or email.
+       * @example Xy7Kd2Lm9Qp4Rt6Vw8Zc1Bn3Fh5
+       */
       user_id?: string;
     };
     V1BulkMemberCreditLimitResult: {
       /** @description Echoed when the item was addressed by email, so email-addressed results stay correlatable. */
       email?: string;
-      /** @description Failure reason when status is error. */
+      /**
+       * @description Failure reason when status is error.
+       * @example member not found
+       */
       error?: string;
-      /** @description success or error. */
+      /**
+       * @description success or error.
+       * @example error
+       */
       status: string;
-      /** @description The member this result is for (resolved from email when the item was addressed by email). */
+      /**
+       * @description The member this result is for (resolved from email when the item was addressed by email).
+       * @example Xy7Kd2Lm9Qp4Rt6Vw8Zc1Bn3Fh5
+       */
       user_id?: string;
     };
     V1BulkSetMemberCreditLimitInputBody: {
@@ -3254,6 +3656,7 @@ interface components {
       /**
        * Format: int64
        * @description Number that failed (see per-item error).
+       * @example 1
        */
       failed: number;
       /** @description Per-member outcome, in request order. */
@@ -3261,11 +3664,13 @@ interface components {
       /**
        * Format: int64
        * @description Number applied successfully.
+       * @example 2
        */
       successful: number;
       /**
        * Format: int64
        * @description Number of members in the request.
+       * @example 3
        */
       total: number;
     };
@@ -3300,15 +3705,22 @@ interface components {
       url?: string;
     };
     V1CreateEmbedURLInputBody: {
-      /** @description Exact HTTPS origin allowed to frame the static preview */
+      /**
+       * @description Exact HTTPS origin (scheme + host, no path) allowed to frame the static preview. The minted token only loads inside a frame served from this origin.
+       * @example https://acme.com
+       */
       parent_origin: string;
     };
     V1CreateEmbedURLOutputBody: {
-      /** @description Origin-bound static preview URL */
+      /**
+       * @description Origin-bound static-preview URL carrying a short-lived signed token (?__lovable_token=…). Load it in an iframe on the requested parent_origin.
+       * @example https://acme-landing-page.lovable.app/?__lovable_token=eyJhbGciOiJIUzI1NiJ9
+       */
       embed_url: string;
       /**
        * Format: date-time
-       * @description Embed URL token expiration time
+       * @description When the embed URL token expires and stops loading the preview.
+       * @example 2026-01-15T09:30:00Z
        */
       expires_at: string;
     };
@@ -3349,57 +3761,117 @@ interface components {
       /**
        * Format: date-time
        * @description When the project was created.
+       * @example 2026-01-15T09:30:00Z
        */
       created_at?: string;
-      /** @description Description supplied by the caller on create or update. */
+      /**
+       * @description Description supplied by the caller on create or update.
+       * @example Marketing landing page for Acme's product launch.
+       */
       description?: string;
-      /** @description Human-readable project name. */
-      display_name?: string;
-      /** @description Folder the project belongs to, if any. */
+      /**
+       * @description Human-readable project name.
+       * @example Acme Landing Page
+       */
+      display_name?: string;
+      /**
+       * @description Folder the project belongs to, if any.
+       * @example fold_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       folder_id?: string;
-      /** @description AI-written summary of what the project does. Absent until the agent has completed a response for the project. */
+      /**
+       * @description AI-written summary of what the project does. Absent until the agent has completed a response for the project.
+       * @example A landing page for Acme with a hero, features, and pricing.
+       */
       generated_description?: string;
-      /** @description Project ID. */
+      /**
+       * @description Project ID.
+       * @example prj_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       id: string;
-      /** @description Whether the project is published. */
+      /**
+       * @description Whether the project is published.
+       * @example true
+       */
       is_published?: boolean;
       /**
        * Format: date-time
        * @description When the project was last edited.
+       * @example 2026-01-15T09:30:00Z
        */
       last_edited_at?: string;
-      /** @description SHA of the latest commit */
+      /**
+       * @description SHA of the latest commit
+       * @example a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0
+       */
       latest_commit_sha?: string;
-      /** @description URL of the latest screenshot. */
+      /**
+       * @description URL of the latest screenshot.
+       * @example https://screenshot2.lovable.dev/acme-landing-page.png
+       */
       latest_screenshot_url?: string;
       /** @description User message ID, present when initial_message was provided */
       message_id?: string;
-      /** @description Project slug. */
+      /**
+       * @description Project slug.
+       * @example acme-landing-page
+       */
       name?: string;
-      /** @description Open Graph image URL. */
+      /**
+       * @description Open Graph image URL.
+       * @example https://lovable.dev/cdn/projects/acme-landing-page/og.png
+       */
       og_image_url?: string;
-      /** @description Static-preview URL for the project, on the workspace's branded host when it has one. Resolves once the first build completes. Opening it requires a Lovable login unless the project is publicly remixable; to frame it from a third-party origin without one, mint an origin-bound token via POST /v1/projects/{project_id}/embed-url. */
+      /**
+       * @description Static-preview URL for the project, on the workspace's branded host when it has one. Resolves once the first build completes. Opening it requires a Lovable login unless the project is publicly remixable; to frame it from a third-party origin without one, mint an origin-bound token via POST /v1/projects/{project_id}/embed-url.
+       * @example https://acme-landing-page.lovable.app/
+       */
       preview_url?: string;
-      /** @description Project type. One of: project, library. Absent on older projects. More values may be added; clients must tolerate unknown values. */
+      /**
+       * @description Project type. One of: project, library. Absent on older projects. More values may be added; clients must tolerate unknown values.
+       * @example project
+       */
       project_type?: string;
-      /** @description Published visibility. One of: public, private. More values may be added; clients must tolerate unknown values. */
+      /**
+       * @description Published visibility. One of: public, private. More values may be added; clients must tolerate unknown values.
+       * @example public
+       */
       publish_visibility?: string;
-      /** @description Provisioning status of the project, not agent build progress. 'completed' means the project scaffold was created, and is set before the agent has finished the initial message, so the code at that point is often an empty starter page. To check whether the agent finished building, poll GET /v1/messages/{message_id}. One of: in_progress, completed, failed. More values may be added; clients must tolerate unknown values. */
+      /**
+       * @description Provisioning status of the project, not agent build progress. 'completed' means the project scaffold was created, and is set before the agent has finished the initial message, so the code at that point is often an empty starter page. To check whether the agent finished building, poll GET /v1/messages/{message_id}. One of: in_progress, completed, failed. More values may be added; clients must tolerate unknown values.
+       * @example completed
+       */
       status?: string;
-      /** @description Project tech stack. */
+      /**
+       * @description Project tech stack.
+       * @example vite_react_shadcn_ts
+       */
       tech_stack?: string;
       /**
        * Format: date-time
        * @description When the project was last updated.
+       * @example 2026-01-15T09:30:00Z
        */
       updated_at?: string;
-      /** @description Published project URL. */
+      /**
+       * @description Published project URL.
+       * @example https://acme-landing-page.lovable.app
+       */
       url?: string;
-      /** @description Project owner user ID. */
+      /**
+       * @description Project owner user ID.
+       * @example Xy7Kd2Lm9Qp4Rt6Vw8Zc1Bn3Fh5
+       */
       user_id?: string;
-      /** @description Project visibility: draft, private, workspace_view, or public. */
+      /**
+       * @description Project visibility: draft, private, workspace_view, or public.
+       * @example public
+       */
       visibility?: string;
-      /** @description Workspace the project belongs to. */
+      /**
+       * @description Workspace the project belongs to.
+       * @example workspace_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       workspace_id: string;
     };
     V1CreateVariantInputBody: {
@@ -3422,25 +3894,35 @@ interface components {
       /**
        * Format: double
        * @description Signed change in Lovable credits: positive for grants, negative for expiries and debits.
+       * @example 1500
        */
       credits_change: number;
       /**
        * @description What happened to the credits.
+       * @example granted
        * @enum {string}
        */
       event_type: "granted" | "expired" | "adjustment" | "converted";
       /**
        * @description Credit bucket this entry affected.
+       * @example billing
        * @enum {string}
        */
       grant_type: "billing" | "rollover" | "granted" | "topup" | "commitment" | "cashback" | "daily";
-      /** @description Stable ledger entry ID. */
+      /**
+       * @description Stable ledger entry ID.
+       * @example 01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       id: string;
-      /** @description Human-readable summary of the entry. */
+      /**
+       * @description Human-readable summary of the entry.
+       * @example Monthly plan credit grant
+       */
       label: string;
       /**
        * Format: date-time
        * @description When the entry occurred (RFC3339, UTC).
+       * @example 2026-01-15T09:30:00Z
        */
       occurred_at: string;
     };
@@ -3521,8 +4003,11 @@ interface components {
       has_more: boolean;
     };
     V1GetSecurityScanOutputBody: {
+      /** @description Security findings captured in this scan. */
       findings: components["schemas"]["V1SecurityFinding"][] | null;
+      /** @description Scan invocation summary. */
       scan: components["schemas"]["V1SecurityScanSummary"];
+      /** @description Per-scanner execution records for this scan. */
       scanner_runs: components["schemas"]["V1SecurityScannerRun"][] | null;
     };
     V1GetWorkspaceSkillOutputBody: {
@@ -3652,35 +4137,47 @@ interface components {
       /**
        * Format: int64
        * @description Compressed archive size in bytes.
+       * @example 10485760
        */
       archive_size_bytes?: number;
       /**
        * Format: date-time
        * @description When the export reached a terminal state.
+       * @example 2026-01-15T09:32:10Z
        */
       completed_at?: string;
       /**
        * Format: date-time
        * @description When the export was requested.
+       * @example 2026-01-15T09:30:00Z
        */
       created_at: string;
-      /** @description One-hour signed URL, present while a completed export has not expired. */
+      /**
+       * @description One-hour signed URL for the ZIP archive, present while a completed export has not expired.
+       * @example https://storage.googleapis.com/lovable-message-exports/0195b2c3-6a7d-4f3e-9a1b-2c3d4e5f6a7b.zip?X-Goog-Expires=3600
+       */
       download_url?: string;
       /**
        * Format: date-time
        * @description When the completed file is deleted.
+       * @example 2026-01-22T09:32:10Z
        */
       expires_at?: string;
-      /** @description Export ID. */
+      /**
+       * @description Export ID.
+       * @example 0195b2c3-6a7d-4f3e-9a1b-2c3d4e5f6a7b
+       */
       export_id: string;
       /**
        * Format: int64
        * @description Number of messages in a completed export.
+       * @example 4821
        */
       message_count?: number;
       /**
        * Format: int64
        * @description Number of projects represented in a completed export.
+       * @example 12
        */
       project_count?: number;
       /**
@@ -3746,20 +4243,32 @@ interface components {
     V1ProjectCloudBody: {
       /** @description Disk-space telemetry. Omitted while the measurement is temporarily unavailable; retry later. */
       disk?: components["schemas"]["V1ProjectCloudDisk"];
-      /** @description Cloud environment these values describe. */
+      /**
+       * @description Cloud environment these values describe.
+       * @example production
+       */
       environment: string;
       /**
        * @description Current compute instance tier code.
        * @enum {string}
        */
       instance_tier: "xs" | "s" | "m" | "ml" | "l" | "xl" | "xxl";
-      /** @description Human-readable tier name as shown in the editor (Tiny, Mini, Small, Medium, Large, X-Large, 2X-Large). */
+      /**
+       * @description Human-readable tier name as shown in the editor (Tiny, Mini, Small, Medium, Large, X-Large, 2X-Large).
+       * @example Small
+       */
       instance_tier_label: string;
-      /** @description Why the instance was paused (e.g. credit_limit), when recorded. */
+      /** @description Why the instance was paused (e.g. credit_limit), when recorded. Only present on paused instances. */
       pause_reason?: string;
-      /** @description Postgres major/minor version. Omitted while the lookup is temporarily unavailable. */
+      /**
+       * @description Postgres major/minor version. Omitted while the lookup is temporarily unavailable.
+       * @example 17.4
+       */
       postgres_version?: string;
-      /** @description Region the database runs in. Omitted while the lookup is temporarily unavailable. */
+      /**
+       * @description Region the database runs in. Omitted while the lookup is temporarily unavailable.
+       * @example us-east-1
+       */
       region?: string;
       /** @description CPU/memory/disk-IO pressure alerts over the trailing window. Omitted while the lookup is temporarily unavailable. */
       resource_pressure?: components["schemas"]["V1ProjectCloudResourcePressure"];
@@ -3768,23 +4277,29 @@ interface components {
        * @enum {string}
        */
       status?: "OK" | "RESIZING" | "UPGRADING" | "RESTARTING" | "COMING_UP" | "RESTORING" | "UNHEALTHY" | "INACTIVE" | "PAUSING" | "UNKNOWN" | "";
-      /** @description True when a user (or the platform) explicitly paused this cloud instance. */
+      /**
+       * @description True when a user (or the platform) explicitly paused this cloud instance.
+       * @example false
+       */
       user_paused: boolean;
     };
     V1ProjectCloudDisk: {
       /**
        * Format: int64
        * @description Provisioned size of the database volume in bytes.
+       * @example 8589934592
        */
       size_bytes: number;
       /**
        * Format: date-time
        * @description When the platform measured these values. Measurements refresh periodically; use this to judge data age.
+       * @example 2026-01-15T09:30:00Z
        */
       timestamp: string;
       /**
        * Format: int64
        * @description Bytes used on the database volume, as last measured by the platform. Measures the whole managed volume, so it exceeds what SQL-level views (e.g. pg_database_size) can see.
+       * @example 1073741824
        */
       used_bytes: number;
     };
@@ -3794,6 +4309,7 @@ interface components {
       /**
        * Format: int64
        * @description Size of the trailing window these signals cover.
+       * @example 24
        */
       window_hours: number;
     };
@@ -3801,50 +4317,80 @@ interface components {
       /**
        * Format: int64
        * @description Hours within the window that raised a pressure alert.
+       * @example 3
        */
       alert_hours: number;
-      /** @description Human-readable resource name. */
+      /**
+       * @description Human-readable resource name.
+       * @example CPU
+       */
       label: string;
       /**
        * Format: date-time
        * @description Most recent pressure alert in the window, if any.
+       * @example 2026-01-15T09:30:00Z
        */
       latest_alert_at?: string;
       /**
        * Format: double
        * @description Reported value of the most recent alert, if any.
+       * @example 95.5
        */
       latest_value?: number;
-      /** @description Resource under pressure: cpu, memory, or disk_io. */
+      /**
+       * @description Resource under pressure: cpu, memory, or disk_io.
+       * @example cpu
+       */
       resource_type: string;
     };
     V1ProjectCollaborator: {
       /**
        * Format: date-time
        * @description When the user accepted the project invitation. Null if the invite is still pending.
+       * @example 2026-01-15T09:30:00Z
        */
       accepted_at?: string;
       /**
        * @description Access level: owner, admin, write, or read
+       * @example admin
        * @enum {string}
        */
       access_level: "owner" | "admin" | "write" | "read" | "none";
-      /** @description Human-readable display name. Falls back to the email when the user has not set a display name. */
+      /**
+       * @description Human-readable display name. Falls back to the email when the user has not set a display name.
+       * @example Jane Cooper
+       */
       display_name?: string;
-      /** @description Email address of the collaborator. Empty if the user has no resolvable email (e.g. deleted user records that were not filtered out, or service-account-like users without an email on file). */
+      /**
+       * @description Email address of the collaborator. Empty if the user has no resolvable email (e.g. deleted user records that were not filtered out, or service-account-like users without an email on file).
+       * @example jane.cooper@acme.com
+       */
       email?: string;
       /**
        * Format: date-time
        * @description When the user was invited to the project. Null for the project owner.
+       * @example 2026-01-15T09:30:00Z
        */
       invited_at?: string;
-      /** @description User ID of the inviter. Empty for the project owner. */
+      /**
+       * @description User ID of the inviter. Empty for the project owner.
+       * @example Xy7Kd2Lm9Qp4Rt6Vw8Zc1Bn3Fh5
+       */
       invited_by?: string;
-      /** @description True when the user is internal to the workspace: either a workspace member, or their email belongs to a domain the workspace has verified (typical SSO / JIT provisioning case). Useful for distinguishing internal vs. external collaborators in security reviews. */
+      /**
+       * @description True when the user is internal to the workspace: either a workspace member, or their email belongs to a domain the workspace has verified (typical SSO / JIT provisioning case). Useful for distinguishing internal vs. external collaborators in security reviews.
+       * @example true
+       */
       is_internal: boolean;
-      /** @description True when the user is a member of the project's workspace. False indicates an ad-hoc project collaborator who has no broader workspace access. */
+      /**
+       * @description True when the user is a member of the project's workspace. False indicates an ad-hoc project collaborator who has no broader workspace access.
+       * @example true
+       */
       is_workspace_member: boolean;
-      /** @description User ID of the collaborator */
+      /**
+       * @description User ID of the collaborator
+       * @example Xy7Kd2Lm9Qp4Rt6Vw8Zc1Bn3Fh5
+       */
       user_id: string;
     };
     V1ProjectFileUploadURLInputBody: {
@@ -3868,55 +4414,115 @@ interface components {
       /**
        * Format: date-time
        * @description When the project was created.
+       * @example 2026-01-15T09:30:00Z
        */
       created_at?: string;
-      /** @description Description supplied by the caller on create or update. */
+      /**
+       * @description Description supplied by the caller on create or update.
+       * @example Marketing landing page for Acme's product launch.
+       */
       description?: string;
-      /** @description Human-readable project name. */
+      /**
+       * @description Human-readable project name.
+       * @example Acme Landing Page
+       */
       display_name?: string;
-      /** @description Folder the project belongs to, if any. */
+      /**
+       * @description Folder the project belongs to, if any.
+       * @example fold_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       folder_id?: string;
-      /** @description AI-written summary of what the project does. Absent until the agent has completed a response for the project. */
+      /**
+       * @description AI-written summary of what the project does. Absent until the agent has completed a response for the project.
+       * @example A landing page for Acme with a hero, features, and pricing.
+       */
       generated_description?: string;
-      /** @description Project ID. */
+      /**
+       * @description Project ID.
+       * @example prj_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       id: string;
-      /** @description Whether the project is published. */
+      /**
+       * @description Whether the project is published.
+       * @example true
+       */
       is_published?: boolean;
       /**
        * Format: date-time
        * @description When the project was last edited.
+       * @example 2026-01-15T09:30:00Z
        */
       last_edited_at?: string;
-      /** @description SHA of the latest commit */
+      /**
+       * @description SHA of the latest commit
+       * @example a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0
+       */
       latest_commit_sha?: string;
-      /** @description URL of the latest screenshot. */
+      /**
+       * @description URL of the latest screenshot.
+       * @example https://screenshot2.lovable.dev/acme-landing-page.png
+       */
       latest_screenshot_url?: string;
-      /** @description Project slug. */
+      /**
+       * @description Project slug.
+       * @example acme-landing-page
+       */
       name?: string;
-      /** @description Open Graph image URL. */
+      /**
+       * @description Open Graph image URL.
+       * @example https://lovable.dev/cdn/projects/acme-landing-page/og.png
+       */
       og_image_url?: string;
-      /** @description Static-preview URL for the project, on the workspace's branded host when it has one. Resolves once the first build completes. Opening it requires a Lovable login unless the project is publicly remixable; to frame it from a third-party origin without one, mint an origin-bound token via POST /v1/projects/{project_id}/embed-url. */
+      /**
+       * @description Static-preview URL for the project, on the workspace's branded host when it has one. Resolves once the first build completes. Opening it requires a Lovable login unless the project is publicly remixable; to frame it from a third-party origin without one, mint an origin-bound token via POST /v1/projects/{project_id}/embed-url.
+       * @example https://acme-landing-page.lovable.app/
+       */
       preview_url?: string;
-      /** @description Project type. One of: project, library. Absent on older projects. More values may be added; clients must tolerate unknown values. */
+      /**
+       * @description Project type. One of: project, library. Absent on older projects. More values may be added; clients must tolerate unknown values.
+       * @example project
+       */
       project_type?: string;
-      /** @description Published visibility. One of: public, private. More values may be added; clients must tolerate unknown values. */
+      /**
+       * @description Published visibility. One of: public, private. More values may be added; clients must tolerate unknown values.
+       * @example public
+       */
       publish_visibility?: string;
-      /** @description Provisioning status of the project, not agent build progress. 'completed' means the project scaffold was created, and is set before the agent has finished the initial message, so the code at that point is often an empty starter page. To check whether the agent finished building, poll GET /v1/messages/{message_id}. One of: in_progress, completed, failed. More values may be added; clients must tolerate unknown values. */
+      /**
+       * @description Provisioning status of the project, not agent build progress. 'completed' means the project scaffold was created, and is set before the agent has finished the initial message, so the code at that point is often an empty starter page. To check whether the agent finished building, poll GET /v1/messages/{message_id}. One of: in_progress, completed, failed. More values may be added; clients must tolerate unknown values.
+       * @example completed
+       */
       status?: string;
-      /** @description Project tech stack. */
+      /**
+       * @description Project tech stack.
+       * @example vite_react_shadcn_ts
+       */
       tech_stack?: string;
       /**
        * Format: date-time
        * @description When the project was last updated.
+       * @example 2026-01-15T09:30:00Z
        */
       updated_at?: string;
-      /** @description Published project URL. */
+      /**
+       * @description Published project URL.
+       * @example https://acme-landing-page.lovable.app
+       */
       url?: string;
-      /** @description Project owner user ID. */
+      /**
+       * @description Project owner user ID.
+       * @example Xy7Kd2Lm9Qp4Rt6Vw8Zc1Bn3Fh5
+       */
       user_id?: string;
-      /** @description Project visibility: draft, private, workspace_view, or public. */
+      /**
+       * @description Project visibility: draft, private, workspace_view, or public.
+       * @example public
+       */
       visibility?: string;
-      /** @description Workspace the project belongs to. */
+      /**
+       * @description Workspace the project belongs to.
+       * @example workspace_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       workspace_id: string;
     };
     V1ProjectSkillDTO: {
@@ -3983,33 +4589,82 @@ interface components {
       success: boolean;
     };
     V1SecurityFinding: {
+      /**
+       * @description Finding category.
+       * @example data_exposure
+       */
       category?: string;
-      connector_id?: string;
-      /** Format: date-time */
+      /**
+       * Format: date-time
+       * @description When this finding was first recorded, UTC.
+       * @example 2026-01-15T09:30:00Z
+       */
       created_at: string;
+      /**
+       * @description Human-readable summary of the finding.
+       * @example A public table has row-level security disabled, exposing all rows to anonymous clients.
+       */
       description?: string;
-      /** @description Raw scanner output (e.g. matched pattern fragments). May be empty due to access restrictions; use 'description' and 'metadata' for the user-facing summary. */
+      /**
+       * @description Raw scanner output (e.g. matched pattern fragments). May be empty due to access restrictions; use 'description' and 'metadata' for the user-facing summary.
+       * @example table: public.profiles; rls_enabled: false
+       */
       details?: string;
+      /**
+       * @description Stable identifier for this finding.
+       * @example b2c3d4e5-f6a7-8901-bcde-f23456789012
+       */
       finding_id: string;
+      /**
+       * @description Scan invocation ID where this finding was first seen.
+       * @example a1b2c3d4-e5f6-7890-abcd-ef1234567890
+       */
       first_seen_scan_id?: string;
-      /** @description error | warn | info */
+      /**
+       * @description error | warn | info
+       * @example error
+       */
       level: string;
+      /**
+       * @description Link to remediation guidance for this finding.
+       * @example https://docs.lovable.dev/security/rls
+       */
       link?: string;
       /** @description Scanner-specific metadata (file_path, line_number, package, cve, ...) */
       metadata?: {
         [key: string]: unknown;
       };
+      /**
+       * @description Short finding title.
+       * @example Row-level security disabled on a public table
+       */
       name: string;
       /**
        * Format: int64
        * @description Number of consecutive scans this finding has appeared in
+       * @example 3
        */
       recurrence: number;
+      /**
+       * @description Estimated remediation effort (easy, medium, or hard).
+       * @example medium
+       */
       remediation_difficulty?: string;
+      /**
+       * @description Name of the scanner that produced this finding.
+       * @example agent_security
+       */
       scanner_name: string;
-      /** @description Finding status. One of: open, fixed, ignored. More values may be added; clients must tolerate unknown values. */
+      /**
+       * @description Finding status. One of: open, fixed, ignored. More values may be added; clients must tolerate unknown values.
+       * @example open
+       */
       status: string;
-      /** Format: date-time */
+      /**
+       * Format: date-time
+       * @description When this finding was last updated, UTC.
+       * @example 2026-01-15T09:30:00Z
+       */
       updated_at: string;
     };
     V1SecurityScanActor: {
@@ -4023,38 +4678,87 @@ interface components {
       type: string;
     };
     V1SecurityScanSummary: {
-      /** @description Project commit at scan start */
+      /**
+       * @description Project commit at scan start
+       * @example 9fceb02d0ae598e95dc970b74767f19372d61af8
+       */
       commit_sha?: string;
-      /** Format: date-time */
+      /**
+       * Format: date-time
+       * @description When the scan finished, UTC; absent while still running.
+       * @example 2026-01-15T09:30:00Z
+       */
       finished_at?: string;
       /** @description Scanners requested for this invocation */
       requested_scanners: string[] | null;
-      /** @description Unique scan invocation ID */
+      /**
+       * @description Unique scan invocation ID
+       * @example a1b2c3d4-e5f6-7890-abcd-ef1234567890
+       */
       scan_id: string;
-      /** Format: date-time */
+      /**
+       * Format: date-time
+       * @description When the scan started, UTC.
+       * @example 2026-01-15T09:30:00Z
+       */
       started_at: string;
-      /** @description Scan status. One of: running, completed, failed. More values may be added; clients must tolerate unknown values. */
+      /**
+       * @description Scan status. One of: running, completed, failed. More values may be added; clients must tolerate unknown values.
+       * @example completed
+       */
       status: string;
-      /** @description What triggered the scan. Known values include: workflow, user, ui_auto, aikido_import, app_mcp_deep_auto, hvt_scheduled, workspace_scheduled, enterprise_batch, gitsync_pull. More values may be added; clients must tolerate unknown values. */
+      /**
+       * @description What triggered the scan. Known values include: workflow, user, ui_auto, aikido_import, app_mcp_deep_auto, hvt_scheduled, workspace_scheduled, enterprise_batch, gitsync_pull. More values may be added; clients must tolerate unknown values.
+       * @example workflow
+       */
       trigger_source: string;
       /** @description Actor that triggered the scan. */
       triggered_by: components["schemas"]["V1SecurityScanActor"];
     };
     V1SecurityScannerRun: {
-      /** @description Commit at which this scanner actually ran (may differ from invocation commit on carry-forward) */
+      /**
+       * @description Commit at which this scanner actually ran (may differ from invocation commit on carry-forward)
+       * @example 9fceb02d0ae598e95dc970b74767f19372d61af8
+       */
       commit_sha?: string;
+      /**
+       * @description Error message when the scanner failed.
+       * @example Scanner timed out after 300s
+       */
       error_message?: string;
-      /** Format: date-time */
+      /**
+       * Format: date-time
+       * @description When this scanner finished, UTC; absent while still running.
+       * @example 2026-01-15T09:30:00Z
+       */
       finished_at?: string;
+      /**
+       * @description Name of the scanner that ran.
+       * @example agent_security
+       */
       scanner_name: string;
+      /**
+       * @description Version of the scanner that ran.
+       * @example 1.4.2
+       */
       scanner_version?: string;
-      /** Format: date-time */
+      /**
+       * Format: date-time
+       * @description When this scanner started, UTC.
+       * @example 2026-01-15T09:30:00Z
+       */
       started_at: string;
-      /** @description Scanner run status. One of: succeeded, failed, skipped. More values may be added; clients must tolerate unknown values. */
+      /**
+       * @description Scanner run status. One of: succeeded, failed, skipped. More values may be added; clients must tolerate unknown values.
+       * @example failed
+       */
       status: string;
     };
     V1SelectedLibrary: {
-      /** @description Library project ID */
+      /**
+       * @description Library project ID
+       * @example prj_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       project_id: string;
     };
     V1SendMessageInputBody: {
@@ -4125,17 +4829,32 @@ interface components {
       content: string;
     };
     V1StartMessageExportInputBody: {
-      /** @description Exclusive RFC3339 end time. Defaults to the request time. */
+      /**
+       * @description Exclusive RFC3339 end time. Defaults to the request time.
+       * @example 2026-02-01T00:00:00Z
+       */
       end_date?: string;
-      /** @description Export only messages from this project. The project must be visible to the caller. May be combined with user_id; both filters must match. */
+      /**
+       * @description Export only messages from this project. The project must be visible to the caller. May be combined with user_id; both filters must match.
+       * @example prj_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       project_id?: string;
-      /** @description Inclusive RFC3339 start time. Defaults to 90 days before end_date. */
+      /**
+       * @description Inclusive RFC3339 start time. Defaults to 90 days before end_date.
+       * @example 2026-01-01T00:00:00Z
+       */
       start_date?: string;
-      /** @description Export only messages sent by this user. May be combined with project_id; both filters must match. */
+      /**
+       * @description Export only messages sent by this user. May be combined with project_id; both filters must match.
+       * @example Xy7Kd2Lm9Qp4Rt6Vw8Zc1Bn3Fh5
+       */
       user_id?: string;
     };
     V1StartMessageExportOutputBody: {
-      /** @description Export ID used to poll status. */
+      /**
+       * @description Export ID used to poll status.
+       * @example 0195b2c3-6a7d-4f3e-9a1b-2c3d4e5f6a7b
+       */
       export_id: string;
       /**
        * @description Initial export status (running).
@@ -4148,27 +4867,49 @@ interface components {
       project_id: string;
     };
     V1TriggerSecurityScanResponseBody: {
-      /** @description Human-readable status message */
+      /**
+       * @description Human-readable status message
+       * @example Security scan started.
+       */
       message?: string;
-      /** @description Scan invocation ID. Poll GET /v1/projects/{project_id}/security-scans/{scan_id} for status (running | completed | failed) and findings. */
+      /**
+       * @description Scan invocation ID. Poll GET /v1/projects/{project_id}/security-scans/{scan_id} for status (running | completed | failed) and findings.
+       * @example a1b2c3d4-e5f6-7890-abcd-ef1234567890
+       */
       scan_id: string;
-      /** @description One of: started, running, completed. More values may be added; clients must tolerate unknown values. */
+      /**
+       * @description One of: started, running, completed. More values may be added; clients must tolerate unknown values.
+       * @example started
+       */
       status: string;
     };
     V1UnscopedFile: {
-      /** @description Uploaded file ID */
+      /**
+       * @description Uploaded file ID
+       * @example Xy7Kd2Lm9Qp4Rt6Vw8Zc1Bn3Fh5/logo.png
+       */
       file_id: string;
-      /** @description Original file name */
+      /**
+       * @description Original file name
+       * @example logo.png
+       */
       file_name?: string;
-      /** @description MIME type */
+      /**
+       * @description MIME type
+       * @example image/png
+       */
       mime_type?: string;
-      /** @description File type (e.g. user_upload) */
+      /**
+       * @description File type (e.g. user_upload)
+       * @example user_upload
+       */
       type?: string;
     };
     V1UpdateMemberCreditLimitInputBody: {
       /**
        * Format: double
        * @description The member's monthly credit cap. Send a number >= 0 (0 blocks all spend) to set it, or null to clear it (the member then inherits the workspace default).
+       * @example 500
        */
       monthly_credit_limit?: number | null;
       /** @description Workspace ID. */
@@ -4178,6 +4919,7 @@ interface components {
       /**
        * Format: double
        * @description Default monthly credit cap applied to each member without an explicit per-member limit. Send a number >= 0 (0 blocks all member spend) to set it, or null to clear it (members are then bounded only by the workspace balance).
+       * @example 500
        */
       default_monthly_member_credit_limit?: number | null;
       /** @description Workspace ID. */
@@ -4187,6 +4929,7 @@ interface components {
       /**
        * Format: double
        * @description Default monthly credit cap applied to each member without an explicit per-member limit. Send a number >= 0 (0 blocks all member spend) to set it, or null to clear it (members are then bounded only by the workspace balance).
+       * @example 500
        */
       default_monthly_member_credit_limit?: number | null;
     };
@@ -4199,59 +4942,113 @@ interface components {
       start: string;
     };
     V1WorkspaceAuditLogEntry: {
-      /** @description Action name (e.g. workspace.member.added). */
+      /**
+       * @description Action name (e.g. workspace.member.added).
+       * @example workspace.member.role_changed
+       */
       action: string;
-      /** @description Human-readable description of the action, derived from the action name (e.g. Workspace member added). */
+      /**
+       * @description Human-readable description of the action, derived from the action name (e.g. Workspace member added).
+       * @example Workspace member role changed
+       */
       action_description: string;
-      /** @description Display name of the actor at the time of the event. */
+      /**
+       * @description Display name of the actor at the time of the event.
+       * @example Jane Cooper
+       */
       actor_display_name?: string;
-      /** @description User ID of the actor (or system actor ID for non-user actions). */
+      /**
+       * @description User ID of the actor (or system actor ID for non-user actions).
+       * @example Xy7Kd2Lm9Qp4Rt6Vw8Zc1Bn3Fh5
+       */
       actor_id: string;
-      /** @description Actor classification (user, scim, system). */
+      /**
+       * @description Actor classification (user, scim, system).
+       * @example user
+       */
       actor_type?: string;
-      /** @description First-party client the action came from (web, ios, android, desktop-app); absent when the caller sent no platform header. */
+      /**
+       * @description First-party client the action came from (web, ios, android, desktop-app); absent when the caller sent no platform header.
+       * @example web
+       */
       client_platform?: string;
       /** @description Action-specific structured detail payload. */
       details?: {
         [key: string]: unknown;
       };
-      /** @description Event ID. */
+      /**
+       * @description Event ID.
+       * @example 01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       id: string;
-      /** @description IP address that initiated the action. */
+      /**
+       * @description IP address that initiated the action.
+       * @example 203.0.113.42
+       */
       ip_address?: string;
-      /** @description success or failed. */
+      /**
+       * @description success or failed.
+       * @example failed
+       */
       status: string;
-      /** @description Optional message describing the failure cause when status is failed. */
+      /**
+       * @description Optional message describing the failure cause when status is failed.
+       * @example Insufficient permissions
+       */
       status_message?: string;
-      /** @description Display name of the target at the time of the event. */
+      /**
+       * @description Display name of the target at the time of the event.
+       * @example Jane Cooper
+       */
       target_display_name?: string;
-      /** @description ID of the target resource. */
+      /**
+       * @description ID of the target resource.
+       * @example Xy7Kd2Lm9Qp4Rt6Vw8Zc1Bn3Fh5
+       */
       target_id?: string;
-      /** @description Type of the target resource (project, workspace, membership, etc.). */
+      /**
+       * @description Type of the target resource (project, workspace, membership, etc.).
+       * @example membership
+       */
       target_type?: string;
       /**
        * Format: date-time
        * @description When the action occurred.
+       * @example 2026-01-15T09:30:00Z
        */
       timestamp: string;
-      /** @description Group ID linking multi-event flows together. */
+      /**
+       * @description Group ID linking multi-event flows together.
+       * @example 4bf92f3577b34da6a3ce929d0e0e4736
+       */
       trace_group_id?: string;
-      /** @description User agent string for the request. */
+      /**
+       * @description User agent string for the request.
+       * @example Mozilla/5.0
+       */
       user_agent?: string;
     };
     V1WorkspaceAuditLogsBody: {
+      /** @description Items in this page. */
       data: components["schemas"]["V1WorkspaceAuditLogEntry"][] | null;
+      /** @description Pagination cursors for fetching adjacent pages. */
       pagination: components["schemas"]["Pagination"];
     };
     V1WorkspaceCreditHistoryBody: {
+      /** @description Items in this page. */
       data: components["schemas"]["V1CreditHistoryEntry"][] | null;
+      /** @description Pagination cursors for fetching adjacent pages. */
       pagination: components["schemas"]["Pagination"];
       /**
        * Format: int64
        * @description Total entry count, present only on the first page. Capped — see total_is_capped.
+       * @example 42
        */
       total?: number;
-      /** @description True when total reached the count cap and the real total is higher. */
+      /**
+       * @description True when total reached the count cap and the real total is higher.
+       * @example false
+       */
       total_is_capped?: boolean;
     };
     V1WorkspaceCreditsBody: {
@@ -4260,11 +5057,13 @@ interface components {
       /**
        * Format: double
        * @description Daily credit limit for this workspace.
+       * @example 500
        */
       daily_limit: number;
       /**
        * Format: double
        * @description Remaining credits from today's daily grants.
+       * @example 300
        */
       daily_remaining: number;
       /** @description All future grant expiry groups sorted by date (excluding daily/overage). */
@@ -4274,46 +5073,62 @@ interface components {
       /**
        * Format: double
        * @description Credits used in the current billing period (see billing_period for the exact window).
+       * @example 500
        */
       total_billing_period_used: number;
       /**
        * Format: double
        * @description Total credits granted across all active grants.
+       * @example 2000
        */
       total_granted: number;
       /**
        * Format: double
        * @description Total remaining credits across all active grants.
+       * @example 1500
        */
       total_remaining: number;
     };
     V1WorkspaceCreditsExpiringGrant: {
-      /** @description What the expiring credits apply to (e.g. build_time, cloud, ai_gateway). */
+      /**
+       * @description What the expiring credits apply to (e.g. build_time, cloud, ai_gateway).
+       * @example build_time
+       */
       applicability?: string;
       /**
        * Format: double
        * @description Total credits expiring at this date.
+       * @example 1500
        */
       credits: number;
       /**
        * Format: date-time
        * @description When these credits expire.
+       * @example 2026-01-15T09:30:00Z
        */
       expires_at: string;
-      /** @description Display bucket: billing, rollover, topup, commitment, cashback, or granted. */
+      /**
+       * @description Display bucket: billing, rollover, topup, commitment, cashback, or granted.
+       * @example billing
+       */
       grant_type: string;
     };
     V1WorkspaceCreditsGrantTypeBalance: {
-      /** @description Display bucket: billing, daily, rollover, topup, commitment, cashback, or granted. */
+      /**
+       * @description Display bucket: billing, daily, rollover, topup, commitment, cashback, or granted.
+       * @example billing
+       */
       grant_type: string;
       /**
        * Format: double
        * @description Total credits granted for this type.
+       * @example 1500
        */
       granted: number;
       /**
        * Format: double
        * @description Remaining credits for this type.
+       * @example 1200
        */
       remaining: number;
     };
@@ -4321,11 +5136,13 @@ interface components {
       /**
        * Format: date-time
        * @description Data horizon for the edit counts.
+       * @example 2026-01-15T09:30:00Z
        */
       edits_as_of?: string;
       /**
        * Format: date-time
        * @description Data horizon for the visitor counts.
+       * @example 2026-01-15T09:30:00Z
        */
       visitors_as_of?: string;
     };
@@ -4333,6 +5150,7 @@ interface components {
       /**
        * Format: date-time
        * @description Conservative workspace-wide freshness horizon for the risk rollups; individual project rollups may be newer.
+       * @example 2026-01-15T09:30:00Z
        */
       as_of?: string;
       /** @description Finding-catalog counts, dominance-suppressed and severity-ordered. */
@@ -4341,70 +5159,184 @@ interface components {
       summary: components["schemas"]["V1WorkspaceInsightsSummary"];
     };
     V1WorkspaceInsightsEdgeFunction: {
-      /** @description Edge function name. */
+      /**
+       * @description Edge function name.
+       * @example send-welcome-email
+       */
       name: string;
     };
     V1WorkspaceInsightsFinding: {
-      /** @description Finding category (e.g. data, access, exposure). */
+      /**
+       * @description Finding category (e.g. data, access, exposure).
+       * @example data
+       */
       category: string;
-      /** @description Human-readable finding description. */
+      /**
+       * @description Human-readable finding description.
+       * @example A public table has row-level security disabled, exposing all rows to anonymous callers.
+       */
       description: string;
-      /** @description Stable finding-catalog slug (e.g. public_pii_exposure, orphaned_owner). */
+      /**
+       * @description Stable finding-catalog slug (e.g. public_pii_exposure, orphaned_owner).
+       * @example public_pii_exposure
+       */
       id: string;
       /**
        * Format: int64
        * @description Projects matching this finding.
+       * @example 12
        */
       project_count: number;
-      /** @description Review priority: needs_review | review_recommended | no_review_needed. */
+      /**
+       * @description Review priority: needs_review | review_recommended | no_review_needed.
+       * @example needs_review
+       */
       severity: string;
-      /** @description Human-readable finding title. */
+      /**
+       * @description Human-readable finding title.
+       * @example Row-level security disabled on a public table
+       */
       title: string;
     };
     V1WorkspaceInsightsOwner: {
-      /** @description Project owner's display name. */
+      /**
+       * @description Project owner's display name.
+       * @example Jane Cooper
+       */
       display_name?: string;
     };
     V1WorkspaceInsightsProject: {
+      /**
+       * @description Activity bucket: active, inactive, or dead.
+       * @example active
+       */
       activity_group?: string;
+      /** @description Configured connector names. */
       connectors?: string[] | null;
+      /**
+       * @description User-provided project description.
+       * @example Marketing landing page for the Q1 product launch.
+       */
       description?: string;
+      /**
+       * @description Project display name.
+       * @example Acme Landing Page
+       */
       display_name?: string;
+      /** @description Deployed edge functions. */
       edge_functions?: components["schemas"]["V1WorkspaceInsightsEdgeFunction"][] | null;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Total edits over the project's lifetime.
+       * @example 128
+       */
       edit_count: number;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Edits in the last 24 hours.
+       * @example 4
+       */
       edits_24h: number;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Edits in the last 30 days.
+       * @example 67
+       */
       edits_30d: number;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Edits in the last 7 days.
+       * @example 21
+       */
       edits_7d: number;
+      /**
+       * @description AI-generated project description.
+       * @example A single-page marketing site with a hero, feature grid, and signup form.
+       */
       generated_description?: string;
+      /**
+       * @description Project ID.
+       * @example prj_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       id: string;
+      /**
+       * @description Whether the project is published.
+       * @example true
+       */
       is_published?: boolean;
-      /** Format: date-time */
+      /**
+       * Format: date-time
+       * @description When the project was last edited.
+       * @example 2026-01-15T09:30:00Z
+       */
       last_edited_at?: string;
-      /** Format: date-time */
+      /**
+       * Format: date-time
+       * @description When the project was last security-scanned.
+       * @example 2026-01-15T09:30:00Z
+       */
       last_security_scan_at?: string;
       /** @description The reason matching the single applied finding_id, when set. */
       matched_reason?: components["schemas"]["V1WorkspaceInsightsReason"];
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Total chat messages in the project.
+       * @example 56
+       */
       message_count: number;
+      /**
+       * @description Project name.
+       * @example Acme Landing Page
+       */
       name?: string;
+      /**
+       * @description Open Graph preview image URL.
+       * @example https://lovable.dev/cdn/projects/acme-landing-page/og.png
+       */
       og_image_url?: string;
+      /** @description Project owner identity. */
       owner?: components["schemas"]["V1WorkspaceInsightsOwner"];
+      /**
+       * @description Publishing status: external, workspace, or not_published.
+       * @example external
+       */
       publish_visibility?: string;
-      /** @description Review priority: needs_review, review_recommended, no_review_needed, or unscored. */
+      /**
+       * @description Review priority: needs_review, review_recommended, no_review_needed, or unscored.
+       * @example needs_review
+       */
       review_priority?: string;
+      /** @description Risk reasons explaining the review priority. */
       review_priority_explanation: components["schemas"]["V1WorkspaceInsightsReason"][] | null;
+      /** @description Per-project security and activity signals. */
       signals: components["schemas"]["V1WorkspaceInsightsSignals"];
+      /**
+       * @description Live project preview URL.
+       * @example https://acme-landing-page.lovable.app
+       */
       url?: string;
+      /**
+       * @description Project visibility: public, private, or draft.
+       * @example public
+       */
       visibility?: string;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Unique visitors in the last 24 hours.
+       * @example 35
+       */
       visitors_24h: number;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Unique visitors in the last 30 days.
+       * @example 840
+       */
       visitors_30d: number;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Unique visitors in the last 7 days.
+       * @example 210
+       */
       visitors_7d: number;
     };
     V1WorkspaceInsightsProjectsBody: {
@@ -4415,121 +5347,296 @@ interface components {
       /**
        * Format: date-time
        * @description Conservative workspace-wide freshness horizon for the risk rollups; individual project rollups may be newer.
+       * @example 2026-01-15T09:30:00Z
        */
       as_of?: string;
+      /** @description Items in this page. */
       data: components["schemas"]["V1WorkspaceInsightsProject"][] | null;
+      /** @description Pagination cursors for fetching adjacent pages. */
       pagination: components["schemas"]["Pagination"];
       /**
        * Format: int64
        * @description Total matching projects across all pages.
+       * @example 42
        */
       total: number;
     };
     V1WorkspaceInsightsReason: {
+      /**
+       * @description Risk-reason category (e.g. data, access, exposure).
+       * @example data
+       */
       category: string;
+      /**
+       * @description Human-readable explanation of the risk reason.
+       * @example A public table exposes personal data to anonymous callers.
+       */
       detail: string;
-      /** @description Stable risk-reason slug. */
+      /**
+       * @description Stable risk-reason slug.
+       * @example public_pii_exposure
+       */
       id: string;
+      /**
+       * @description Human-readable risk-reason label.
+       * @example Public PII exposure
+       */
       label: string;
-      /** @description Review priority: needs_review | review_recommended | no_review_needed. */
+      /**
+       * @description Review priority: needs_review | review_recommended | no_review_needed.
+       * @example needs_review
+       */
       severity: string;
       /** @description Typed per-reason counts. */
       values?: components["schemas"]["V1WorkspaceInsightsReasonValues"];
     };
     V1WorkspaceInsightsReasonValues: {
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of configured connectors.
+       * @example 2
+       */
       connector_count?: number;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of deployed edge functions.
+       * @example 3
+       */
       edge_function_count?: number;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of error-level security findings.
+       * @example 2
+       */
       error_count?: number;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of info-level security findings.
+       * @example 8
+       */
       info_count?: number;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of open PII findings.
+       * @example 3
+       */
       open_pii_finding_count?: number;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of stored project secrets.
+       * @example 4
+       */
       secret_count?: number;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of users the project is shared with.
+       * @example 6
+       */
       shared_user_count?: number;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of warning-level security findings.
+       * @example 5
+       */
       warning_count?: number;
     };
     V1WorkspaceInsightsReviewPriority: {
       /**
        * Format: int64
        * @description Projects that need review (critical risk).
+       * @example 3
        */
       needs_review: number;
       /**
        * Format: int64
        * @description Projects that don't need review (low or minimal risk).
+       * @example 12
        */
       no_review_needed: number;
       /**
        * Format: int64
        * @description Projects where review is recommended (high or medium risk).
+       * @example 5
        */
       review_recommended: number;
     };
     V1WorkspaceInsightsSignals: {
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of chat attachments.
+       * @example 7
+       */
       chat_attachment_count: number;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of configured connectors.
+       * @example 2
+       */
       connector_count: number;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of deployed edge functions.
+       * @example 3
+       */
       edge_function_count: number;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of error-level security findings.
+       * @example 2
+       */
       error_count: number;
+      /**
+       * @description Whether external-collaborator status could be determined.
+       * @example true
+       */
       external_collaborators_known: boolean;
+      /**
+       * @description Whether the project has any chat attachments.
+       * @example true
+       */
       has_chat_attachment: boolean;
+      /**
+       * @description Whether the project has collaborators outside the workspace.
+       * @example true
+       */
       has_external_collaborators: boolean;
+      /**
+       * @description Whether the project has any detected PII.
+       * @example true
+       */
       has_pii: boolean;
+      /**
+       * @description Whether the project has any uploaded assets.
+       * @example true
+       */
       has_project_asset: boolean;
+      /**
+       * @description Whether the project stores any secrets.
+       * @example true
+       */
       has_project_secret: boolean;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of info-level security findings.
+       * @example 8
+       */
       info_count: number;
+      /**
+       * @description Whether the project has no active owner.
+       * @example false
+       */
       is_orphaned: boolean;
+      /**
+       * @description Whether the project is published to a public (external) audience.
+       * @example true
+       */
       is_public_published: boolean;
+      /**
+       * @description Whether the project is published.
+       * @example true
+       */
       is_published: boolean;
+      /**
+       * @description Whether Lovable Cloud (Supabase) is enabled for the project.
+       * @example true
+       */
       lovable_cloud_enabled: boolean;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of open PII findings.
+       * @example 3
+       */
       open_pii_finding_count: number;
+      /**
+       * @description Whether the project is shared more broadly than recommended.
+       * @example false
+       */
       overshared: boolean;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of uploaded project assets.
+       * @example 10
+       */
       project_asset_count: number;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of stored project secrets.
+       * @example 4
+       */
       project_secret_count: number;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of users the project is shared with.
+       * @example 6
+       */
       shared_user_count: number;
+      /** @description Enabled Supabase auth providers. */
       supabase_auth_providers?: string[] | null;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of Supabase tables with row-level security enabled.
+       * @example 10
+       */
       supabase_rls_enabled_table_count?: number;
-      /** Format: date-time */
+      /**
+       * Format: date-time
+       * @description When the Supabase signals were last fetched.
+       * @example 2026-01-15T09:30:00Z
+       */
       supabase_signals_fetched_at?: string;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of Supabase storage buckets.
+       * @example 2
+       */
       supabase_storage_bucket_count?: number;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of Supabase database tables.
+       * @example 12
+       */
       supabase_table_count?: number;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of error-level supply-chain findings.
+       * @example 1
+       */
       supply_chain_error_count: number;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of info-level supply-chain findings.
+       * @example 4
+       */
       supply_chain_info_count: number;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of warning-level supply-chain findings.
+       * @example 3
+       */
       supply_chain_warning_count: number;
-      /** Format: int64 */
+      /**
+       * Format: int64
+       * @description Number of warning-level security findings.
+       * @example 5
+       */
       warning_count: number;
     };
     V1WorkspaceInsightsStat: {
       /**
        * Format: int64
        * @description Signed change over the delta window.
+       * @example 3
        */
       delta_30d: number;
-      /** @description Human-readable window for delta_30d (e.g. "30 days"). */
+      /**
+       * @description Human-readable window for delta_30d (e.g. "30 days").
+       * @example 30 days
+       */
       delta_window: string;
       /**
        * Format: int64
        * @description Current count.
+       * @example 42
        */
       value: number;
     };
@@ -4544,66 +5651,109 @@ interface components {
       workspace_members: components["schemas"]["V1WorkspaceInsightsStat"];
     };
     V1WorkspaceMember: {
-      /** @description User display name as stored on the membership. */
+      /**
+       * @description User display name as stored on the membership.
+       * @example Jane Cooper
+       */
       display_name?: string;
-      /** @description Member email as stored on the membership. For pending invites this is the invited email. May be absent on legacy membership rows. */
+      /**
+       * @description Member email as stored on the membership. For pending invites this is the invited email. May be absent on legacy membership rows.
+       * @example jane.cooper@acme.com
+       */
       email?: string;
       /**
        * Format: date-time
        * @description When the user was invited.
+       * @example 2026-01-15T09:30:00Z
        */
       invited_at?: string;
       /**
        * Format: date-time
        * @description When the user accepted the invitation. Absent on pending invites.
+       * @example 2026-01-15T09:30:00Z
        */
       joined_at?: string;
       /**
        * Format: double
        * @description Explicit monthly credit cap for this member. Absent means no per-member cap is set and the workspace default applies. Visible for yourself; visible for other members only with permission to view member usage.
+       * @example 500
        */
       monthly_credit_limit?: number;
-      /** @description Workspace role. One of: owner, admin, member, viewer, collaborator. */
+      /**
+       * @description Workspace role. One of: owner, admin, member, viewer, collaborator.
+       * @example admin
+       */
       role: string;
-      /** @description Stable opaque identifier for the entry. For active members this is the user ID; for pending invites this is the Spanner-generated membership row id (never an email-derived value). */
+      /**
+       * @description Stable opaque identifier for the entry. For active members this is the user ID; for pending invites this is the Spanner-generated membership row id (never an email-derived value).
+       * @example Xy7Kd2Lm9Qp4Rt6Vw8Zc1Bn3Fh5
+       */
       user_id: string;
-      /** @description Workspace the membership belongs to. */
+      /**
+       * @description Workspace the membership belongs to.
+       * @example workspace_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       workspace_id: string;
     };
     V1WorkspaceSettingsBody: {
       /**
        * Format: date-time
        * @description End of the current billing period.
+       * @example 2026-02-01T00:00:00Z
        */
       billing_period_end_date?: string;
       /**
        * Format: date-time
        * @description Start of the current billing period.
+       * @example 2026-01-01T00:00:00Z
        */
       billing_period_start_date?: string;
       /**
        * Format: double
        * @description Default monthly credit cap applied to each member who has no explicit per-member limit. Absent when unset (members are bounded only by the workspace balance) or when the caller lacks permission to view workspace usage.
+       * @example 500
        */
       default_monthly_member_credit_limit?: number;
-      /** @description Default visibility applied to new projects. One of: public, private, draft. Absent means the workspace effective default of private. */
+      /**
+       * @description Default visibility applied to new projects. One of: public, private, draft. Absent means the workspace effective default of private.
+       * @example private
+       */
       default_project_visibility?: string;
-      /** @description Whether PII scanning is enabled across project resources. */
+      /**
+       * @description Whether PII scanning is enabled across project resources.
+       * @example true
+       */
       enable_pii: boolean;
-      /** @description Whether SSO is enforced for all members. */
+      /**
+       * @description Whether SSO is enforced for all members.
+       * @example true
+       */
       enforce_sso: boolean;
-      /** @description Workspace ID. */
+      /**
+       * @description Workspace ID.
+       * @example workspace_01jw3k9m2xq8r5v0c7d4e6f2gh
+       */
       id: string;
-      /** @description Workspace display name. */
+      /**
+       * @description Workspace display name.
+       * @example Acme Inc
+       */
       name: string;
       /**
        * Format: int64
        * @description Workspace-specific seat limit when one has been explicitly configured. Absent when the workspace runs on its plan's default (Enterprise workspaces are typically unlimited unless a per-tenant cap is set).
+       * @example 25
        */
       num_seats?: number;
-      /** @description Plan tier. One of: free, pro, business, enterprise. More values may be added; clients must tolerate unknown values. */
+      /**
+       * @description Plan tier. One of: free, pro, business, enterprise. More values may be added; clients must tolerate unknown values.
+       * @example enterprise
+       */
       plan: string;
-      /** @description Restriction on what publish visibilities are allowed: workspace_only or disabled. Absent means no restriction. */
+      /**
+       * @description Restriction on what publish audiences are allowed: org_only, workspace_only, or disabled. Absent means no restriction.
+       * @example workspace_only
+       */
       publishing_policy?: string;
     };
     V1WorkspaceSkillDTO: {
@@ -4623,12 +5773,14 @@ interface components {
     V1WorkspaceUsageBreakdownBody: {
       /** @description The calendar month that each row's total_credits_used_in_billing_period covers. */
       billing_period: components["schemas"]["V1BillingPeriod"];
+      /** @description Items in this page. */
       data: components["schemas"]["V1WorkspaceUsageBreakdownEntry"][] | null;
       /**
        * Format: int64
        * @description Total matching members across all pages.
        */
       member_count: number;
+      /** @description Pagination cursors for fetching adjacent pages. */
       pagination: components["schemas"]["Pagination"];
     };
     V1WorkspaceUsageBreakdownEntry: {
@@ -4671,25 +5823,37 @@ interface components {
       /**
        * Format: double
        * @description Credits attributed to this database subcategory in the bucket.
+       * @example 30
        */
       credits: number;
       /**
        * @description Stable database subcategory key.
+       * @example database_server
        * @enum {string}
        */
       key: "database_server" | "database_storage";
-      /** @description Display label for the database subcategory. */
+      /**
+       * @description Display label for the database subcategory.
+       * @example Database server
+       */
       label: string;
     };
     V1WorkspaceUsageGatewayModel: {
       /**
        * Format: double
        * @description Credits attributed to this model in the bucket.
+       * @example 200
        */
       credits: number;
-      /** @description Model name. */
+      /**
+       * @description Model name.
+       * @example claude-sonnet-4-5
+       */
       name: string;
-      /** @description Model provider, e.g. anthropic, openai. */
+      /**
+       * @description Model provider, e.g. anthropic, openai.
+       * @example anthropic
+       */
       provider: string;
     };
     V1WorkspaceUsageMeBody: {
@@ -4759,12 +5923,14 @@ interface components {
       total: number;
     };
     V1WorkspaceUsageProjectsBody: {
+      /** @description Items in this page. */
       data: components["schemas"]["V1WorkspaceUsageProjectRow"][] | null;
       /**
        * Format: int64
        * @description Number of projects with usage in the window.
        */
       entity_count: number;
+      /** @description Pagination cursors for fetching adjacent pages. */
       pagination: components["schemas"]["Pagination"];
       /** @description The resolved window these rows cover, echoed so callers can see the dates the server applied. */
       period: components["schemas"]["V1UsagePeriod"];
@@ -4775,7 +5941,9 @@ interface components {
       workspace_total: number;
     };
     V1WorkspaceUsageTimeseriesBody: {
+      /** @description Items in this page. */
       data: components["schemas"]["V1WorkspaceUsageTimeseriesBucket"][] | null;
+      /** @description Pagination cursors for fetching adjacent pages. */
       pagination: components["schemas"]["Pagination"];
       /** @description The resolved window these buckets cover, echoed so callers can see the dates and granularity the server applied. */
       period: components["schemas"]["V1UsagePeriod"];
@@ -4864,6 +6032,7 @@ interface components {
       project_id: string;
     };
     WorkspaceAnalyticsResponse: {
+      /** @description Workspace-wide time-series metrics aggregated across all projects. */
       timeSeries: components["schemas"]["TimeSeriesGroup"];
     };
   };
@@ -8560,6 +9729,8 @@ interface operations {
       query?: {
         /** @description Include per-project risk rollup fields (risk_score, risk_level, signals, reasons). Honored only for workspaces with the risk read surface enabled; ignored otherwise. Off by default so the default project list avoids the risk-table joins. */
         include_risk?: boolean;
+        /** @description Skip computing the total: total is returned as -1; has_more still reports whether more results exist. Use for list UIs that paginate on has_more. */
+        skip_count?: boolean;
         /** @description Filter by project creator user ID */
         user_id?: string;
         /** @description Filter by visibility */