@inneropen/marvin-sdk 1.0.2 → 1.3.0

package/dist/platform.d.cts

@@ -0,0 +1,2698 @@
+import { H as HttpClient } from './HttpClient-CLtgQGXH.cjs';
+
+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 color palette for the application's light and dark themes.
+         *     Provides default hex color values for various UI elements, intended for client-side use.
+         */
+        AppTheme: {
+            /**
+             * Lightprimary
+             * @default #E58325
+             */
+            lightPrimary: string;
+            /**
+             * Lightaccent
+             * @default #007A99
+             */
+            lightAccent: string;
+            /**
+             * Lightsecondary
+             * @default #973542
+             */
+            lightSecondary: string;
+            /**
+             * Lightsuccess
+             * @default #43A047
+             */
+            lightSuccess: string;
+            /**
+             * Lightinfo
+             * @default #1976D2
+             */
+            lightInfo: string;
+            /**
+             * Lightwarning
+             * @default #FF6D00
+             */
+            lightWarning: string;
+            /**
+             * Lighterror
+             * @default #EF5350
+             */
+            lightError: string;
+            /**
+             * Darkprimary
+             * @default #E58325
+             */
+            darkPrimary: string;
+            /**
+             * Darkaccent
+             * @default #007A99
+             */
+            darkAccent: string;
+            /**
+             * Darksecondary
+             * @default #973542
+             */
+            darkSecondary: string;
+            /**
+             * Darksuccess
+             * @default #43A047
+             */
+            darkSuccess: string;
+            /**
+             * Darkinfo
+             * @default #1976D2
+             */
+            darkInfo: string;
+            /**
+             * Darkwarning
+             * @default #FF6D00
+             */
+            darkWarning: string;
+            /**
+             * Darkerror
+             * @default #EF5350
+             */
+            darkError: string;
+        };
+        /**
+         * AssetCreate
+         * @description Schema for creating a new asset.
+         */
+        AssetCreate: {
+            /** Slug */
+            slug: string;
+            /** Name */
+            name: string;
+            /** Filepath */
+            filePath: string;
+            /** Filesize */
+            fileSize: number;
+            /** Mimetype */
+            mimeType: string;
+            /** Width */
+            width?: number | null;
+            /** Height */
+            height?: number | null;
+            /** Alttext */
+            altText?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Metadata */
+            metadata?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        /**
+         * 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;
+            /** Filesize */
+            fileSize: number;
+            /** Width */
+            width?: number | null;
+            /** Height */
+            height?: number | null;
+            /** Description */
+            description?: string | null;
+            /** Metadata */
+            metadata_?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Uploadedby
+             * Format: uuid4
+             */
+            uploadedBy: string;
+        };
+        /**
+         * AuthMethod
+         * @description Enumeration for the authentication methods a user can be associated with.
+         * @enum {string}
+         */
+        AuthMethod: "MARVIN" | "LDAP" | "OIDC";
+        /** Body_debug_openai_api_admin_debug_openai_post */
+        Body_debug_openai_api_admin_debug_openai_post: {
+            /** Image */
+            image?: string | null;
+        };
+        /** 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;
+        };
+        /**
+         * 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;
+        };
+        /**
+         * 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;
+        };
+        /**
+         * 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;
+        };
+        /**
+         * DebugResponse
+         * @description Schema for a standardized response from debugging endpoints.
+         *
+         *     Indicates the success status of a debug operation and provides an optional
+         *     response message or data string.
+         */
+        DebugResponse: {
+            /** Success */
+            success: boolean;
+            /** Response */
+            response?: 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;
+        };
+        /**
+         * 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;
+            /** Filesize */
+            fileSize: number;
+            /** Width */
+            width?: number | null;
+            /** Height */
+            height?: number | null;
+            /** Description */
+            description?: string | null;
+            /** Metadata */
+            metadata_?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Uploadedby
+             * Format: uuid4
+             */
+            uploadedBy: string;
+        };
+        /**
+         * EntryCreate
+         * @description Schema for creating an entry.
+         */
+        EntryCreate: {
+            /**
+             * Entrytypeid
+             * Format: uuid4
+             */
+            entryTypeId: string;
+            /** Title */
+            title: string;
+            /** Slug */
+            slug?: string | null;
+            /** Summary */
+            summary?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Contentmarkdown */
+            contentMarkdown?: string | null;
+            /**
+             * Status
+             * @default inbox
+             */
+            status: string;
+            /** Publishedat */
+            publishedAt?: string | null;
+            /** Metadatajson */
+            metadataJson?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        /**
+         * EntryRead
+         * @description Schema for reading an entry.
+         */
+        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;
+            /** Contentmarkdown */
+            contentMarkdown?: string | null;
+            /** Status */
+            status: string;
+            /** Publishedat */
+            publishedAt?: string | null;
+            /** Metadatajson */
+            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[];
+        };
+        /**
+         * 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;
+        };
+        /**
+         * EntryTypeRead
+         * @description Schema for reading an entry type.
+         */
+        EntryTypeRead: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /**
+             * Groupid
+             * Format: uuid4
+             */
+            groupId: string;
+            /** Name */
+            name: string;
+            /** Slug */
+            slug: string;
+            /** Icon */
+            icon?: string | null;
+            /** Color */
+            color?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Sortorder */
+            sortOrder: number;
+            /** Issystem */
+            isSystem: boolean;
+            /** Createdat */
+            createdAt?: string | null;
+            /** Updateat */
+            updateAt?: string | 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;
+        };
+        /**
+         * EntryUpdate
+         * @description Schema for patching an entry.
+         */
+        EntryUpdate: {
+            /** Entrytypeid */
+            entryTypeId?: string | null;
+            /** Title */
+            title?: string | null;
+            /** Slug */
+            slug?: string | null;
+            /** Summary */
+            summary?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Contentmarkdown */
+            contentMarkdown?: string | null;
+            /** Status */
+            status?: string | null;
+            /** Publishedat */
+            publishedAt?: string | null;
+            /** Metadatajson */
+            metadataJson?: {
+                [key: string]: unknown;
+            } | 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" | "collection" | "asset" | "webhook" | "member" | "invitation" | "api_token" | "deployment";
+        /**
+         * 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;
+        };
+        /**
+         * 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 and the group it belongs to.
+         */
+        InviteTokenCreate: {
+            /** Usesleft */
+            usesLeft: number;
+        };
+        /**
+         * 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;
+            /** Token */
+            token: string;
+        };
+        /**
+         * 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";
+        /**
+         * PublishedAssetRead
+         * @description Schema for published assets in the publishing API.
+         *
+         *     Provides asset metadata for external sites to build proper media tags.
+         */
+        PublishedAssetRead: {
+            /** Slug */
+            slug: string;
+            /** Name */
+            name: string;
+            /** Mimetype */
+            mimeType: string;
+            /** Width */
+            width?: number | null;
+            /** Height */
+            height?: number | null;
+            /** Alttext */
+            altText?: string | null;
+            /** Fileurl */
+            fileUrl: string;
+        };
+        /**
+         * 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;
+            /** Entrycount */
+            entryCount: number;
+            /** Entries */
+            entries: components["schemas"]["PublishedEntryListItem"][];
+        };
+        /**
+         * PublishedCollectionSummary
+         * @description Summary schema for published collections (for listing).
+         */
+        PublishedCollectionSummary: {
+            /** Slug */
+            slug: string;
+            /** Name */
+            name: string;
+            /** Description */
+            description?: string | null;
+            /** Entrycount */
+            entryCount: number;
+            /** Sortorder */
+            sortOrder: number;
+            /** Icon */
+            icon?: string | null;
+            /** Color */
+            color?: string | null;
+        };
+        /**
+         * 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;
+            /** Summary */
+            summary?: string | null;
+            /** Publishedat */
+            publishedAt?: string | null;
+            /**
+             * Collections
+             * @default []
+             */
+            collections: string[];
+        };
+        /**
+         * PublishedEntryRead
+         * @description Schema for published entries in the publishing API.
+         *
+         *     Only includes public-facing fields. Excludes all admin metadata,
+         *     internal fields, and user information.
+         */
+        PublishedEntryRead: {
+            /** Slug */
+            slug: string;
+            /** Title */
+            title: string;
+            /** Entrytype */
+            entryType: string;
+            /** Summary */
+            summary?: string | null;
+            /** Contentmarkdown */
+            contentMarkdown?: string | null;
+            /** Publishedat */
+            publishedAt?: string | null;
+            /** Metadata */
+            metadata?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Collections
+             * @default []
+             */
+            collections: string[];
+            /**
+             * Resources
+             * @default []
+             */
+            resources: components["schemas"]["PublishedResourceRead"][];
+            /**
+             * Assets
+             * @default []
+             */
+            assets: components["schemas"]["PublishedAssetRead"][];
+        };
+        /**
+         * PublishedResourceRead
+         * @description Schema for published resources in entry context.
+         *
+         *     Combines resource metadata with entry-specific placement info.
+         */
+        PublishedResourceRead: {
+            /** Slug */
+            slug: string;
+            /** Name */
+            name: string;
+            /** Resourcetype */
+            resourceType: string;
+            /** Description */
+            description?: string | null;
+            /** Url */
+            url?: string | null;
+            /** Externalid */
+            externalId?: string | null;
+            /** Role */
+            role?: string | null;
+            /** Quantity */
+            quantity?: string | null;
+            /** Unit */
+            unit?: string | null;
+            /**
+             * Position
+             * @default 0
+             */
+            position: number;
+        };
+        /**
+         * 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;
+            /** Metadata */
+            metadata?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        /**
+         * PublishedResourcesResponse
+         * @description Paginated response for listing published resources.
+         */
+        PublishedResourcesResponse: {
+            /** Data */
+            data: components["schemas"]["PublishedResourceSummary"][];
+            meta: components["schemas"]["PaginationMeta"];
+        };
+        /**
+         * 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;
+            /** Name */
+            name: string;
+            /** Resourcetype */
+            resourceType: string;
+            /** Description */
+            description?: string | null;
+            /** Url */
+            url?: string | null;
+            /** Externalid */
+            externalId?: string | null;
+            /** Metadata */
+            metadata?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+        };
+        /**
+         * 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;
+            /** Metadata */
+            metadata?: {
+                [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;
+        };
+        /**
+         * 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;
+        };
+        /**
+         * 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: {
+            /**
+             * Workspaceid
+             * Format: uuid4
+             */
+            workspaceId: 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;
+}
+
+/**
+ * Platform API Types
+ *
+ * Re-exports types from the auto-generated OpenAPI schema
+ * with better naming for public API consumption
+ */
+
+/**
+ * Entry (Platform API - full CRUD)
+ */
+type PlatformEntry = components['schemas']['EntryRead'];
+type PlatformEntryCreate = components['schemas']['EntryCreate'];
+type PlatformEntryUpdate = components['schemas']['EntryUpdate'];
+/**
+ * Entry Type
+ */
+type PlatformEntryType = components['schemas']['EntryTypeRead'];
+/**
+ * Collection (Platform API - full CRUD)
+ */
+type PlatformCollection = components['schemas']['CollectionRead'];
+type PlatformCollectionCreate = components['schemas']['CollectionCreate'];
+type PlatformCollectionUpdate = components['schemas']['CollectionUpdate'];
+/**
+ * Resource (Platform API - full CRUD)
+ */
+type PlatformResource = components['schemas']['ResourceRead'];
+type PlatformResourceCreate = components['schemas']['ResourceCreate'];
+type PlatformResourceUpdate = components['schemas']['ResourceUpdate'];
+/**
+ * Asset (Platform API - full CRUD)
+ */
+type PlatformAsset = components['schemas']['AssetRead'];
+type PlatformAssetCreate = components['schemas']['AssetCreate'];
+type PlatformAssetUpdate = Partial<PlatformAssetCreate>;
+/**
+ * API Client (Platform API - manage publishing tokens)
+ */
+type PlatformAPIClient = components['schemas']['APIClientRead'];
+type PlatformAPIClientCreate = components['schemas']['APIClientCreate'];
+type PlatformAPIClientUpdate = components['schemas']['APIClientUpdate'];
+type PlatformAPIClientWithToken = components['schemas']['APIClientWithToken'];
+/**
+ * Workspace Member (Platform API - member management)
+ */
+type PlatformWorkspaceMember = components['schemas']['WorkspaceMembershipRead'];
+type PlatformWorkspaceMemberCreate = components['schemas']['WorkspaceMemberCreate'];
+type PlatformWorkspaceMemberUpdate = components['schemas']['WorkspaceMemberUpdate'];
+
+/**
+ * Entries Module - Platform API
+ *
+ * CRUD operations for entries
+ */
+
+declare class EntriesModule {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * List all entries
+     */
+    list(): Promise<PlatformEntry[]>;
+    /**
+     * Get a single entry by ID
+     */
+    get(id: string): Promise<PlatformEntry>;
+    /**
+     * Create a new entry
+     */
+    create(data: PlatformEntryCreate): Promise<PlatformEntry>;
+    /**
+     * Update an entry
+     */
+    update(id: string, data: PlatformEntryUpdate): Promise<PlatformEntry>;
+    /**
+     * Delete an entry
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Get collections that this entry belongs to
+     */
+    listCollections(entryId: string): Promise<PlatformCollection[]>;
+    /**
+     * Add entry to a collection
+     */
+    addToCollection(entryId: string, collectionId: string): Promise<{
+        message: string;
+    }>;
+    /**
+     * Remove entry from a collection
+     */
+    removeFromCollection(entryId: string, collectionId: string): Promise<void>;
+}
+
+/**
+ * Collections Module - Platform API
+ *
+ * CRUD operations for collections
+ */
+
+declare class CollectionsModule {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * List all collections
+     */
+    list(): Promise<PlatformCollection[]>;
+    /**
+     * Get a single collection by ID
+     */
+    get(id: string): Promise<PlatformCollection>;
+    /**
+     * Create a new collection
+     */
+    create(data: PlatformCollectionCreate): Promise<PlatformCollection>;
+    /**
+     * Update a collection
+     */
+    update(id: string, data: PlatformCollectionUpdate): Promise<PlatformCollection>;
+    /**
+     * Delete a collection
+     */
+    delete(id: string): Promise<void>;
+}
+
+/**
+ * Resources Module - Platform API
+ *
+ * CRUD operations for resources
+ */
+
+declare class ResourcesModule {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * List all resources
+     */
+    list(): Promise<PlatformResource[]>;
+    /**
+     * Get a single resource by ID
+     */
+    get(id: string): Promise<PlatformResource>;
+    /**
+     * Create a new resource
+     */
+    create(data: PlatformResourceCreate): Promise<PlatformResource>;
+    /**
+     * Update a resource
+     */
+    update(id: string, data: PlatformResourceUpdate): Promise<PlatformResource>;
+    /**
+     * Delete a resource
+     */
+    delete(id: string): Promise<void>;
+}
+
+/**
+ * Assets Module - Platform API
+ *
+ * CRUD operations for assets
+ */
+
+declare class AssetsModule {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * List all assets
+     */
+    list(): Promise<PlatformAsset[]>;
+    /**
+     * Get a single asset by ID
+     */
+    get(id: string): Promise<PlatformAsset>;
+    /**
+     * Create a new asset
+     */
+    create(data: PlatformAssetCreate): Promise<PlatformAsset>;
+    /**
+     * Update an asset
+     */
+    update(id: string, data: PlatformAssetUpdate): Promise<PlatformAsset>;
+    /**
+     * Delete an asset
+     */
+    delete(id: string): Promise<void>;
+}
+
+/**
+ * API Clients Module - Platform API
+ *
+ * Manage publishing API tokens
+ */
+
+declare class APIClientsModule {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * List all API clients
+     */
+    list(): Promise<PlatformAPIClient[]>;
+    /**
+     * Get a single API client by ID
+     */
+    get(id: string): Promise<PlatformAPIClient>;
+    /**
+     * Create a new API client (returns client with token)
+     */
+    create(data: PlatformAPIClientCreate): Promise<PlatformAPIClientWithToken>;
+    /**
+     * Update an API client
+     */
+    update(id: string, data: PlatformAPIClientUpdate): Promise<PlatformAPIClient>;
+    /**
+     * Delete an API client
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Rotate API client token (generates new token, invalidates old one)
+     */
+    rotateToken(id: string): Promise<PlatformAPIClientWithToken>;
+    /**
+     * Preview API client token (show token prefix and metadata without revealing full token)
+     */
+    preview(id: string): Promise<PlatformAPIClient>;
+}
+
+/**
+ * Entry Types Module - Platform API
+ *
+ * Read-only access to entry types
+ */
+
+declare class EntryTypesModule {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * List all entry types
+     */
+    list(): Promise<PlatformEntryType[]>;
+    /**
+     * Get a single entry type by ID
+     */
+    get(id: string): Promise<PlatformEntryType>;
+}
+
+/**
+ * Workspace Members Module - Platform API
+ *
+ * Manage workspace members and their roles
+ */
+
+declare class WorkspaceMembersModule {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * List all members of a workspace
+     */
+    list(workspaceId: string): Promise<PlatformWorkspaceMember[]>;
+    /**
+     * Get a specific workspace member
+     */
+    get(workspaceId: string, userId: string): Promise<PlatformWorkspaceMember>;
+    /**
+     * Add a user to a workspace with a specific role
+     */
+    add(workspaceId: string, data: PlatformWorkspaceMemberCreate): Promise<PlatformWorkspaceMember>;
+    /**
+     * Update a workspace member's role
+     */
+    updateRole(workspaceId: string, userId: string, data: PlatformWorkspaceMemberUpdate): Promise<PlatformWorkspaceMember>;
+    /**
+     * Remove a user from a workspace
+     */
+    remove(workspaceId: string, userId: string): Promise<void>;
+}
+
+/**
+ * Platform API Client
+ *
+ * Workspace management API for authenticated users
+ */
+
+interface PlatformClientConfig {
+    apiUrl: string;
+    userToken?: string;
+    credentials?: RequestCredentials;
+}
+declare class PlatformClient extends HttpClient {
+    entries: EntriesModule;
+    collections: CollectionsModule;
+    resources: ResourcesModule;
+    assets: AssetsModule;
+    apiClients: APIClientsModule;
+    entryTypes: EntryTypesModule;
+    workspaceMembers: WorkspaceMembersModule;
+    constructor(config: PlatformClientConfig);
+}
+/**
+ * Create a Platform API client
+ */
+declare function createPlatformClient(config: PlatformClientConfig): PlatformClient;
+
+export { APIClientsModule, AssetsModule, CollectionsModule, EntriesModule, EntryTypesModule, type PlatformAPIClient, type PlatformAPIClientCreate, type PlatformAPIClientUpdate, type PlatformAPIClientWithToken, type PlatformAsset, type PlatformAssetCreate, type PlatformAssetUpdate, PlatformClient, type PlatformClientConfig, type PlatformCollection, type PlatformCollectionCreate, type PlatformCollectionUpdate, type PlatformEntry, type PlatformEntryCreate, type PlatformEntryType, type PlatformEntryUpdate, type PlatformResource, type PlatformResourceCreate, type PlatformResourceUpdate, type PlatformWorkspaceMember, type PlatformWorkspaceMemberCreate, type PlatformWorkspaceMemberUpdate, ResourcesModule, WorkspaceMembersModule, createPlatformClient };