@inneropen/marvin-sdk 3.0.0 → 3.1.0-next.1

package/dist/index-BLIrbIHf.d.cts

@@ -0,0 +1,3409 @@
+interface components {
+    schemas: {
+        /**
+         * APIClientCreate
+         * @description Schema for creating a new API client.
+         */
+        APIClientCreate: {
+            /** Name */
+            name: string;
+            /** Slug */
+            slug?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Permissions */
+            permissions?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        /**
+         * APIClientRead
+         * @description Full schema for reading an API client.
+         */
+        APIClientRead: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /** Name */
+            name: string;
+            /** Slug */
+            slug: string;
+            /** Description */
+            description?: string | null;
+            /** Enabled */
+            enabled: boolean;
+            /**
+             * Groupid
+             * Format: uuid4
+             */
+            groupId: string;
+            /** Permissions */
+            permissions: {
+                [key: string]: unknown;
+            };
+            /** Lastusedat */
+            lastUsedAt?: string | null;
+            /** Createdat */
+            createdAt?: string | null;
+            /** Updateat */
+            updateAt?: string | null;
+            /** Revokedat */
+            revokedAt?: string | null;
+        };
+        /**
+         * APIClientUpdate
+         * @description Schema for updating an API client.
+         */
+        APIClientUpdate: {
+            /** Name */
+            name?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Permissions */
+            permissions?: {
+                [key: string]: unknown;
+            } | null;
+            /** Enabled */
+            enabled?: boolean | null;
+        };
+        /**
+         * APIClientWithToken
+         * @description Response when creating or rotating an API client token - includes plaintext token ONCE.
+         */
+        APIClientWithToken: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /**
+             * Groupid
+             * Format: uuid4
+             */
+            groupId: string;
+            /** Name */
+            name: string;
+            /** Slug */
+            slug: string;
+            /** Description */
+            description?: string | null;
+            /** Permissions */
+            permissions: {
+                [key: string]: unknown;
+            };
+            /** Token */
+            token: string;
+            /** Enabled */
+            enabled: boolean;
+            /** Createdat */
+            createdAt?: string | null;
+        };
+        /**
+         * AdminAboutInfo
+         * @description Schema for detailed application information, extending `AppInfo` with
+         *     additional details relevant for administrators.
+         */
+        AdminAboutInfo: {
+            /** Production */
+            production: boolean;
+            /** Version */
+            version: string;
+            /** Demostatus */
+            demoStatus: boolean;
+            /** Allowsignup */
+            allowSignup: boolean;
+            /** Defaultgroupslug */
+            defaultGroupSlug?: string | null;
+            /** Defaulthouseholdslug */
+            defaultHouseholdSlug?: string | null;
+            /** Enableoidc */
+            enableOidc: boolean;
+            /** Oidcredirect */
+            oidcRedirect: boolean;
+            /** Oidcprovidername */
+            oidcProviderName: string;
+            /** Enableopenai */
+            enableOpenai: boolean;
+            /** Enableopenaiimageservices */
+            enableOpenaiImageServices: boolean;
+            /** Versionlatest */
+            versionLatest: string;
+            /** Apiport */
+            apiPort: number;
+            /** Apidocs */
+            apiDocs: boolean;
+            /** Dbtype */
+            dbType: string;
+            /** Dburl */
+            dbUrl?: string | null;
+            /** Defaultgroup */
+            defaultGroup: string;
+            /** Buildid */
+            buildId: string;
+        };
+        /**
+         * AppInfo
+         * @description Schema for general, publicly accessible application information.
+         */
+        AppInfo: {
+            /** Production */
+            production: boolean;
+            /** Version */
+            version: string;
+        };
+        /**
+         * AppStatistics
+         * @description Schema for comprehensive application statistics.
+         */
+        AppStatistics: {
+            /** Totalusers */
+            totalUsers: number;
+            /** Totalgroups */
+            totalGroups: number;
+            /** Totalentries */
+            totalEntries: number;
+            /** Totalcollections */
+            totalCollections: number;
+            /** Totalentrytypes */
+            totalEntryTypes: number;
+            /** Totalassets */
+            totalAssets: number;
+            /** Totalresources */
+            totalResources: number;
+            /** Totalapitokens */
+            totalApiTokens: number;
+            /** Totalapiclients */
+            totalApiClients: number;
+            /** Totalwebhooks */
+            totalWebhooks: number;
+        };
+        /**
+         * AppTheme
+         * @description Schema defining the complete color system for the application's light and dark themes.
+         *     Includes background, surface, text, border, and accent colors.
+         *     Actual color values are defined in core/settings/theme.py
+         */
+        AppTheme: {
+            /** Lightbg */
+            lightBg: string;
+            /** Lightpanel */
+            lightPanel: string;
+            /** Lightpanelsecondary */
+            lightPanelSecondary: string;
+            /** Lighttext */
+            lightText: string;
+            /** Lighttextmuted */
+            lightTextMuted: string;
+            /** Lightborder */
+            lightBorder: string;
+            /** Lightprimary */
+            lightPrimary: string;
+            /** Lightaccent */
+            lightAccent: string;
+            /** Lightsecondary */
+            lightSecondary: string;
+            /** Lightsuccess */
+            lightSuccess: string;
+            /** Lightinfo */
+            lightInfo: string;
+            /** Lightwarning */
+            lightWarning: string;
+            /** Lighterror */
+            lightError: string;
+            /** Darkbg */
+            darkBg: string;
+            /** Darkpanel */
+            darkPanel: string;
+            /** Darkpanelsecondary */
+            darkPanelSecondary: string;
+            /** Darktext */
+            darkText: string;
+            /** Darktextmuted */
+            darkTextMuted: string;
+            /** Darkborder */
+            darkBorder: string;
+            /** Darkprimary */
+            darkPrimary: string;
+            /** Darkaccent */
+            darkAccent: string;
+            /** Darksecondary */
+            darkSecondary: string;
+            /** Darksuccess */
+            darkSuccess: string;
+            /** Darkinfo */
+            darkInfo: string;
+            /** Darkwarning */
+            darkWarning: string;
+            /** Darkerror */
+            darkError: string;
+        };
+        /**
+         * AssetRead
+         * @description Full schema for reading an asset.
+         */
+        AssetRead: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /** Slug */
+            slug: string;
+            /** Name */
+            name: string;
+            /** Mimetype */
+            mimeType: string;
+            /** Alttext */
+            altText?: string | null;
+            /** Originalfilename */
+            originalFilename: string;
+            /** Filename */
+            filename: string;
+            /** Extension */
+            extension: string;
+            /** Filesize */
+            fileSize: number;
+            /**
+             * Assettype
+             * @enum {string}
+             */
+            assetType: "image" | "document" | "video" | "audio" | "archive" | "svg" | "other";
+            /** Checksum */
+            checksum: string;
+            /** Width */
+            width?: number | null;
+            /** Height */
+            height?: number | null;
+            /** Orientation */
+            orientation?: number | null;
+            /** Storageprovider */
+            storageProvider: string;
+            /** Storagekey */
+            storageKey: string;
+            /** Publicurl */
+            publicUrl?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Metadata */
+            metadata_?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Uploadedby
+             * Format: uuid4
+             */
+            uploadedBy: string;
+        };
+        /**
+         * AssetUpdate
+         * @description Schema for updating editable asset fields.
+         */
+        AssetUpdate: {
+            /** Slug */
+            slug?: string | null;
+            /** Name */
+            name?: string | null;
+            /** Alt Text */
+            alt_text?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Metadata */
+            metadata?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        /**
+         * AuthMethod
+         * @description Enumeration for the authentication methods a user can be associated with.
+         * @enum {string}
+         */
+        AuthMethod: "MARVIN" | "LDAP" | "OIDC";
+        /** Body_get_token_api_auth_token_post */
+        Body_get_token_api_auth_token_post: {
+            /**
+             * Username
+             * @default
+             */
+            username: string;
+            /**
+             * Password
+             * @default
+             */
+            password: string;
+            /**
+             * Remember Me
+             * @default false
+             */
+            remember_me: boolean;
+        };
+        /** Body_upload_asset_api_platform_assets_upload_post */
+        Body_upload_asset_api_platform_assets_upload_post: {
+            /**
+             * File
+             * Format: binary
+             */
+            file: string;
+            /** Slug */
+            slug: string;
+            /** Name */
+            name: string;
+            /** Alt Text */
+            alt_text?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Metadata */
+            metadata?: string | null;
+        };
+        /**
+         * ChangePassword
+         * @description Schema for a password change request.
+         *     Requires the user's current password and the new password (min length 8).
+         */
+        ChangePassword: {
+            /**
+             * Currentpassword
+             * @default
+             */
+            currentPassword: string;
+            /** Newpassword */
+            newPassword: string;
+        };
+        /**
+         * CheckAppConfig
+         * @description Schema representing the status of various critical application configurations.
+         *     Used to quickly assess if key features are configured and ready for use.
+         */
+        CheckAppConfig: {
+            /** Emailready */
+            emailReady: boolean;
+            /** Ldapready */
+            ldapReady: boolean;
+            /** Oidcready */
+            oidcReady: boolean;
+            /** Enableopenai */
+            enableOpenai: boolean;
+            /** Appriseready */
+            appriseReady: boolean;
+            /** Baseurlset */
+            baseUrlSet: boolean;
+            /** Isuptodate */
+            isUpToDate: boolean;
+        };
+        /**
+         * CollectionCreate
+         * @description Schema for creating a new collection.
+         */
+        CollectionCreate: {
+            /** Name */
+            name: string;
+            /** Slug */
+            slug?: string | null;
+            /** Description */
+            description?: string | null;
+            /**
+             * Sortorder
+             * @default 0
+             */
+            sortOrder: number;
+            /** Icon */
+            icon?: string | null;
+            /** Color */
+            color?: string | null;
+            /**
+             * Issmart
+             * @default false
+             */
+            isSmart: boolean;
+            /** Smartrules */
+            smartRules?: {
+                [key: string]: unknown;
+            } | null;
+            /** Metadatajson */
+            metadataJson?: {
+                [key: string]: unknown;
+            } | null;
+            /** Entryids */
+            entryIds?: string[] | null;
+        };
+        /**
+         * CollectionRead
+         * @description Full schema for reading a collection.
+         */
+        CollectionRead: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /** Name */
+            name: string;
+            /** Slug */
+            slug: string;
+            /** Description */
+            description?: string | null;
+            /** Sortorder */
+            sortOrder: number;
+            /** Icon */
+            icon?: string | null;
+            /** Color */
+            color?: string | null;
+            /** Issmart */
+            isSmart: boolean;
+            /** Createdat */
+            createdAt?: string | null;
+            /** Updateat */
+            updateAt?: string | null;
+            /**
+             * Groupid
+             * Format: uuid4
+             */
+            groupId: string;
+            /** Smartrules */
+            smartRules?: {
+                [key: string]: unknown;
+            } | null;
+            /** Metadatajson */
+            metadataJson?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        /**
+         * CollectionUpdate
+         * @description Schema for updating a collection.
+         */
+        CollectionUpdate: {
+            /** Name */
+            name?: string | null;
+            /** Slug */
+            slug?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Sortorder */
+            sortOrder?: number | null;
+            /** Icon */
+            icon?: string | null;
+            /** Color */
+            color?: string | null;
+            /** Issmart */
+            isSmart?: boolean | null;
+            /** Smartrules */
+            smartRules?: {
+                [key: string]: unknown;
+            } | null;
+            /** Metadatajson */
+            metadataJson?: {
+                [key: string]: unknown;
+            } | null;
+            /** Entryids */
+            entryIds?: string[] | null;
+        };
+        /**
+         * EmailInitationResponse
+         * @description Schema for the response after attempting to send an email invitation.
+         *     Indicates success or failure and provides an error message if applicable.
+         */
+        EmailInitationResponse: {
+            /** Success */
+            success: boolean;
+            /** Error */
+            error?: string | null;
+        };
+        /**
+         * EmailInvitation
+         * @description Schema for the request body when sending an email invitation.
+         *     Contains the recipient's email and the invitation token string.
+         */
+        EmailInvitation: {
+            /** Email */
+            email: string;
+            /** Token */
+            token: string;
+        };
+        /**
+         * EmailReady
+         * @description Schema indicating the readiness of the email (SMTP) service.
+         */
+        EmailReady: {
+            /** Ready */
+            ready: boolean;
+        };
+        /**
+         * EmailSuccess
+         * @description Schema for the response when an email operation (like sending a test email) is attempted.
+         *     Indicates success or failure and provides an error message if applicable.
+         */
+        EmailSuccess: {
+            /** Success */
+            success: boolean;
+            /** Error */
+            error?: string | null;
+        };
+        /**
+         * EmailTemplateCreate
+         * @description Schema for creating a new email template.
+         */
+        EmailTemplateCreate: {
+            /**
+             * Templatetype
+             * @description Type of email (invitation, password_reset, notification, test)
+             */
+            templateType: string;
+            /**
+             * Groupid
+             * @description Workspace ID - null for system-wide templates
+             */
+            groupId?: string | null;
+            /**
+             * Name
+             * @description Human-readable template name
+             */
+            name: string;
+            /**
+             * Description
+             * @description Description of when this template is used
+             */
+            description?: string | null;
+            /**
+             * Subject
+             * @description Email subject line - supports Jinja2 variables
+             */
+            subject: string;
+            /**
+             * Headertext
+             * @description Header text (structured mode with default.html)
+             */
+            headerText?: string | null;
+            /**
+             * Messagetop
+             * @description Top message (structured mode with default.html)
+             */
+            messageTop?: string | null;
+            /**
+             * Messagebottom
+             * @description Bottom message (structured mode with default.html)
+             */
+            messageBottom?: string | null;
+            /**
+             * Buttontext
+             * @description Button text (structured mode with default.html)
+             */
+            buttonText?: string | null;
+            /**
+             * Customhtml
+             * @description Full custom HTML - if set, overrides structured fields
+             */
+            customHtml?: string | null;
+            /**
+             * Availablevariables
+             * @description Documentation of available variables
+             */
+            availableVariables?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Enabled
+             * @description Whether this template is active
+             * @default true
+             */
+            enabled: boolean;
+        };
+        /**
+         * EmailTemplateRead
+         * @description Schema for reading an email template.
+         */
+        EmailTemplateRead: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /** Templatetype */
+            templateType: string;
+            /** Groupid */
+            groupId: string | null;
+            /** Name */
+            name: string;
+            /** Description */
+            description: string | null;
+            /** Subject */
+            subject: string;
+            /** Headertext */
+            headerText: string | null;
+            /** Messagetop */
+            messageTop: string | null;
+            /** Messagebottom */
+            messageBottom: string | null;
+            /** Buttontext */
+            buttonText: string | null;
+            /** Customhtml */
+            customHtml: string | null;
+            /** Availablevariables */
+            availableVariables: {
+                [key: string]: unknown;
+            } | null;
+            /** Enabled */
+            enabled: boolean;
+            /**
+             * Createdat
+             * Format: date-time
+             */
+            createdAt: string;
+            /**
+             * Updateat
+             * Format: date-time
+             */
+            updateAt: string;
+        };
+        /**
+         * EmailTemplateSummary
+         * @description Summary schema for listing email templates.
+         */
+        EmailTemplateSummary: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /** Templatetype */
+            templateType: string;
+            /** Name */
+            name: string;
+            /** Description */
+            description: string | null;
+            /** Enabled */
+            enabled: boolean;
+        };
+        /**
+         * EmailTemplateUpdate
+         * @description Schema for updating an email template.
+         */
+        EmailTemplateUpdate: {
+            /** Name */
+            name?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Subject */
+            subject?: string | null;
+            /** Headertext */
+            headerText?: string | null;
+            /** Messagetop */
+            messageTop?: string | null;
+            /** Messagebottom */
+            messageBottom?: string | null;
+            /** Buttontext */
+            buttonText?: string | null;
+            /** Customhtml */
+            customHtml?: string | null;
+            /** Availablevariables */
+            availableVariables?: {
+                [key: string]: unknown;
+            } | null;
+            /** Enabled */
+            enabled?: boolean | null;
+        };
+        /**
+         * EmailTest
+         * @description Schema for the request body when sending a test email.
+         *     Specifies the recipient email address.
+         */
+        EmailTest: {
+            /** Email */
+            email: string;
+        };
+        /**
+         * EntryAssetRead
+         * @description Asset metadata plus entry-specific placement details.
+         */
+        EntryAssetRead: {
+            /** Role */
+            role?: string | null;
+            /** Usage */
+            usage?: string | null;
+            /**
+             * Position
+             * @default 0
+             */
+            position: number;
+            /** Focalpoint */
+            focalPoint?: string | null;
+            /** Caption */
+            caption?: string | null;
+            /** Placementmetadata */
+            placementMetadata?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /** Slug */
+            slug: string;
+            /** Name */
+            name: string;
+            /** Mimetype */
+            mimeType: string;
+            /** Alttext */
+            altText?: string | null;
+            /** Originalfilename */
+            originalFilename: string;
+            /** Filename */
+            filename: string;
+            /** Extension */
+            extension: string;
+            /** Filesize */
+            fileSize: number;
+            /**
+             * Assettype
+             * @enum {string}
+             */
+            assetType: "image" | "document" | "video" | "audio" | "archive" | "svg" | "other";
+            /** Checksum */
+            checksum: string;
+            /** Width */
+            width?: number | null;
+            /** Height */
+            height?: number | null;
+            /** Orientation */
+            orientation?: number | null;
+            /** Storageprovider */
+            storageProvider: string;
+            /** Storagekey */
+            storageKey: string;
+            /** Publicurl */
+            publicUrl?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Metadata */
+            metadata_?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Uploadedby
+             * Format: uuid4
+             */
+            uploadedBy: string;
+        };
+        /**
+         * EntryCreate
+         * @description Schema for creating an entry.
+         *
+         *     BREAKING CHANGE: content_markdown removed, replaced with data_json.
+         *     Entry content is now schema-driven based on entry_type.schema_json.
+         */
+        EntryCreate: {
+            /**
+             * Entrytypeid
+             * Format: uuid4
+             */
+            entryTypeId: string;
+            /** Title */
+            title: string;
+            /** Slug */
+            slug?: string | null;
+            /** Summary */
+            summary?: string | null;
+            /** Description */
+            description?: string | null;
+            /**
+             * Datajson
+             * @description Schema-driven content data (validated against entry_type.schema_json)
+             */
+            dataJson?: {
+                [key: string]: unknown;
+            };
+            /**
+             * Status
+             * @default inbox
+             */
+            status: string;
+            /** Publishedat */
+            publishedAt?: string | null;
+            /** Publishat */
+            publishAt?: string | null;
+            /** Expireat */
+            expireAt?: string | null;
+            /**
+             * Metadatajson
+             * @description Custom non-schema metadata (API keys, external IDs, etc.)
+             */
+            metadataJson?: {
+                [key: string]: unknown;
+            } | null;
+            /** Collectionids */
+            collectionIds?: string[] | null;
+            /** Assetids */
+            assetIds?: string[] | null;
+            /** Resourceids */
+            resourceIds?: string[] | null;
+        };
+        /**
+         * EntryOrderItem
+         * @description Schema for a single entry order update.
+         */
+        EntryOrderItem: {
+            /**
+             * Entryid
+             * Format: uuid4
+             */
+            entryId: string;
+            /** Sortorder */
+            sortOrder: number;
+        };
+        /**
+         * EntryRead
+         * @description Schema for reading an entry.
+         *
+         *     BREAKING CHANGE: content_markdown removed, replaced with data_json.
+         *     Entry content is now schema-driven based on entry_type.schema_json.
+         */
+        EntryRead: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /**
+             * Groupid
+             * Format: uuid4
+             */
+            groupId: string;
+            /**
+             * Entrytypeid
+             * Format: uuid4
+             */
+            entryTypeId: string;
+            /** Title */
+            title: string;
+            /** Slug */
+            slug: string;
+            /** Summary */
+            summary?: string | null;
+            /** Description */
+            description?: string | null;
+            /**
+             * Datajson
+             * @description Schema-driven content data
+             */
+            dataJson?: {
+                [key: string]: unknown;
+            };
+            /** Status */
+            status: string;
+            /** Publishedat */
+            publishedAt?: string | null;
+            /** Publishat */
+            publishAt?: string | null;
+            /** Expireat */
+            expireAt?: string | null;
+            /**
+             * Metadatajson
+             * @description Custom non-schema metadata
+             */
+            metadataJson?: {
+                [key: string]: unknown;
+            } | null;
+            /** Createdby */
+            createdBy?: string | null;
+            /** Createdat */
+            createdAt?: string | null;
+            /** Updateat */
+            updateAt?: string | null;
+            /**
+             * Resources
+             * @default []
+             */
+            resources: components["schemas"]["ResourceSummary"][];
+            /**
+             * Assets
+             * @default []
+             */
+            assets: components["schemas"]["EntryAssetRead"][];
+            /**
+             * Collections
+             * @default []
+             */
+            collections: string[];
+            /** Order */
+            order?: number | null;
+        };
+        /**
+         * EntryTypeCapabilities
+         * @description Capabilities for a published entry type.
+         */
+        EntryTypeCapabilities: {
+            /**
+             * Publishable
+             * @default true
+             */
+            publishable: boolean;
+            /**
+             * Submittable
+             * @default false
+             */
+            submittable: boolean;
+            /**
+             * Routable
+             * @default true
+             */
+            routable: boolean;
+        };
+        /**
+         * EntryTypeCreate
+         * @description Schema for creating an entry type.
+         */
+        EntryTypeCreate: {
+            /** Name */
+            name: string;
+            /** Slug */
+            slug?: string | null;
+            /** Icon */
+            icon?: string | null;
+            /** Color */
+            color?: string | null;
+            /** Description */
+            description?: string | null;
+            /**
+             * Sortorder
+             * @default 0
+             */
+            sortOrder: number;
+            /**
+             * Issystem
+             * @default false
+             */
+            isSystem: boolean;
+            /**
+             * Isrendered
+             * @default false
+             */
+            isRendered: boolean;
+            /**
+             * Schema Json
+             * @description Entry type schema definition (EntryTypeSchemaDefinition)
+             */
+            schema_json?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Rendering Json
+             * @description Rendering configuration (RenderingDefinition)
+             */
+            rendering_json?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Capabilities Json
+             * @description Behavioral capabilities (CapabilitiesDefinition)
+             */
+            capabilities_json?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        /**
+         * EntryTypeRead
+         * @description Schema for reading an entry type.
+         *
+         *     System entry types have group_id=None and are globally available to all workspaces.
+         *     Workspace-scoped entry types have a specific group_id.
+         */
+        EntryTypeRead: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /** Groupid */
+            groupId: string | null;
+            /** Name */
+            name: string;
+            /** Slug */
+            slug: string;
+            /** Icon */
+            icon?: string | null;
+            /** Color */
+            color?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Sortorder */
+            sortOrder: number;
+            /** Issystem */
+            isSystem: boolean;
+            /**
+             * Isrendered
+             * @default false
+             */
+            isRendered: boolean;
+            /**
+             * Schemajson
+             * @description Entry type schema definition (EntryTypeSchemaDefinition)
+             */
+            schemaJson?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Renderingjson
+             * @description Rendering configuration (RenderingDefinition)
+             */
+            renderingJson?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Capabilitiesjson
+             * @description Behavioral capabilities (CapabilitiesDefinition)
+             */
+            capabilitiesJson?: {
+                [key: string]: unknown;
+            } | null;
+            /** Createdat */
+            createdAt?: string | null;
+            /** Updateat */
+            updateAt?: string | null;
+            /** Warnings */
+            warnings?: string[] | null;
+        };
+        /**
+         * EntryTypeRendering
+         * @description Rendering configuration for a published entry type.
+         */
+        EntryTypeRendering: {
+            /** Renderer */
+            renderer?: string | null;
+            /** Package */
+            package?: string | null;
+            /** Version */
+            version?: string | null;
+            /** Config */
+            config?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        /**
+         * EntryTypeUpdate
+         * @description Schema for patching an entry type.
+         */
+        EntryTypeUpdate: {
+            /** Name */
+            name?: string | null;
+            /** Slug */
+            slug?: string | null;
+            /** Icon */
+            icon?: string | null;
+            /** Color */
+            color?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Sortorder */
+            sortOrder?: number | null;
+            /** Issystem */
+            isSystem?: boolean | null;
+            /** Isrendered */
+            isRendered?: boolean | null;
+            /**
+             * Schema Json
+             * @description Entry type schema definition (EntryTypeSchemaDefinition)
+             */
+            schema_json?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Rendering Json
+             * @description Rendering configuration (RenderingDefinition)
+             */
+            rendering_json?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Capabilities Json
+             * @description Behavioral capabilities (CapabilitiesDefinition)
+             */
+            capabilities_json?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        /**
+         * EntryUpdate
+         * @description Schema for patching an entry.
+         *
+         *     BREAKING CHANGE: content_markdown removed, replaced with data_json.
+         *     Entry content is now schema-driven based on entry_type.schema_json.
+         */
+        EntryUpdate: {
+            /** Entry Type Id */
+            entry_type_id?: string | null;
+            /** Title */
+            title?: string | null;
+            /** Slug */
+            slug?: string | null;
+            /** Summary */
+            summary?: string | null;
+            /** Description */
+            description?: string | null;
+            /**
+             * Datajson
+             * @description Schema-driven content data (validated against entry_type.schema_json)
+             */
+            dataJson?: {
+                [key: string]: unknown;
+            } | null;
+            /** Status */
+            status?: string | null;
+            /** Publishedat */
+            publishedAt?: string | null;
+            /** Publishat */
+            publishAt?: string | null;
+            /** Expireat */
+            expireAt?: string | null;
+            /**
+             * Metadatajson
+             * @description Custom non-schema metadata (API keys, external IDs, etc.)
+             */
+            metadataJson?: {
+                [key: string]: unknown;
+            } | null;
+            /** Collection Ids */
+            collection_ids?: string[] | null;
+            /** Asset Ids */
+            asset_ids?: string[] | null;
+            /** Resource Ids */
+            resource_ids?: string[] | null;
+        };
+        /**
+         * EventDocumentType
+         * @description Enumeration for the type of document or data payload associated with an event.
+         *     Helps listeners understand the nature of `EventDocumentDataBase` content.
+         * @enum {string}
+         */
+        EventDocumentType: "generic" | "user" | "workspace" | "entry" | "form" | "form_submission" | "collection" | "asset" | "webhook" | "member" | "invitation" | "api_token" | "api_client" | "entry_type" | "resource" | "deployment";
+        /**
+         * EventLogRead
+         * @description Schema for reading an event log entry.
+         */
+        EventLogRead: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /**
+             * Eventid
+             * Format: uuid4
+             */
+            eventId: string;
+            /** Eventtype */
+            eventType: string;
+            /**
+             * Occurredat
+             * Format: date-time
+             */
+            occurredAt: string;
+            /**
+             * Workspaceid
+             * Format: uuid4
+             */
+            workspaceId: string;
+            /** Userid */
+            userId?: string | null;
+            /** Entityid */
+            entityId?: string | null;
+            /** Entitytype */
+            entityType?: string | null;
+            /** Integrationid */
+            integrationId: string;
+            /** Operation */
+            operation?: string | null;
+            /** Eventdata */
+            eventData: {
+                [key: string]: unknown;
+            };
+            /** Messagetitle */
+            messageTitle: string;
+            /** Messagebody */
+            messageBody?: string | null;
+            /** Createdat */
+            createdAt?: string | null;
+            /** Updateat */
+            updateAt?: string | null;
+        };
+        /**
+         * EventLogSummary
+         * @description Summary schema for an event log entry (lighter payload).
+         */
+        EventLogSummary: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /**
+             * Eventid
+             * Format: uuid4
+             */
+            eventId: string;
+            /** Eventtype */
+            eventType: string;
+            /**
+             * Occurredat
+             * Format: date-time
+             */
+            occurredAt: string;
+            /**
+             * Workspaceid
+             * Format: uuid4
+             */
+            workspaceId: string;
+            /** Userid */
+            userId?: string | null;
+            /** Entityid */
+            entityId?: string | null;
+            /** Entitytype */
+            entityType?: string | null;
+            /** Messagetitle */
+            messageTitle: string;
+            /** Messagebody */
+            messageBody?: string | null;
+        };
+        /**
+         * EventNotifierOptionsPagination
+         * @description Schema for paginated responses containing a list of event notifier option summaries.
+         */
+        EventNotifierOptionsPagination: {
+            /**
+             * Page
+             * @default 1
+             */
+            page: number;
+            /**
+             * Per Page
+             * @default 10
+             */
+            per_page: number;
+            /**
+             * Total
+             * @default 0
+             */
+            total: number;
+            /**
+             * Total Pages
+             * @default 0
+             */
+            total_pages: number;
+            /** Items */
+            items: components["schemas"]["EventNotifierOptionsSummary"][];
+            /** Next */
+            next?: string | null;
+            /** Previous */
+            previous?: string | null;
+        };
+        /**
+         * EventNotifierOptionsSummary
+         * @description Schema for a summary representation of an event notifier option.
+         *     Extends `EventNotifierOptionsRead` with a combined `option` field (namespace.slug).
+         */
+        EventNotifierOptionsSummary: {
+            /** Name */
+            name: string;
+            /** Description */
+            description: string | null;
+            /**
+             * Enabled
+             * @default false
+             */
+            enabled: boolean | null;
+            /** Slug */
+            slug: string | null;
+            /** Option */
+            option: string;
+        };
+        /**
+         * ForgotPassword
+         * @description Schema for the "forgot password" request.
+         *     Requires the user's email address to initiate the password reset process.
+         */
+        ForgotPassword: {
+            /** Email */
+            email: string;
+        };
+        /**
+         * FormCreate
+         * @description Schema for creating a form.
+         */
+        FormCreate: {
+            /** Name */
+            name: string;
+            /** Slug */
+            slug?: string | null;
+            /** Description */
+            description?: string | null;
+            /**
+             * Status
+             * @default draft
+             */
+            status: string;
+            /** Formschema */
+            formSchema?: {
+                [key: string]: unknown;
+            };
+            /** Settingsjson */
+            settingsJson?: {
+                [key: string]: unknown;
+            } | null;
+            /** Metadatajson */
+            metadataJson?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        /**
+         * FormRead
+         * @description Schema for reading a form.
+         */
+        FormRead: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /**
+             * Groupid
+             * Format: uuid4
+             */
+            groupId: string;
+            /** Slug */
+            slug: string;
+            /** Name */
+            name: string;
+            /** Description */
+            description: string | null;
+            /** Schemajson */
+            schemaJson: {
+                [key: string]: unknown;
+            };
+            /** Settingsjson */
+            settingsJson: {
+                [key: string]: unknown;
+            } | null;
+            /** Metadatajson */
+            metadataJson: {
+                [key: string]: unknown;
+            } | null;
+            /** Status */
+            status: string;
+            /** Submissionscount */
+            submissionsCount: number;
+            /** Lastsubmissionat */
+            lastSubmissionAt: string | null;
+            /** Createdat */
+            createdAt: string | null;
+            /** Updateat */
+            updateAt: string | null;
+        };
+        /**
+         * FormSubmissionRead
+         * @description Schema for reading a form submission.
+         */
+        FormSubmissionRead: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /**
+             * Formid
+             * Format: uuid4
+             */
+            formId: string;
+            /**
+             * Groupid
+             * Format: uuid4
+             */
+            groupId: string;
+            /** Datajson */
+            dataJson: {
+                [key: string]: unknown;
+            };
+            /** Metadatajson */
+            metadataJson: {
+                [key: string]: unknown;
+            } | null;
+            /** Status */
+            status: string;
+            /** Ipaddress */
+            ipAddress: string | null;
+            /** Useragent */
+            userAgent: string | null;
+            /** Referrer */
+            referrer: string | null;
+            /**
+             * Submittedat
+             * Format: date-time
+             */
+            submittedAt: string;
+            /** Processedat */
+            processedAt: string | null;
+        };
+        /**
+         * FormSubmissionResponse
+         * @description Response after form submission.
+         *
+         *     Indicates success/failure and optionally provides redirect URL.
+         */
+        FormSubmissionResponse: {
+            /** Success */
+            success: boolean;
+            /** Message */
+            message: string;
+            /** Submissionid */
+            submissionId?: string | null;
+            /** Redirecturl */
+            redirectUrl?: string | null;
+        };
+        /**
+         * FormUpdate
+         * @description Schema for updating a form.
+         */
+        FormUpdate: {
+            /** Name */
+            name?: string | null;
+            /** Slug */
+            slug?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Status */
+            status?: string | null;
+            /** Formschema */
+            formSchema?: {
+                [key: string]: unknown;
+            } | null;
+            /** Settingsjson */
+            settingsJson?: {
+                [key: string]: unknown;
+            } | null;
+            /** Metadatajson */
+            metadataJson?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        /**
+         * GroupAdminUpdate
+         * @description Schema for administrators to update a group.
+         *     Allows updating the name and group preferences. Inherits `name` from `GroupCreate`.
+         */
+        GroupAdminUpdate: {
+            /** Name */
+            name: string;
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            preferences?: components["schemas"]["GroupPreferencesUpdate"] | null;
+        };
+        /**
+         * GroupCreate
+         * @description Schema for creating a new group. Requires only a name.
+         *     The name will be stripped of whitespace and must have a minimum length of 1.
+         */
+        GroupCreate: {
+            /** Name */
+            name: string;
+        };
+        /**
+         * GroupEventNotifierCreate
+         * @description Schema for creating a new group event notifier.
+         *     A notifier typically involves a service URL (e.g., Apprise) and a set of
+         *     event options it should react to.
+         * @example {
+         *       "apprise_url": "json://some-service-url/for/notifications",
+         *       "name": "My Project Updates Notifier",
+         *       "options": [
+         *         "core.test-message",
+         *         "project.task_completed"
+         *       ]
+         *     }
+         */
+        GroupEventNotifierCreate: {
+            /** Name */
+            name: string;
+            /** Appriseurl */
+            appriseUrl?: string | null;
+            /**
+             * Options
+             * @default []
+             */
+            options: string[];
+        };
+        /**
+         * GroupEventNotifierOptionsSummary
+         * @description Schema for a summary representation of a group event notifier option.
+         *     Provides a combined `option` string (namespace.slug).
+         */
+        GroupEventNotifierOptionsSummary: {
+            /** Option */
+            option: string;
+        };
+        /**
+         * GroupEventNotifierPagination
+         * @description Schema for paginated responses containing a list of group event notifiers.
+         */
+        GroupEventNotifierPagination: {
+            /**
+             * Page
+             * @default 1
+             */
+            page: number;
+            /**
+             * Per Page
+             * @default 10
+             */
+            per_page: number;
+            /**
+             * Total
+             * @default 0
+             */
+            total: number;
+            /**
+             * Total Pages
+             * @default 0
+             */
+            total_pages: number;
+            /** Items */
+            items: components["schemas"]["GroupEventNotifierRead"][];
+            /** Next */
+            next?: string | null;
+            /** Previous */
+            previous?: string | null;
+        };
+        /**
+         * GroupEventNotifierRead
+         * @description Schema for representing a group event notifier when read from the system.
+         *     Includes its configuration and the list of event options it's subscribed to.
+         */
+        GroupEventNotifierRead: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /** Name */
+            name: string;
+            /** Enabled */
+            enabled: boolean;
+            /**
+             * Groupid
+             * Format: uuid4
+             */
+            groupId: string;
+            /**
+             * Options
+             * @default []
+             */
+            options: components["schemas"]["GroupEventNotifierOptionsSummary"][];
+        };
+        /**
+         * GroupEventNotifierUpdate
+         * @description Schema for updating an existing group event notifier.
+         *     Extends `GroupEventNotifierSave`, implying all fields can be updated,
+         *     and adds an `enabled` flag.
+         *
+         *     For partial updates (PATCH), individual fields should be `Optional`.
+         *     This schema implies a PUT-style update where all fields are provided.
+         * @example {
+         *       "apprise_url": "json://some-service-url/for/notifications",
+         *       "name": "My Project Updates Notifier",
+         *       "options": [
+         *         "core.test-message",
+         *         "project.task_completed"
+         *       ]
+         *     }
+         */
+        GroupEventNotifierUpdate: {
+            /** Name */
+            name: string;
+            /** Appriseurl */
+            appriseUrl?: string | null;
+            /**
+             * Options
+             * @default []
+             */
+            options: string[];
+            /**
+             * Groupid
+             * Format: uuid4
+             */
+            groupId: string;
+            /**
+             * Enabled
+             * @default true
+             */
+            enabled: boolean;
+        };
+        /**
+         * GroupPagination
+         * @description Schema for paginated responses containing a list of groups.
+         *     The items in the list are expected to conform to the `GroupRead` schema.
+         */
+        GroupPagination: {
+            /**
+             * Page
+             * @default 1
+             */
+            page: number;
+            /**
+             * Per Page
+             * @default 10
+             */
+            per_page: number;
+            /**
+             * Total
+             * @default 0
+             */
+            total: number;
+            /**
+             * Total Pages
+             * @default 0
+             */
+            total_pages: number;
+            /** Items */
+            items: components["schemas"]["GroupRead"][];
+            /** Next */
+            next?: string | null;
+            /** Previous */
+            previous?: string | null;
+        };
+        /**
+         * GroupPreferencesRead
+         * @description Schema for representing group preferences when read from the system.
+         *     Includes all preference fields.
+         */
+        GroupPreferencesRead: {
+            /**
+             * Groupid
+             * Format: uuid4
+             */
+            groupId: string;
+            /**
+             * Privategroup
+             * @default true
+             */
+            privateGroup: boolean;
+            /**
+             * Firstdayofweek
+             * @default 0
+             */
+            firstDayOfWeek: number;
+            /** Sitetitle */
+            siteTitle?: string | null;
+            /** Sitetagline */
+            siteTagline?: string | null;
+            /** Sitedescription */
+            siteDescription?: string | null;
+            /** Sitecanonicalurl */
+            siteCanonicalUrl?: string | null;
+            /** Sitelogo */
+            siteLogo?: string | null;
+            /** Sitefavicon */
+            siteFavicon?: string | null;
+            /**
+             * Sitelocale
+             * @default en-US
+             */
+            siteLocale: string | null;
+            /**
+             * Sitetimezone
+             * @default America/New_York
+             */
+            siteTimezone: string | null;
+            /** Sitecontactemail */
+            siteContactEmail?: string | null;
+            /** Sitesocialjson */
+            siteSocialJson?: {
+                [key: string]: unknown;
+            } | null;
+            /** Sitemetadatajson */
+            siteMetadataJson?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        /**
+         * GroupPreferencesUpdate
+         * @description Schema for updating existing group preferences and workspace settings.
+         *     All fields are optional for partial updates.
+         *     The id and group_id are set by the controller based on the URL path.
+         */
+        GroupPreferencesUpdate: {
+            /** Id */
+            id?: string | null;
+            /** Groupid */
+            groupId?: string | null;
+            /** Name */
+            name?: string | null;
+            /** Privategroup */
+            privateGroup?: boolean | null;
+            /** Firstdayofweek */
+            firstDayOfWeek?: number | null;
+            /** Sitetitle */
+            siteTitle?: string | null;
+            /** Sitetagline */
+            siteTagline?: string | null;
+            /** Sitedescription */
+            siteDescription?: string | null;
+            /** Sitecanonicalurl */
+            siteCanonicalUrl?: string | null;
+            /** Sitelogo */
+            siteLogo?: string | null;
+            /** Sitefavicon */
+            siteFavicon?: string | null;
+            /** Sitelocale */
+            siteLocale?: string | null;
+            /** Sitetimezone */
+            siteTimezone?: string | null;
+            /** Sitecontactemail */
+            siteContactEmail?: string | null;
+            /** Sitesocialjson */
+            siteSocialJson?: {
+                [key: string]: unknown;
+            } | null;
+            /** Sitemetadatajson */
+            siteMetadataJson?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        /**
+         * GroupRead
+         * @description Schema for representing a group when read from the system, including detailed information.
+         *     This typically serves as a response model for GET requests.
+         *     Inherits `id`, `name`, and `webhooks` (as `WebhookRead`) from `GroupUpdate`.
+         */
+        GroupRead: {
+            /** Name */
+            name: string;
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /**
+             * Webhooks
+             * @default []
+             */
+            webhooks: components["schemas"]["WebhookRead"][];
+            /** Slug */
+            slug?: string | null;
+            /** Users */
+            users?: components["schemas"]["UserSummary"][] | null;
+            preferences?: components["schemas"]["GroupPreferencesRead"] | null;
+        };
+        /** HTTPValidationError */
+        HTTPValidationError: {
+            /** Detail */
+            detail?: components["schemas"]["ValidationError"][];
+        };
+        /**
+         * HealthCheck
+         * @description Response model for the health check endpoint.
+         *     Indicates the operational status of the application.
+         */
+        HealthCheck: {
+            /**
+             * Status
+             * @default OK
+             */
+            status: string;
+        };
+        /**
+         * InviteTokenCreate
+         * @description Schema for creating a new group invitation token.
+         *     Specifies the initial number of uses, role, and the group it belongs to.
+         */
+        InviteTokenCreate: {
+            /** Usesleft */
+            usesLeft: number;
+            /** @default EDITOR */
+            workspaceRole: components["schemas"]["WorkspaceRole"];
+        };
+        /**
+         * InviteTokenPagination
+         * @description Schema for paginated responses containing a list of invite token summaries.
+         */
+        InviteTokenPagination: {
+            /**
+             * Page
+             * @default 1
+             */
+            page: number;
+            /**
+             * Per Page
+             * @default 10
+             */
+            per_page: number;
+            /**
+             * Total
+             * @default 0
+             */
+            total: number;
+            /**
+             * Total Pages
+             * @default 0
+             */
+            total_pages: number;
+            /** Items */
+            items: components["schemas"]["InviteTokenSummary"][];
+            /** Next */
+            next?: string | null;
+            /** Previous */
+            previous?: string | null;
+        };
+        /**
+         * InviteTokenSummary
+         * @description Schema for a summary representation of a invite token.
+         */
+        InviteTokenSummary: {
+            /** Usesleft */
+            usesLeft: number;
+            workspaceRole: components["schemas"]["WorkspaceRole"];
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /** Token */
+            token: string;
+            /** Createdat */
+            createdAt?: string | null;
+        };
+        /**
+         * LongLiveTokenCreate
+         * @description Schema for creating a new long-lived API token (Personal Access Token).
+         */
+        LongLiveTokenCreate: {
+            /** Name */
+            name: string;
+            /** Description */
+            description?: string | null;
+            /**
+             * Integrationid
+             * @default generic
+             */
+            integrationId: string;
+        };
+        /**
+         * LongLiveTokenRead
+         * @description Schema for representing a long-lived API token when read from the system.
+         *     Excludes the sensitive token string itself (never return token_hash).
+         *     Includes security fields: enabled, last_used_at, revoked_at.
+         */
+        LongLiveTokenRead: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /**
+             * Userid
+             * Format: uuid4
+             */
+            userId: string;
+            /** Name */
+            name: string;
+            /** Description */
+            description?: string | null;
+            /** Enabled */
+            enabled: boolean;
+            /** Lastusedat */
+            lastUsedAt?: string | null;
+            /** Revokedat */
+            revokedAt?: string | null;
+            /** Createdat */
+            createdAt?: string | null;
+            /** Updateat */
+            updateAt?: string | null;
+            /**
+             * Integrationid
+             * @default generic
+             */
+            integrationId: string;
+        };
+        /**
+         * LongLiveTokenUpdate
+         * @description Schema for updating an existing long-lived API token.
+         *     All fields are optional.
+         */
+        LongLiveTokenUpdate: {
+            /** Name */
+            name?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Enabled */
+            enabled?: boolean | null;
+        };
+        /**
+         * LongLiveTokenWithToken
+         * @description Schema for the response when a new token is created or rotated.
+         *     Includes the actual `token` string, which is shown ONLY ONCE.
+         *
+         *     IMPORTANT: The plaintext token is never stored in the database.
+         *     Only the bcrypt hash is stored.
+         */
+        LongLiveTokenWithToken: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /**
+             * Userid
+             * Format: uuid4
+             */
+            userId: string;
+            /** Name */
+            name: string;
+            /** Description */
+            description?: string | null;
+            /** Enabled */
+            enabled: boolean;
+            /** Token */
+            token: string;
+            /** Createdat */
+            createdAt?: string | null;
+        };
+        /**
+         * MaintenanceStorageDetails
+         * @description Schema providing detailed storage usage for various key application directories.
+         *     All sizes are presented as human-readable strings.
+         */
+        MaintenanceStorageDetails: {
+            /** Tempdirsize */
+            tempDirSize: string;
+            /** Backupsdirsize */
+            backupsDirSize: string;
+            /** Seedsdirsize */
+            seedsDirSize: string;
+            /** Plugindirsize */
+            pluginDirSize: string;
+        };
+        /**
+         * MaintenanceSummary
+         * @description Schema for a summary of maintenance information, currently focused on data directory size.
+         */
+        MaintenanceSummary: {
+            /** Datadirsize */
+            dataDirSize: string;
+        };
+        /**
+         * MarvinAuthToken
+         * @description Pydantic response model for authentication tokens.
+         */
+        MarvinAuthToken: {
+            /** Access Token */
+            access_token: string;
+            /**
+             * Token Type
+             * @default bearer
+             */
+            token_type: string;
+        };
+        /**
+         * OrderByNullPosition
+         * @description Enumeration for specifying how NULL values should be positioned in ordered results.
+         * @enum {string}
+         */
+        OrderByNullPosition: "first" | "last";
+        /**
+         * OrderDirection
+         * @description Enumeration for specifying the direction of ordering in queries.
+         * @enum {string}
+         */
+        OrderDirection: "asc" | "desc";
+        /**
+         * PaginationMeta
+         * @description Pagination metadata.
+         */
+        PaginationMeta: {
+            /** Total */
+            total: number;
+            /** Page */
+            page: number;
+            /** Limit */
+            limit: number;
+            /** Offset */
+            offset: number;
+        };
+        /**
+         * PasswordResetToken
+         * @description Schema representing a password reset token along with the associated email.
+         *     This might be used when returning token information or in contexts where
+         *     both email and token are relevant.
+         */
+        PasswordResetToken: {
+            /** Email */
+            email: string;
+            /** Token */
+            token: string;
+        };
+        /**
+         * PlatformRole
+         * @description Platform-level roles for Marvin.
+         *
+         *     A user has ONE platform role that determines their platform-level access.
+         *     Platform roles are independent of workspace membership.
+         * @enum {string}
+         */
+        PlatformRole: "NONE" | "SUPER_ADMIN";
+        /**
+         * PublishedEntryAsset
+         * @description An asset as used by a specific entry — relationship context + asset data.
+         */
+        PublishedEntryAsset: {
+            /** Role */
+            role?: string | null;
+            /**
+             * Position
+             * @default 0
+             */
+            position: number;
+            /** Focalpoint */
+            focalPoint?: string | null;
+            /** Caption */
+            caption?: string | null;
+            /** Metadatajson */
+            metadataJson?: {
+                [key: string]: unknown;
+            } | null;
+            asset: components["schemas"]["PublishedAssetRead"];
+        };
+        /**
+         * PublishedEntryResource
+         * @description A resource as used by a specific entry — relationship context + resource data.
+         */
+        PublishedEntryResource: {
+            /** Role */
+            role?: string | null;
+            /** Quantity */
+            quantity?: string | null;
+            /** Unit */
+            unit?: string | null;
+            /**
+             * Position
+             * @default 0
+             */
+            position: number;
+            /** Metadatajson */
+            metadataJson?: {
+                [key: string]: unknown;
+            } | null;
+            resource: components["schemas"]["PublishedResourceSummary"];
+        };
+        /**
+         * PublishedAssetRead
+         * @description Schema for published assets in the publishing API.
+         *
+         *     Provides asset metadata for external sites to build proper media tags.
+         *     Read-only, does not expose internal fields like storage_key or uploaded_by.
+         */
+        PublishedAssetRead: {
+            /** Slug */
+            slug: string;
+            /** Name */
+            name: string;
+            /** Mimetype */
+            mimeType: string;
+            /** Assettype */
+            assetType: string;
+            /** Filesize */
+            fileSize: number;
+            /** Width */
+            width?: number | null;
+            /** Height */
+            height?: number | null;
+            /** Alttext */
+            altText?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Publicurl */
+            publicUrl: string;
+            /** Metadatajson */
+            metadataJson?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        /**
+         * PublishedAssetsResponse
+         * @description Paginated response for listing published assets.
+         */
+        PublishedAssetsResponse: {
+            /** Data */
+            data: components["schemas"]["PublishedAssetRead"][];
+            meta: components["schemas"]["PaginationMeta"];
+        };
+        /**
+         * PublishedCollectionRead
+         * @description Schema for published collections in the publishing API.
+         *
+         *     Includes collection metadata and its published entries.
+         */
+        PublishedCollectionRead: {
+            /** Slug */
+            slug: string;
+            /** Name */
+            name: string;
+            /** Description */
+            description?: string | null;
+            /**
+             * Issmart
+             * @default false
+             */
+            isSmart: boolean;
+            /** Smartrules */
+            smartRules?: {
+                [key: string]: unknown;
+            } | null;
+            /** Metadatajson */
+            metadataJson?: {
+                [key: string]: unknown;
+            } | null;
+            /** Entrycount */
+            entryCount: number;
+            /** Entries */
+            entries: components["schemas"]["PublishedEntryListItem"][];
+        };
+        /**
+         * PublishedCollectionSummary
+         * @description Summary schema for published collections (for listing).
+         *
+         *     Minimal collection info for entry contexts - only includes
+         *     essential fields for display and ordering.
+         */
+        PublishedCollectionSummary: {
+            /** Slug */
+            slug: string;
+            /** Name */
+            name: string;
+            /** Metadatajson */
+            metadataJson?: {
+                [key: string]: unknown;
+            } | null;
+            /** Sortorder */
+            sortOrder: number;
+        };
+        /**
+         * PublishedCollectionsResponse
+         * @description Paginated response for listing published collections.
+         */
+        PublishedCollectionsResponse: {
+            /** Data */
+            data: components["schemas"]["PublishedCollectionSummary"][];
+            meta: components["schemas"]["PaginationMeta"];
+        };
+        /**
+         * PublishedEntriesResponse
+         * @description Paginated response for listing published entries.
+         */
+        PublishedEntriesResponse: {
+            /** Data */
+            data: components["schemas"]["PublishedEntryListItem"][];
+            meta: components["schemas"]["PaginationMeta"];
+        };
+        /**
+         * PublishedEntryListItem
+         * @description Minimal entry schema for list responses.
+         *
+         *     Used when listing multiple entries - returns only essential fields
+         *     without full content.
+         */
+        PublishedEntryListItem: {
+            /** Slug */
+            slug: string;
+            /** Title */
+            title: string;
+            /** Entrytype */
+            entryType: string;
+            entryTypeInfo?: components["schemas"]["PublishedEntryTypeInfo"] | null;
+            /** Summary */
+            summary?: string | null;
+            /** Publishedat */
+            publishedAt?: string | null;
+            /** Status */
+            status: string;
+            /**
+             * Collections
+             * @default []
+             */
+            collections: string[];
+            /**
+             * Assetslugs
+             * @default []
+             */
+            assetSlugs: string[];
+            /**
+             * Resourceslugs
+             * @default []
+             */
+            resourceSlugs: string[];
+            /** Metadatajson */
+            metadataJson?: {
+                [key: string]: unknown;
+            } | null;
+            featuredAsset?: components["schemas"]["PublishedAssetRead"] | null;
+            /** Order */
+            order?: number | null;
+        };
+        /**
+         * PublishedEntryRead
+         * @description Schema for published entries in the publishing API.
+         *
+         *     Only includes public-facing fields. Excludes all admin metadata,
+         *     internal fields, and user information.
+         *
+         *     BREAKING CHANGE: content_markdown removed, replaced with data.
+         *     Entry content is now schema-driven based on entry_type.schema_json.
+         */
+        PublishedEntryRead: {
+            /** Slug */
+            slug: string;
+            /** Title */
+            title: string;
+            /** Entrytype */
+            entryType: string;
+            entryTypeInfo?: components["schemas"]["PublishedEntryTypeInfo"] | null;
+            /** Summary */
+            summary?: string | null;
+            /** Data */
+            data: {
+                [key: string]: unknown;
+            };
+            /** Publishedat */
+            publishedAt?: string | null;
+            /** Metadatajson */
+            metadataJson?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Collections
+             * @default []
+             */
+            collections: components["schemas"]["PublishedCollectionSummary"][];
+            /**
+             * Resources
+             * @default []
+             */
+            resources: components["schemas"]["PublishedEntryResource"][];
+            /**
+             * Assets
+             * @default []
+             */
+            assets: components["schemas"]["PublishedEntryAsset"][];
+            /** Order */
+            order?: number | null;
+        };
+        /**
+         * PublishedEntryTypeInfo
+         * @description Flattened entry type rendering and capabilities info for published entries.
+         */
+        PublishedEntryTypeInfo: {
+            /** Slug */
+            slug: string;
+            /** Renderer */
+            renderer?: string | null;
+            /** Package */
+            package?: string | null;
+            /** Version */
+            version?: string | null;
+            /** Config */
+            config?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Publishable
+             * @default true
+             */
+            publishable: boolean;
+            /**
+             * Submittable
+             * @default false
+             */
+            submittable: boolean;
+            /**
+             * Routable
+             * @default true
+             */
+            routable: boolean;
+        };
+        /**
+         * PublishedEntryTypeRead
+         * @description Schema for entry types in the publishing API.
+         */
+        PublishedEntryTypeRead: {
+            /** Slug */
+            slug: string;
+            /** Name */
+            name: string;
+            /**
+             * Isrendered
+             * @default false
+             */
+            isRendered: boolean;
+            rendering?: components["schemas"]["EntryTypeRendering"] | null;
+            capabilities?: components["schemas"]["EntryTypeCapabilities"] | null;
+        };
+        /**
+         * PublishedFormRead
+         * @description Schema for published forms in the publishing API.
+         *
+         *     Provides form definition for frontend to render the form.
+         *     Does not expose internal fields like submissions_count.
+         */
+        PublishedFormRead: {
+            /** Slug */
+            slug: string;
+            /** Name */
+            name: string;
+            /** Description */
+            description?: string | null;
+            /** Formschema */
+            formSchema: {
+                [key: string]: unknown;
+            };
+            /** Metadata */
+            metadata?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        /**
+         * PublishedResourceSummary
+         * @description Schema for published resources in standalone context.
+         *
+         *     Provides resource metadata without entry-specific placement info.
+         *     Used for listing resources and getting individual resource details.
+         */
+        PublishedResourceSummary: {
+            /** Slug */
+            slug: string;
+            /** Name */
+            name: string;
+            /** Resourcetype */
+            resourceType: string;
+            /** Description */
+            description?: string | null;
+            /** Url */
+            url?: string | null;
+            /** Externalid */
+            externalId?: string | null;
+            /** Metadatajson */
+            metadataJson?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Entries
+             * @default []
+             */
+            entries: string[];
+        };
+        /**
+         * PublishedResourcesResponse
+         * @description Paginated response for listing published resources.
+         */
+        PublishedResourcesResponse: {
+            /** Data */
+            data: components["schemas"]["PublishedResourceSummary"][];
+            meta: components["schemas"]["PaginationMeta"];
+        };
+        /**
+         * ReorderEntriesRequest
+         * @description Schema for bulk reordering entries in a collection.
+         */
+        ReorderEntriesRequest: {
+            /** Entries */
+            entries: components["schemas"]["EntryOrderItem"][];
+        };
+        /**
+         * ResetPassword
+         * @description Schema for the actual password reset operation.
+         *     Requires the reset token, the user's email (for verification, though token
+         *     should be sufficient if unique and mapped to user), and the new password
+         *     with confirmation.
+         */
+        ResetPassword: {
+            /** Token */
+            token: string;
+            /** Email */
+            email: string;
+            /** Password */
+            password: string;
+            /** Passwordconfirm */
+            passwordConfirm: string;
+        };
+        /**
+         * ResourceCreate
+         * @description Schema for creating a new resource.
+         */
+        ResourceCreate: {
+            /** Slug */
+            slug: string;
+            /** Name */
+            name: string;
+            /** Resourcetype */
+            resourceType: string;
+            /** Description */
+            description?: string | null;
+            /** Url */
+            url?: string | null;
+            /** Externalid */
+            externalId?: string | null;
+            /** Metadata */
+            metadata?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        /**
+         * ResourceRead
+         * @description Full schema for reading a resource.
+         */
+        ResourceRead: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /** Slug */
+            slug: string;
+            /** Name */
+            name: string;
+            /** Resourcetype */
+            resourceType: string;
+            /** Description */
+            description?: string | null;
+            /** Url */
+            url?: string | null;
+            /** Externalid */
+            externalId?: string | null;
+            /** Metadata */
+            metadata?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Createdby
+             * Format: uuid4
+             */
+            createdBy: string;
+        };
+        /**
+         * ResourceSummary
+         * @description Summary schema for a resource.
+         */
+        ResourceSummary: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /** Slug */
+            slug: string;
+            /** Name */
+            name: string;
+            /** Resourcetype */
+            resourceType: string;
+            /** Description */
+            description?: string | null;
+            /** Url */
+            url?: string | null;
+            /** Externalid */
+            externalId?: string | null;
+        };
+        /**
+         * ResourceUpdate
+         * @description Schema for updating a resource.
+         */
+        ResourceUpdate: {
+            /** Slug */
+            slug?: string | null;
+            /** Name */
+            name?: string | null;
+            /** Resourcetype */
+            resourceType?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Url */
+            url?: string | null;
+            /** Externalid */
+            externalId?: string | null;
+            /** Metadata */
+            metadata?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        /**
+         * ScheduledTaskCreate
+         * @description Schema for creating a new scheduled task.
+         */
+        ScheduledTaskCreate: {
+            /** Name */
+            name: string;
+            /** Slug */
+            slug?: string | null;
+            /** Description */
+            description?: string | null;
+            /**
+             * Enabled
+             * @default true
+             */
+            enabled: boolean;
+            /**
+             * Scheduletype
+             * @enum {string}
+             */
+            scheduleType: "cron" | "interval" | "once";
+            /** Scheduleconfig */
+            scheduleConfig: {
+                [key: string]: unknown;
+            };
+            /** Tasktype */
+            taskType: string;
+            /** Taskconfig */
+            taskConfig?: {
+                [key: string]: unknown;
+            };
+            /** Retrypolicy */
+            retryPolicy?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        /**
+         * ScheduledTaskExecutionLogRead
+         * @description Schema for reading a scheduled task execution log entry.
+         */
+        ScheduledTaskExecutionLogRead: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /**
+             * Taskid
+             * Format: uuid4
+             */
+            taskId: string;
+            /** Groupid */
+            groupId?: string | null;
+            /**
+             * Executedat
+             * Format: date-time
+             */
+            executedAt: string;
+            /** Status */
+            status: string;
+            /** Durationms */
+            durationMs?: number | null;
+            /** Errormessage */
+            errorMessage?: string | null;
+            /** Errortraceback */
+            errorTraceback?: string | null;
+            /** Retryattempt */
+            retryAttempt: number;
+        };
+        /**
+         * ScheduledTaskRead
+         * @description Full schema for reading a scheduled task.
+         */
+        ScheduledTaskRead: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /** Name */
+            name: string;
+            /** Slug */
+            slug: string;
+            /** Description */
+            description?: string | null;
+            /** Enabled */
+            enabled: boolean;
+            /** Scheduletype */
+            scheduleType: string;
+            /** Tasktype */
+            taskType: string;
+            /** Lastrunat */
+            lastRunAt?: string | null;
+            /** Nextrunat */
+            nextRunAt?: string | null;
+            /** Laststatus */
+            lastStatus?: string | null;
+            /** Failurecount */
+            failureCount: number;
+            /** Createdat */
+            createdAt?: string | null;
+            /** Updateat */
+            updateAt?: string | null;
+            /** Groupid */
+            groupId?: string | null;
+            /** Scheduleconfig */
+            scheduleConfig: {
+                [key: string]: unknown;
+            };
+            /** Taskconfig */
+            taskConfig: {
+                [key: string]: unknown;
+            };
+            /** Retrypolicy */
+            retryPolicy?: {
+                [key: string]: unknown;
+            } | null;
+            /** Lastdurationms */
+            lastDurationMs?: number | null;
+        };
+        /**
+         * ScheduledTaskUpdate
+         * @description Schema for updating a scheduled task.
+         */
+        ScheduledTaskUpdate: {
+            /** Name */
+            name?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Enabled */
+            enabled?: boolean | null;
+            /** Scheduletype */
+            scheduleType?: ("cron" | "interval" | "once") | null;
+            /** Scheduleconfig */
+            scheduleConfig?: {
+                [key: string]: unknown;
+            } | null;
+            /** Tasktype */
+            taskType?: string | null;
+            /** Taskconfig */
+            taskConfig?: {
+                [key: string]: unknown;
+            } | null;
+            /** Retrypolicy */
+            retryPolicy?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        /**
+         * SiteConfiguration
+         * @description Site configuration for publishing API.
+         *
+         *     Provides the public identity and settings for a workspace's published site.
+         *     This replaces hardcoded site.ts files in Astro projects.
+         */
+        SiteConfiguration: {
+            /** Title */
+            title?: string | null;
+            /** Tagline */
+            tagline?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Canonicalurl */
+            canonicalUrl?: string | null;
+            /** Logo */
+            logo?: string | null;
+            /** Favicon */
+            favicon?: string | null;
+            /**
+             * Locale
+             * @default en-US
+             */
+            locale: string;
+            /**
+             * Timezone
+             * @default America/New_York
+             */
+            timezone: string;
+            /** Contactemail */
+            contactEmail?: string | null;
+            /** Social */
+            social?: {
+                [key: string]: unknown;
+            } | null;
+            /** Metadatajson */
+            metadataJson?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        /**
+         * SuccessResponse
+         * @description Standardized schema for generic API success responses.
+         *     Provides a success message and an error flag set to False.
+         */
+        SuccessResponse: {
+            /** Message */
+            message: string;
+            /**
+             * Error
+             * @default false
+             */
+            error: boolean;
+        };
+        /**
+         * SystemStats
+         * @description System statistics response model.
+         */
+        SystemStats: {
+            /** Users Count */
+            users_count: number;
+            /** Groups Count */
+            groups_count: number;
+            /** Entries Count */
+            entries_count: number;
+            /** Assets Count */
+            assets_count: number;
+            /** Api Tokens Count */
+            api_tokens_count: number;
+            /** Webhooks Count */
+            webhooks_count: number;
+            /** Database Size */
+            database_size: string;
+            /** Database Path */
+            database_path: string;
+            /** Assets Size */
+            assets_size: string;
+            /** Assets Path */
+            assets_path: string;
+            /** Backups Size */
+            backups_size: string;
+            /** Backups Path */
+            backups_path: string;
+            /** Total Size */
+            total_size: string;
+            /** Data Dir Path */
+            data_dir_path: string;
+        };
+        /**
+         * TestEmailRequest
+         * @description Request to send a test email.
+         */
+        TestEmailRequest: {
+            /**
+             * Recipient Email
+             * Format: email
+             */
+            recipient_email: string;
+        };
+        /**
+         * TokenResponseDelete
+         * @description Schema for the response after successfully deleting an API token.
+         *     Confirms which token was deleted by its name.
+         */
+        TokenResponseDelete: {
+            /** Tokendelete */
+            tokenDelete: string;
+        };
+        /**
+         * UnlockResults
+         * @description Schema for the response when an operation to unlock user accounts is performed.
+         *     Indicates how many user accounts were successfully unlocked.
+         */
+        UnlockResults: {
+            /**
+             * Unlocked
+             * @default 0
+             */
+            unlocked: number;
+        };
+        /**
+         * UserCreate
+         * @description Schema for creating a new user.
+         *     Includes essential user details, authentication method, admin status,
+         *     group assignment, permissions, and password.
+         * @example {
+         *       "admin": false,
+         *       "email": "newuser@example.com",
+         *       "fullName": "New User Name",
+         *       "group": "Default",
+         *       "password": "aSecurePassword123",
+         *       "username": "NewUser"
+         *     }
+         */
+        UserCreate: {
+            /** Id */
+            id?: string | null;
+            /** Username */
+            username?: string | null;
+            /** Fullname */
+            fullName?: string | null;
+            /** Email */
+            email: string;
+            /** @default MARVIN */
+            authMethod: components["schemas"]["AuthMethod"];
+            /** @default NONE */
+            platformRole: components["schemas"]["PlatformRole"];
+            /**
+             * Admin
+             * @default false
+             */
+            admin: boolean;
+            /**
+             * Issuperuser
+             * @default false
+             */
+            isSuperuser: boolean;
+            /** Group */
+            group?: string | null;
+            /**
+             * Advanced
+             * @default false
+             */
+            advanced: boolean;
+            /** Password */
+            password: string;
+            /**
+             * Caninvite
+             * @default false
+             */
+            canInvite: boolean;
+            /**
+             * Canmanage
+             * @default false
+             */
+            canManage: boolean;
+            /**
+             * Canorganize
+             * @default false
+             */
+            canOrganize: boolean;
+        };
+        /**
+         * UserPagination
+         * @description Schema for paginated responses containing a list of users.
+         *     Items are expected to conform to the `UserRead` schema.
+         */
+        UserPagination: {
+            /**
+             * Page
+             * @default 1
+             */
+            page: number;
+            /**
+             * Per Page
+             * @default 10
+             */
+            per_page: number;
+            /**
+             * Total
+             * @default 0
+             */
+            total: number;
+            /**
+             * Total Pages
+             * @default 0
+             */
+            total_pages: number;
+            /** Items */
+            items: components["schemas"]["UserRead"][];
+            /** Next */
+            next?: string | null;
+            /** Previous */
+            previous?: string | null;
+        };
+        /**
+         * UserProfileUpdate
+         * @description Schema for updating a user's profile information (without password).
+         *     All fields are optional for partial updates.
+         *     Used by the /api/self endpoint for users updating their own profile.
+         */
+        UserProfileUpdate: {
+            /** Username */
+            username?: string | null;
+            /** Email */
+            email?: string | null;
+            /** Fullname */
+            fullName?: string | null;
+        };
+        /**
+         * UserRead
+         * @description Schema for representing a user when read from the system.
+         *     Extends `UserCreate` (which includes password), and adds system-generated fields
+         *     like `id`, group details, and `cache_key`.
+         *
+         *     NOTE: Inheriting from `UserCreate` means this schema will include `password`.
+         *     For public user representations, `password` should typically be excluded.
+         *     Consider having a different base or explicitly excluding password here if this
+         *     is for general-purpose reading. `PrivateUser` below handles sensitive data.
+         * @example {
+         *       "admin": false,
+         *       "email": "newuser@example.com",
+         *       "fullName": "New User Name",
+         *       "group": "Default",
+         *       "password": "aSecurePassword123",
+         *       "username": "NewUser"
+         *     }
+         */
+        UserRead: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /** Username */
+            username?: string | null;
+            /** Fullname */
+            fullName?: string | null;
+            /** Email */
+            email: string;
+            /** @default MARVIN */
+            authMethod: components["schemas"]["AuthMethod"];
+            platformRole: components["schemas"]["PlatformRole"];
+            /**
+             * Admin
+             * @default false
+             */
+            admin: boolean;
+            /**
+             * Issuperuser
+             * @default false
+             */
+            isSuperuser: boolean;
+            /** Group */
+            group: string;
+            /**
+             * Advanced
+             * @default false
+             */
+            advanced: boolean;
+            /** Password */
+            password: string;
+            /**
+             * Caninvite
+             * @default false
+             */
+            canInvite: boolean;
+            /**
+             * Canmanage
+             * @default false
+             */
+            canManage: boolean;
+            /**
+             * Canorganize
+             * @default false
+             */
+            canOrganize: boolean;
+            /**
+             * Groupid
+             * Format: uuid4
+             */
+            groupId: string;
+            /** Groupslug */
+            groupSlug: string;
+            /** Activegroupid */
+            activeGroupId?: string | null;
+            /**
+             * Workspacememberships
+             * @default []
+             */
+            workspaceMemberships: components["schemas"]["WorkspaceMembershipSummary"][];
+            /** Cachekey */
+            cacheKey: string | null;
+        };
+        /** UserRegistrationCreate */
+        UserRegistrationCreate: {
+            /** Group */
+            group?: string | null;
+            /** Grouptoken */
+            groupToken?: string | null;
+            /** Email */
+            email: string;
+            /** Username */
+            username: string;
+            /** Fullname */
+            fullName: string;
+            /** Password */
+            password: string;
+            /** Passwordconfirm */
+            passwordConfirm: string;
+            /**
+             * Advanced
+             * @default false
+             */
+            advanced: boolean;
+            /**
+             * Private
+             * @default false
+             */
+            private: boolean;
+            /**
+             * Seeddata
+             * @default false
+             */
+            seedData: boolean;
+        };
+        /**
+         * UserSummary
+         * @description Schema for a summary representation of a user.
+         *     Provides key identifying information, suitable for lists or brief displays.
+         */
+        UserSummary: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /**
+             * Groupid
+             * Format: uuid4
+             */
+            groupId: string;
+            /** Username */
+            username: string;
+            /** Email */
+            email?: string | null;
+            /** Fullname */
+            fullName?: string | null;
+        };
+        /**
+         * UserUpdate
+         * @description Schema likely used internally for saving a user to the database,
+         *     ensuring required fields like `username`, `full_name`, and `password` are present.
+         *     Extends `UserCreate`.
+         * @example {
+         *       "admin": false,
+         *       "email": "newuser@example.com",
+         *       "fullName": "New User Name",
+         *       "group": "Default",
+         *       "password": "aSecurePassword123",
+         *       "username": "NewUser"
+         *     }
+         */
+        UserUpdate: {
+            /** Id */
+            id?: string | null;
+            /** Username */
+            username: string;
+            /** Fullname */
+            fullName: string;
+            /** Email */
+            email: string;
+            /** @default MARVIN */
+            authMethod: components["schemas"]["AuthMethod"];
+            /** @default NONE */
+            platformRole: components["schemas"]["PlatformRole"];
+            /**
+             * Admin
+             * @default false
+             */
+            admin: boolean;
+            /**
+             * Issuperuser
+             * @default false
+             */
+            isSuperuser: boolean;
+            /** Group */
+            group?: string | null;
+            /**
+             * Advanced
+             * @default false
+             */
+            advanced: boolean;
+            /** Password */
+            password: string;
+            /**
+             * Caninvite
+             * @default false
+             */
+            canInvite: boolean;
+            /**
+             * Canmanage
+             * @default false
+             */
+            canManage: boolean;
+            /**
+             * Canorganize
+             * @default false
+             */
+            canOrganize: boolean;
+        };
+        /** ValidationError */
+        ValidationError: {
+            /** Location */
+            loc: (string | number)[];
+            /** Message */
+            msg: string;
+            /** Error Type */
+            type: string;
+        };
+        /**
+         * WebhookCreate
+         * @description Schema for creating a new webhook configuration.
+         *     Includes fields for enabling the webhook, naming it, specifying the target URL,
+         *     HTTP method, type, and an optional scheduled time for execution.
+         */
+        WebhookCreate: {
+            /**
+             * Enabled
+             * @default true
+             */
+            enabled: boolean;
+            /** Name */
+            name: string;
+            /**
+             * Url
+             * Format: uri
+             */
+            url: string;
+            /** @default POST */
+            method: components["schemas"]["WebhookMethod"];
+            /** @default generic */
+            webhookType: components["schemas"]["EventDocumentType"];
+            /**
+             * Scheduledtime
+             * Format: date-time
+             */
+            scheduledTime: string;
+        };
+        /**
+         * WebhookMethod
+         * @description Enumeration for HTTP methods supported by webhooks.
+         * @enum {string}
+         */
+        WebhookMethod: "GET" | "POST";
+        /**
+         * WebhookPagination
+         * @description Schema for paginated responses containing a list of webhook configurations.
+         */
+        WebhookPagination: {
+            /**
+             * Page
+             * @default 1
+             */
+            page: number;
+            /**
+             * Per Page
+             * @default 10
+             */
+            per_page: number;
+            /**
+             * Total
+             * @default 0
+             */
+            total: number;
+            /**
+             * Total Pages
+             * @default 0
+             */
+            total_pages: number;
+            /** Items */
+            items: components["schemas"]["WebhookRead"][];
+            /** Next */
+            next?: string | null;
+            /** Previous */
+            previous?: string | null;
+        };
+        /**
+         * WebhookRead
+         * @description Schema for representing a webhook configuration when read from the system.
+         *     Extends `WebhookUpdate` by adding the unique `id` of the webhook.
+         */
+        WebhookRead: {
+            /**
+             * Enabled
+             * @default true
+             */
+            enabled: boolean;
+            /** Name */
+            name: string;
+            /**
+             * Url
+             * Format: uri
+             */
+            url: string;
+            /** @default POST */
+            method: components["schemas"]["WebhookMethod"];
+            /** @default generic */
+            webhookType: components["schemas"]["EventDocumentType"];
+            /**
+             * Scheduledtime
+             * Format: date-time
+             */
+            scheduledTime: string;
+            /**
+             * Groupid
+             * Format: uuid4
+             */
+            groupId: string;
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+        };
+        /**
+         * WorkspaceActivationRequest
+         * @description Request to change active workspace.
+         */
+        WorkspaceActivationRequest: {
+            /** Workspace */
+            workspace: string;
+        };
+        /**
+         * WorkspaceInfo
+         * @description Public workspace information for publishing API.
+         */
+        WorkspaceInfo: {
+            /** Slug */
+            slug: string;
+            /** Name */
+            name: string;
+        };
+        /**
+         * WorkspaceMemberCreate
+         * @description Schema for adding a user to a workspace.
+         *
+         *     Used when a workspace admin wants to invite a user to their workspace.
+         */
+        WorkspaceMemberCreate: {
+            /**
+             * Userid
+             * Format: uuid4
+             */
+            userId: string;
+            workspaceRole: components["schemas"]["WorkspaceRole"];
+        };
+        /**
+         * WorkspaceMemberUpdate
+         * @description Schema for updating a workspace member's role.
+         *
+         *     Used when changing a user's permissions within a workspace.
+         */
+        WorkspaceMemberUpdate: {
+            workspaceRole: components["schemas"]["WorkspaceRole"];
+        };
+        /**
+         * WorkspaceMembershipRead
+         * @description Schema for reading a user's workspace membership with role.
+         *     Represents the relationship between a user and a workspace.
+         *     Includes user details when loaded with joinedload.
+         */
+        WorkspaceMembershipRead: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /**
+             * Userid
+             * Format: uuid4
+             */
+            userId: string;
+            /**
+             * Groupid
+             * Format: uuid4
+             */
+            groupId: string;
+            workspaceRole: components["schemas"]["WorkspaceRole"];
+            user?: components["schemas"]["UserSummary"] | null;
+        };
+        /**
+         * WorkspaceMembershipSummary
+         * @description Schema for summarized workspace membership information.
+         *     Used in user profiles to show which workspaces they belong to.
+         */
+        WorkspaceMembershipSummary: {
+            /**
+             * Groupid
+             * Format: uuid4
+             */
+            groupId: string;
+            workspaceRole: components["schemas"]["WorkspaceRole"];
+        };
+        /**
+         * WorkspaceRole
+         * @description Workspace-level roles for workspace members.
+         *
+         *     Each user-workspace membership has ONE workspace role that determines
+         *     what they can do within that specific workspace.
+         * @enum {string}
+         */
+        WorkspaceRole: "OWNER" | "ADMIN" | "EDITOR" | "AUTHOR" | "VIEWER";
+        /**
+         * WorkspaceSiteInfo
+         * @description Combined workspace and site configuration response.
+         *
+         *     Returns everything an external site needs to initialize itself.
+         */
+        WorkspaceSiteInfo: {
+            workspace: components["schemas"]["WorkspaceInfo"];
+            site: components["schemas"]["SiteConfiguration"];
+        };
+        /**
+         * WorkspaceWithMembership
+         * @description Workspace with user's role and active status.
+         */
+        WorkspaceWithMembership: {
+            workspace: components["schemas"]["GroupRead"];
+            role: components["schemas"]["WorkspaceRole"];
+            /** Isactive */
+            isActive: boolean;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+
+/**
+ * Marvin Publishing Client Types
+ *
+ * Type aliases from the auto-generated OpenAPI schema.
+ * These stay in sync automatically when the schema is regenerated.
+ */
+
+type MarvinSite = components['schemas']['WorkspaceSiteInfo'];
+type SiteConfiguration = components['schemas']['SiteConfiguration'];
+type WorkspaceInfo = components['schemas']['WorkspaceInfo'];
+type MarvinEntry = components['schemas']['PublishedEntryRead'];
+type MarvinEntryListItem = components['schemas']['PublishedEntryListItem'];
+type PublishedEntryType = components['schemas']['PublishedEntryTypeRead'];
+type MarvinCollection = components['schemas']['PublishedCollectionRead'];
+type PublishedCollectionSummary = components['schemas']['PublishedCollectionSummary'];
+type MarvinAsset = components['schemas']['PublishedAssetRead'];
+type PublishedAssetRead = components['schemas']['PublishedAssetRead'];
+type PublishedEntryAsset = components['schemas']['PublishedEntryAsset'];
+type MarvinResource = components['schemas']['PublishedResourceSummary'];
+type PublishedEntryResource = components['schemas']['PublishedEntryResource'];
+type MarvinEntryType = components['schemas']['EntryTypeRead'];
+interface AssetUploadRequest {
+    slug: string;
+    name: string;
+    altText?: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+}
+interface MarvinPublishResponse<T> {
+    data: T;
+    meta?: {
+        total?: number;
+        page?: number;
+        limit?: number;
+    };
+}
+interface MarvinClientConfig {
+    apiUrl: string;
+    siteClientToken: string;
+    workspaceSlug: string;
+}
+interface GetEntriesOptions {
+    entryType?: string;
+    collection?: string;
+    limit?: number;
+    offset?: number;
+    status?: string;
+}
+interface GetAssetsOptions {
+    type?: string;
+    limit?: number;
+    offset?: number;
+}
+interface GetResourcesOptions {
+    resourceType?: string;
+    limit?: number;
+    offset?: number;
+}
+interface AuthToken {
+    accessToken: string;
+    tokenType: string;
+}
+
+export type { AuthToken as A, GetAssetsOptions as G, MarvinAsset as M, PublishedAssetRead as P, SiteConfiguration as S, WorkspaceInfo as W, GetEntriesOptions as a, GetResourcesOptions as b, MarvinCollection as c, MarvinEntry as d, MarvinEntryListItem as e, MarvinEntryType as f, MarvinPublishResponse as g, MarvinResource as h, MarvinSite as i, PublishedCollectionSummary as j, PublishedEntryAsset as k, PublishedEntryResource as l, PublishedEntryType as m, components as n, AssetUploadRequest as o, MarvinClientConfig as p };