@lovable.dev/sdk 1.6.1 → 1.7.5

package/src/generated/paths.ts

@@ -56,7 +56,7 @@ export interface paths {
         /**
          * Query workspace audit logs
          * @deprecated
-         * @description Deprecated compatibility alias. Prefer GET /v1beta/workspaces/{workspace_id}/audit-logs.
+         * @description Deprecated compatibility alias. Pass workspace_id as a query parameter.
          */
         get: operations["get-v1-audit-logs"];
         put?: never;
@@ -1167,6 +1167,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/remix-jobs/{job_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get remix job
+         * @description Returns the status of an async remix started with POST /v1/projects, keyed by the job_id it returned. Poll until status is completed (result.project_id is set) or error (error_message explains the failure). Poll no more than once every 2 seconds and honor Retry-After on 429 responses. Jobs remain queryable while Temporal retains the workflow history; after retention expires this route returns 404. Reusing the same job_id is idempotent and returns the same terminal result.
+         */
+        get: operations["get-v1-remix-jobs-job_id"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/security-scans": {
         parameters: {
             query?: never;
@@ -1805,6 +1825,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/workspaces/{workspace_id}/groups": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List workspace groups
+         * @description Returns the workspace's groups, sorted by name. Use a group's id as the target id of a type "group" audience entry when publishing a project with visibility "custom" via POST or PATCH /v1/projects/{project_id}/publish.
+         */
+        get: operations["get-v1-workspaces-workspace_id-groups"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/workspaces/{workspace_id}/knowledge": {
         parameters: {
             query?: never;
@@ -1998,94 +2038,6 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1beta/projects/{project_id}/cloud": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get project cloud telemetry (Preview)
-         * @description Returns cloud telemetry for a project's database, matching the editor's Cloud settings panel: disk-space usage, compute instance tier, lifecycle status and pause state, region, Postgres version, and resource-pressure alerts. Values are platform measurements cached for up to a few minutes; disk.timestamp reports when the platform measured it. Individual fields are omitted while their lookup is temporarily unavailable.
-         *
-         *     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.
-         */
-        get: operations["get-v1beta-projects-project_id-cloud"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1beta/workspaces/{workspace_id}/audit-logs": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Query workspace audit logs (Preview)
-         * @description Returns workspace audit log entries newest first (event timestamp descending, event ID as the cursor tie-breaker), paginated via an opaque cursor. Pagination and total-count behavior may change before this operation graduates to the stable surface.
-         *
-         *     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.
-         */
-        get: operations["get-v1beta-workspaces-workspace_id-audit-logs"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1beta/workspaces/{workspace_id}/message-exports": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        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.
-         *
-         *     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.
-         */
-        post: operations["post-v1beta-workspaces-workspace_id-message-exports"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1beta/workspaces/{workspace_id}/message-exports/{export_id}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get message export (Preview)
-         * @description Returns an admin or owner's export status and a one-hour signed download URL when the export is complete and unexpired. Status and download 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.
-         */
-        get: operations["get-v1beta-workspaces-workspace_id-message-exports-export_id"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -2107,7 +2059,7 @@ export interface components {
             creator: components["schemas"]["Creator"];
             display_name: string;
             documentation_url: string;
-            /** @description True when at least one client exists for this connector in the workspace */
+            /** @description True when at least one client or provisioned app exists for this connector in the workspace */
             has_clients: boolean;
             id: string;
             is_enabled_for_workspace: boolean;
@@ -2122,9 +2074,25 @@ export 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 +2107,75 @@ export 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"];
+        };
+        CursorListResponseV1WorkspaceGroup: {
+            /** @description Items in this page. */
+            data: components["schemas"]["V1WorkspaceGroup"][] | 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 +2251,39 @@ export 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 +2311,46 @@ export 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 +2362,7 @@ export 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 +2387,25 @@ export 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. Missing channel keys mean unavailable, not zero traffic. */
+            channels?: {
+                [key: string]: components["schemas"]["ChannelAnalytics"];
+            };
+            /** @enum {string} */
+            channelsSource?: "legacy" | "user_app_events";
             lists: components["schemas"]["ListsGroup"];
             timeSeries: components["schemas"]["TimeSeriesGroup"];
         };
@@ -2367,7 +2418,10 @@ export 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 +2430,62 @@ export 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 +2519,75 @@ export 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 +2613,19 @@ export 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 +2639,15 @@ export 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 +2661,40 @@ export 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 +2707,165 @@ export 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 Copy project Files. Defaults to false. Requires edit access to the original project; view-only access or a public remix link is not enough. Omitted or false skips Files; true returns 403 without edit access. */
+            include_files?: boolean;
+            /**
+             * @description Copy chat history. Defaults to false. Requires edit access to the original project; view-only access or a public remix link is not enough.
+             * @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: {
@@ -2673,6 +2915,18 @@ export interface components {
             /** @description Published project URL. Set once status is completed. */
             url?: string;
         };
+        PublicV1RemixJobOutputBody: {
+            /** @description Machine-readable failure cause, present only for recognized failures */
+            error_code?: string;
+            /** @description Safe failure summary when the remix job fails */
+            error_message?: string;
+            /** @description Remix result, present when completed */
+            result?: components["schemas"]["V1RemixProgressResult"];
+            /** @description Job status: preparing, running, completed, or error. More values may be added; clients must tolerate unknown values. */
+            status: string;
+            /** @description Current step details when available */
+            step?: components["schemas"]["RemixJobStepInfo"];
+        };
         PublicV1SendMessageInputBody: {
             /**
              * @description Continuation override: force (skip cache TTL and token checks), fresh_build (force prompt rebuild), or allow_expired_cache (skip cache TTL only)
@@ -2730,26 +2984,44 @@ export 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 +3029,64 @@ export 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 +3103,15 @@ export 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;
@@ -2843,6 +3142,8 @@ export interface components {
             app_visitors_7d?: number;
             category?: string;
             /** Format: date-time */
+            commit_time?: string;
+            /** Format: date-time */
             created_at?: string;
             created_by?: string;
             /** Format: date-time */
@@ -2935,12 +3236,14 @@ export interface components {
             documentation_url: string;
             /** @description True when at least one connection exists for this connector in the workspace */
             has_connections: boolean;
-            /** @description True when at least one of this connector's available auth methods would meter a new connection against the workspace's credits */
-            has_metered_option?: boolean;
             id: string;
             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;
+            /** @description Provider pricing page; set for metered connectors */
+            pricing_url?: string;
             promotion?: components["schemas"]["StandardConnectorPromotion"];
             /** @description Search keywords (empty array when none) */
             searchTags: string[];
@@ -2951,6 +3254,8 @@ export interface components {
              * @enum {string}
              */
             source?: "native" | "user_defined";
+            /** @description True when the connector receives provider webhooks and delivers them to the connection's inbound project */
+            supports_inbound?: boolean;
             terms_url?: string;
             /**
              * @description Product vendor for catalog filtering
@@ -2983,20 +3288,28 @@ export 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 +3334,26 @@ export 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"];
@@ -3039,6 +3368,8 @@ export interface components {
             cost_credits?: number;
             /** @description Associated edit ID */
             edit_id?: string;
+            /** @description Why the turn failed, only present when status is error */
+            error?: components["schemas"]["V1MessageError"];
             /** @description AI response message ID */
             message_id: string;
             /** @description AI response status (awaiting_input, completed, stopped, error) */
@@ -3070,6 +3401,8 @@ export interface components {
             token?: string;
             /** @description MCP server URL (required for direct and network_transport connections; optional only for legacy relay fields) */
             url?: string;
+            /** @description Route all traffic to this custom MCP server through Lovable's published static egress IP ranges */
+            use_egress_proxy?: boolean;
         };
         V1AvailableConnectorEntry: {
             /** @description Category (e.g. Development, Design) */
@@ -3107,61 +3440,80 @@ export 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 +3521,31 @@ export 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).
+             * @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.
+             * @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 +3553,7 @@ export 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 +3565,31 @@ export 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 +3598,32 @@ export 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 +3636,7 @@ export 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 +3644,13 @@ export 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 +3685,22 @@ export 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 +3741,117 @@ export 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 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 +3874,35 @@ export 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 +3983,11 @@ export 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: {
@@ -3648,46 +4113,11 @@ export interface components {
             /** @description Pagination metadata */
             pagination: components["schemas"]["Pagination"];
         };
-        V1MessageExportStatus: {
-            /**
-             * Format: int64
-             * @description Compressed archive size in bytes.
-             */
-            archive_size_bytes?: number;
-            /**
-             * Format: date-time
-             * @description When the export reached a terminal state.
-             */
-            completed_at?: string;
-            /**
-             * Format: date-time
-             * @description When the export was requested.
-             */
-            created_at: string;
-            /** @description One-hour signed URL, present while a completed export has not expired. */
-            download_url?: string;
-            /**
-             * Format: date-time
-             * @description When the completed file is deleted.
-             */
-            expires_at?: string;
-            /** @description Export ID. */
-            export_id: string;
-            /**
-             * Format: int64
-             * @description Number of messages in a completed export.
-             */
-            message_count?: number;
-            /**
-             * Format: int64
-             * @description Number of projects represented in a completed export.
-             */
-            project_count?: number;
-            /**
-             * @description Current export status.
-             * @enum {string}
-             */
-            status: "running" | "completed" | "failed" | "expired";
+        V1MessageError: {
+            /** @description Stable error code identifying the failure (e.g. PRIMARY_LLM_REQUEST_REJECTED) */
+            code: string;
+            /** @description Sanitized human-readable explanation of the failure */
+            message: string;
         };
         V1MessageListItem: {
             /** @description Message text content */
@@ -3719,6 +4149,8 @@ export interface components {
             created_at: string;
             /** @description Associated edit ID, if any */
             edit_id?: string;
+            /** @description Why the turn failed, only present for assistant messages when status is error */
+            error?: components["schemas"]["V1MessageError"];
             /** @description Message ID */
             message_id: string;
             /** @description Why the queue is paused (user, hitl_tool, out_of_credits, server_error) */
@@ -3743,108 +4175,54 @@ export interface components {
             /** @description Project IDs to move into the folder */
             project_ids: string[] | null;
         };
-        V1ProjectCloudBody: {
-            /** @description Disk-space telemetry. Omitted while the measurement is temporarily unavailable; retry later. */
-            disk?: components["schemas"]["V1ProjectCloudDisk"];
-            /** @description Cloud environment these values describe. */
-            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). */
-            instance_tier_label: string;
-            /** @description Why the instance was paused (e.g. credit_limit), when recorded. */
-            pause_reason?: string;
-            /** @description Postgres major/minor version. Omitted while the lookup is temporarily unavailable. */
-            postgres_version?: string;
-            /** @description Region the database runs in. Omitted while the lookup is temporarily unavailable. */
-            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"];
-            /**
-             * @description Database instance lifecycle status. INACTIVE means paused. Cached for up to a minute; omitted while the lookup is temporarily unavailable.
-             * @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. */
-            user_paused: boolean;
-        };
-        V1ProjectCloudDisk: {
-            /**
-             * Format: int64
-             * @description Provisioned size of the database volume in bytes.
-             */
-            size_bytes: number;
-            /**
-             * Format: date-time
-             * @description When the platform measured these values. Measurements refresh periodically; use this to judge data age.
-             */
-            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.
-             */
-            used_bytes: number;
-        };
-        V1ProjectCloudResourcePressure: {
-            /** @description Per-resource pressure signals. Alerts reset when the instance is resized. */
-            resources: components["schemas"]["V1ProjectCloudResourceSignal"][] | null;
-            /**
-             * Format: int64
-             * @description Size of the trailing window these signals cover.
-             */
-            window_hours: number;
-        };
-        V1ProjectCloudResourceSignal: {
-            /**
-             * Format: int64
-             * @description Hours within the window that raised a pressure alert.
-             */
-            alert_hours: number;
-            /** @description Human-readable resource name. */
-            label: string;
-            /**
-             * Format: date-time
-             * @description Most recent pressure alert in the window, if any.
-             */
-            latest_alert_at?: string;
-            /**
-             * Format: double
-             * @description Reported value of the most recent alert, if any.
-             */
-            latest_value?: number;
-            /** @description Resource under pressure: cpu, memory, or disk_io. */
-            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 +4246,115 @@ export 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: {
@@ -3936,7 +4374,9 @@ export interface components {
             description?: string;
             /** @description Copy custom knowledge (instructions) to the new project */
             include_custom_knowledge?: boolean;
-            /** @description Copy chat history to the new project */
+            /** @description Copy project Files. Defaults to false. Requires edit access to the original project; view-only access or a public remix link is not enough. Omitted or false skips Files; true returns 403 without edit access. */
+            include_files?: boolean;
+            /** @description Copy chat history. Defaults to false. Requires edit access to the original project; view-only access or a public remix link is not enough. */
             include_history?: boolean;
             /** @description Initial headless chat message to send after remix */
             initial_message?: string;
@@ -3983,33 +4423,82 @@ export 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 +4512,87 @@ export 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: {
@@ -4124,51 +4662,54 @@ export interface components {
             /** @description Knowledge content (markdown). Max 10,000 characters. */
             content: string;
         };
-        V1StartMessageExportInputBody: {
-            /** @description Exclusive RFC3339 end time. Defaults to the request time. */
-            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. */
-            project_id?: string;
-            /** @description Inclusive RFC3339 start time. Defaults to 90 days before end_date. */
-            start_date?: string;
-            /** @description Export only messages sent by this user. May be combined with project_id; both filters must match. */
-            user_id?: string;
-        };
-        V1StartMessageExportOutputBody: {
-            /** @description Export ID used to poll status. */
-            export_id: string;
-            /**
-             * @description Initial export status (running).
-             * @enum {string}
-             */
-            status: "running";
-        };
         V1TriggerSecurityScanInputBody: {
             /** @description Project ID */
             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 +4719,7 @@ export 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 +4729,7 @@ export 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 +4742,113 @@ export 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 +4857,13 @@ export 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,58 +4873,121 @@ export 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;
         };
+        V1WorkspaceGroup: {
+            /**
+             * Format: date-time
+             * @description When the group was created.
+             * @example 2026-01-15T09:30:00Z
+             */
+            created_at: string;
+            /**
+             * @description Group description. Absent when not set.
+             * @example Platform and infrastructure engineers
+             */
+            description?: string;
+            /**
+             * @description Group ID. Use as the target id of a type "group" audience entry when publishing with visibility "custom" via POST or PATCH /v1/projects/{project_id}/publish.
+             * @example engineering_workspace_01jw3k9m2xq8r5v0c7d4e6f2gh
+             */
+            id: string;
+            /**
+             * Format: int64
+             * @description Number of members in the group: active members, pending members, and invited users who have not signed up yet.
+             * @example 12
+             */
+            member_count: number;
+            /**
+             * @description Group display name, unique within the workspace.
+             * @example Engineering
+             */
+            name: string;
+            /**
+             * @description External ID assigned by the SCIM identity provider. Present only on SCIM-provisioned groups.
+             * @example 00g1a2b3c4D5E6F7g8h9
+             */
+            scim_external_id?: string;
+            /**
+             * Format: date-time
+             * @description When the group was last updated.
+             * @example 2026-01-15T09:30:00Z
+             */
+            updated_at: string;
+            /**
+             * @description Workspace the group belongs to.
+             * @example workspace_01jw3k9m2xq8r5v0c7d4e6f2gh
+             */
+            workspace_id: string;
+        };
         V1WorkspaceInsightsActivityFreshness: {
             /**
              * 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 +4995,7 @@ export 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 +5004,184 @@ export 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 +5192,296 @@ export 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 +5496,123 @@ export 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;
+            /** @description Groups the member belongs to, sorted by group name. Never truncated: a member in many groups returns all of them, so response size scales with group membership. Present whenever the request asks for include=groups, empty for a member in no groups; absent otherwise. */
+            groups?: components["schemas"]["V1WorkspaceMemberGroup"][];
             /**
              * 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;
         };
+        V1WorkspaceMemberGroup: {
+            /**
+             * @description Group ID, as returned by GET /v1/workspaces/{workspace_id}/groups.
+             * @example engineering_workspace_01jw3k9m2xq8r5v0c7d4e6f2gh
+             */
+            id: string;
+            /**
+             * @description Group display name.
+             * @example Engineering
+             */
+            name: 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 +5632,14 @@ export 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 +5682,37 @@ export 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 +5782,14 @@ export 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 +5800,9 @@ export 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"];
@@ -4857,6 +5884,11 @@ export interface components {
             skill: components["schemas"]["V1WorkspaceSkillDTO"];
         };
         VisibilityChangeInfo: {
+            /**
+             * Format: date-time
+             * @description Firestore commit time of the visibility write; the project's revision token for client caches
+             */
+            commit_time?: string;
             /** @enum {string} */
             new_visibility: "public" | "private" | "draft" | "workspace_view";
             /** @enum {string} */
@@ -4864,6 +5896,7 @@ export interface components {
             project_id: string;
         };
         WorkspaceAnalyticsResponse: {
+            /** @description Workspace-wide time-series metrics aggregated across all projects. */
             timeSeries: components["schemas"]["TimeSeriesGroup"];
         };
     };
@@ -5535,6 +6568,8 @@ export interface operations {
                 sort_order?: "asc" | "desc";
                 /** @description Filter by SCIM provisioning status. Empty = all members, 'managed' = only SCIM-provisioned members, 'unmanaged' = only members not managed by SCIM. */
                 scim_managed?: "managed" | "unmanaged";
+                /** @description Comma-separated optional expansions. Valid values: groups. Unknown values return 400, but a misspelled parameter *name* is ignored rather than rejected (the response carries X-Lovable-Unknown-Query-Params), so check the header if an expansion you asked for is missing. Expansions cost extra reads, so each response field is absent unless asked for. */
+                include?: string;
             };
             header?: never;
             path?: never;
@@ -5879,7 +6914,7 @@ export interface operations {
                 /** @description Filter by project type. library returns design-system libraries; template returns non-library templates. */
                 type?: "" | "project" | "library" | "template" | "all";
                 /** @description Search query */
-                q?: string;
+                query?: string;
                 /** @description Maximum number of projects to return */
                 limit?: number;
                 /** @description Opaque pagination cursor returned by the previous page */
@@ -5950,6 +6985,7 @@ export interface operations {
             /** @description Accepted */
             202: {
                 headers: {
+                    Location?: string;
                     [name: string]: unknown;
                 };
                 content: {
@@ -6074,10 +7110,6 @@ export interface operations {
                 start_date?: string;
                 /** @description End date in RFC 3339 format (e.g. 2026-04-08T00:00:00Z). Required when series=historical. */
                 end_date?: string;
-                /** @description Deprecated alias for start_date. */
-                startDate?: string;
-                /** @description Deprecated alias for end_date. */
-                endDate?: string;
                 /** @description Time bucket size for series=historical: hourly or daily (default: daily). */
                 granularity?: string;
             };
@@ -7157,6 +8189,38 @@ export interface operations {
             };
         };
     };
+    "get-v1-remix-jobs-job_id": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Remix job ID returned by POST /v1/projects */
+                job_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PublicV1RemixJobOutputBody"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
     "get-v1-security-scans": {
         parameters: {
             query: {
@@ -7635,10 +8699,6 @@ export interface operations {
                 start_date?: string;
                 /** @description End date in RFC 3339 format (e.g. 2026-07-08T00:00:00Z). Required. */
                 end_date?: string;
-                /** @description Deprecated alias for start_date. */
-                startDate?: string;
-                /** @description Deprecated alias for end_date. */
-                endDate?: string;
                 /** @description Time bucket size: hourly or daily (default: daily) */
                 granularity?: "hourly" | "daily";
             };
@@ -8439,6 +9499,43 @@ export interface operations {
             };
         };
     };
+    "get-v1-workspaces-workspace_id-groups": {
+        parameters: {
+            query?: {
+                /** @description Maximum number of items to return */
+                limit?: number;
+                /** @description Opaque pagination cursor returned by the previous page */
+                cursor?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Workspace ID */
+                workspace_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CursorListResponseV1WorkspaceGroup"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorModel"];
+                };
+            };
+        };
+    };
     "get-v1-workspaces-workspace_id-knowledge": {
         parameters: {
             query?: never;
@@ -8526,6 +9623,8 @@ export interface operations {
                 sort_order?: "asc" | "desc";
                 /** @description Filter by SCIM provisioning status. Empty = all members, 'managed' = only SCIM-provisioned members, 'unmanaged' = only members not managed by SCIM. */
                 scim_managed?: "managed" | "unmanaged";
+                /** @description Comma-separated optional expansions. Valid values: groups. Unknown values return 400, but a misspelled parameter *name* is ignored rather than rejected (the response carries X-Lovable-Unknown-Query-Params), so check the header if an expansion you asked for is missing. Expansions cost extra reads, so each response field is absent unless asked for. */
+                include?: string;
             };
             header?: never;
             path: {
@@ -8561,6 +9660,8 @@ export 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 */
@@ -8579,16 +9680,16 @@ export interface operations {
                 sort_by?: "name" | "created_at" | "last_edited_at" | "last_viewed_at" | "relevance" | "most_visitors_24h" | "most_visitors_7d" | "most_visitors_30d" | "most_edited_24h" | "most_edited_7d" | "most_edited_30d" | "trending" | "risk" | "design_system_published";
                 /** @description Sort order */
                 sort_order?: "asc" | "desc";
-                /** @description Maximum number of projects to return */
-                limit?: number;
-                /** @description Offset for pagination */
-                offset?: number;
                 /** @description Only return projects viewed by the current user */
                 viewed_by_me?: boolean;
                 /** @description Group results by activity tier: active (14d), inactive (60d), dead */
                 group_by_activity?: boolean;
                 /** @description Which fields to search: empty for all (default), 'name' for project name only */
                 search_fields?: "" | "name";
+                /** @description Maximum number of projects to return */
+                limit?: number;
+                /** @description Offset for pagination */
+                offset?: number;
             };
             header?: never;
             path: {
@@ -9000,158 +10101,4 @@ export interface operations {
             };
         };
     };
-    "get-v1beta-projects-project_id-cloud": {
-        parameters: {
-            query?: {
-                /** @description Cloud environment to read. Defaults to production. */
-                environment?: "production" | "development";
-            };
-            header?: never;
-            path: {
-                /** @description Project ID */
-                project_id: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description OK */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["V1ProjectCloudBody"];
-                };
-            };
-            /** @description Error */
-            default: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/problem+json": components["schemas"]["ErrorModel"];
-                };
-            };
-        };
-    };
-    "get-v1beta-workspaces-workspace_id-audit-logs": {
-        parameters: {
-            query?: {
-                /** @description Maximum results per page. */
-                limit?: number;
-                /** @description Opaque cursor returned by a previous page; omit for the first page. */
-                cursor?: string;
-                /** @description Comma-separated audit-log action filter (exact match, e.g. workspace.member.added). */
-                actions?: string;
-                /** @description Comma-separated list of actor user IDs to filter by. */
-                actor_ids?: string;
-                /** @description Comma-separated list of target resource IDs to filter by. */
-                target_ids?: string;
-                /** @description Token-based search on target_id and target_display_name. Minimum 3 characters. */
-                search?: string;
-                /** @description RFC3339 inclusive start of the time range. Defaults to 30 days ago. When paginating with cursor, pass an explicit start_date so the default lower bound does not drift between pages. */
-                start_date?: string;
-                /** @description RFC3339 inclusive end of the time range. Defaults to now. */
-                end_date?: string;
-            };
-            header?: never;
-            path: {
-                /** @description Workspace ID */
-                workspace_id: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description OK */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["V1WorkspaceAuditLogsBody"];
-                };
-            };
-            /** @description Error */
-            default: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/problem+json": components["schemas"]["ErrorModel"];
-                };
-            };
-        };
-    };
-    "post-v1beta-workspaces-workspace_id-message-exports": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                /** @description Workspace ID */
-                workspace_id: string;
-            };
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["V1StartMessageExportInputBody"];
-            };
-        };
-        responses: {
-            /** @description Accepted */
-            202: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["V1StartMessageExportOutputBody"];
-                };
-            };
-            /** @description Error */
-            default: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/problem+json": components["schemas"]["ErrorModel"];
-                };
-            };
-        };
-    };
-    "get-v1beta-workspaces-workspace_id-message-exports-export_id": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                /** @description Workspace ID */
-                workspace_id: string;
-                /** @description Export ID returned when the export was started. */
-                export_id: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description OK */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["V1MessageExportStatus"];
-                };
-            };
-            /** @description Error */
-            default: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/problem+json": components["schemas"]["ErrorModel"];
-                };
-            };
-        };
-    };
 }