@crowi/api-contract 2.0.0-alpha.1 → 2.0.0-alpha.10

package/dist/generated/openapi.d.mts

@@ -34,7 +34,9 @@ interface paths {
                             confidential: string | null;
                             version: string;
                             apiVersion: string;
-                            capabilities: string[];
+                            capabilities: components["schemas"]["Capability"][];
+                            canSelfRegister: boolean;
+                            rendererStylesheets: string[];
                         };
                     };
                 };
@@ -1115,7 +1117,7 @@ interface paths {
                 };
             };
             responses: {
-                /** @description Password updated */
+                /** @description Password updated; earlier sessions revoked and a fresh token pair issued */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -1125,6 +1127,9 @@ interface paths {
                             /** @enum {string} */
                             status: "ok";
                             message: string;
+                            accessToken: string;
+                            refreshToken: string;
+                            expiresIn: number;
                         };
                     };
                 };
@@ -1227,6 +1232,7 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
                                     renderedAst?: unknown;
                                     rendererVersion?: string;
@@ -2152,6 +2158,64 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/oauth/client-info": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Look up non-secret metadata for a registered OAuth client (authorize/consent screen) */
+        get: {
+            parameters: {
+                query: {
+                    client_id: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Client metadata */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            clientId: string;
+                            name: string;
+                            firstParty: boolean;
+                            trusted: boolean;
+                        };
+                    };
+                };
+                /** @description No client registered with this client_id */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "NOT_FOUND";
+                                message: string;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/user/{username}": {
         parameters: {
             query?: never;
@@ -2229,6 +2293,7 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
                                     renderedAst?: unknown;
                                     rendererVersion?: string;
@@ -2335,6 +2400,7 @@ interface paths {
                                                 username: string;
                                             }[];
                                             codeBlockLanguages?: string[];
+                                            rawSpaceLinks?: string[];
                                         };
                                         renderedAst?: unknown;
                                         rendererVersion?: string;
@@ -2548,6 +2614,7 @@ interface paths {
                                                 username: string;
                                             }[];
                                             codeBlockLanguages?: string[];
+                                            rawSpaceLinks?: string[];
                                         };
                                         renderedAst?: unknown;
                                         rendererVersion?: string;
@@ -2765,6 +2832,7 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
                                     renderedAst?: unknown;
                                     rendererVersion?: string;
@@ -2902,39 +2970,139 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/users": {
+    "/user/{username}/subpages": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** List active users for the member directory (paginated, searchable) */
+        /** Get pages under /user/{username}/ (path-rooted, fully recursive, paginated) */
         get: {
             parameters: {
                 query?: {
-                    q?: string;
                     limit?: number;
                     offset?: number | null;
                 };
                 header?: never;
-                path?: never;
+                path: {
+                    username: string;
+                };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Paginated active users, name-ascending */
+                /** @description Paginated subpages (path-ascending, `_id` tie-break) */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            users: {
+                            pages: {
                                 _id: string;
-                                username: string;
-                                name: string;
-                                image?: string | null;
+                                path: string;
+                                revision?: string | {
+                                    _id: string;
+                                    path: string;
+                                    body: string;
+                                    /** @default markdown */
+                                    format: string;
+                                    author?: {
+                                        _id: string;
+                                        id?: string;
+                                        username: string;
+                                        name: string;
+                                        /** Format: email */
+                                        email: string;
+                                        image?: string | null;
+                                        createdAt: string;
+                                    } | null;
+                                    createdAt: string;
+                                    meta?: {
+                                        toc?: {
+                                            level: number;
+                                            text: string;
+                                            anchorId: string;
+                                        }[];
+                                        wikiLinks?: {
+                                            raw: string;
+                                            target: string;
+                                            displayText?: string;
+                                        }[];
+                                        mentions?: {
+                                            username: string;
+                                        }[];
+                                        codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
+                                    };
+                                    renderedAst?: unknown;
+                                    rendererVersion?: string;
+                                    parentRevisionId?: string | null;
+                                    /** @enum {string} */
+                                    type?: "snapshot" | "incremental";
+                                    savedBy?: string | {
+                                        _id: string;
+                                        id?: string;
+                                        username: string;
+                                        name: string;
+                                        /** Format: email */
+                                        email: string;
+                                        image?: string | null;
+                                        createdAt: string;
+                                    } | null;
+                                    contributors?: (string | {
+                                        _id: string;
+                                        id?: string;
+                                        username: string;
+                                        name: string;
+                                        /** Format: email */
+                                        email: string;
+                                        image?: string | null;
+                                        createdAt: string;
+                                    })[];
+                                    message?: string;
+                                    /** @enum {string} */
+                                    editVia?: "web" | "oauth" | "pat";
+                                };
+                                redirectTo?: string | null;
+                                /** @enum {string|null} */
+                                status?: "wip" | "published" | "deleted" | "deprecated" | "draft" | null;
+                                grant?: number;
+                                grantedUsers?: string[];
+                                creator?: string | {
+                                    _id: string;
+                                    id?: string;
+                                    username: string;
+                                    name: string;
+                                    /** Format: email */
+                                    email: string;
+                                    image?: string | null;
+                                    createdAt: string;
+                                } | null;
+                                lastUpdateUser?: string | {
+                                    _id: string;
+                                    id?: string;
+                                    username: string;
+                                    name: string;
+                                    /** Format: email */
+                                    email: string;
+                                    image?: string | null;
+                                    createdAt: string;
+                                } | null;
+                                liker?: string[];
+                                /** @default 0 */
+                                commentCount: number;
+                                extended?: {
+                                    [key: string]: unknown;
+                                };
+                                createdAt: string;
+                                updatedAt?: string;
+                                currentRevision?: string | null;
+                                yjsCheckpointAt?: string | null;
+                                latestRevision?: string;
+                                likerCount?: number;
+                                seenUsersCount?: number;
                             }[];
                             pager: {
                                 prev: number | null;
@@ -2945,6 +3113,27 @@ interface paths {
                         };
                     };
                 };
+                /** @description Invalid limit/offset */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "VALIDATION_ERROR";
+                                message: string;
+                                details?: {
+                                    fieldErrors: {
+                                        [key: string]: string[];
+                                    };
+                                    formErrors: string[];
+                                };
+                            };
+                        };
+                    };
+                };
                 /** @description Authentication required */
                 401: {
                     headers: {
@@ -2962,6 +3151,40 @@ interface paths {
                         };
                     };
                 };
+                /** @description Missing profile:read and/or pages:read scope */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "INSUFFICIENT_SCOPE";
+                                message: string;
+                                details?: {
+                                    requiredScope: string;
+                                };
+                            };
+                        };
+                    };
+                };
+                /** @description User not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "USER_NOT_FOUND";
+                                /** @enum {string} */
+                                message: "User not found";
+                            };
+                        };
+                    };
+                };
                 /** @description Internal server error */
                 500: {
                     headers: {
@@ -2988,18 +3211,20 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/bookmarks": {
+    "/users": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** Get bookmark of a page for the current user */
+        /** List active users for the member directory (paginated, searchable) */
         get: {
             parameters: {
-                query: {
-                    page_id: string;
+                query?: {
+                    q?: string;
+                    limit?: number;
+                    offset?: number | null;
                 };
                 header?: never;
                 path?: never;
@@ -3007,39 +3232,123 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Bookmark for the page (or null when not bookmarked) */
+                /** @description Paginated active users, name-ascending */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            bookmark: {
+                            users: {
                                 _id: string;
-                                page: {
-                                    _id: string;
-                                    path: string;
-                                    revision?: string | {
-                                        _id: string;
-                                        path: string;
-                                        body: string;
-                                        /** @default markdown */
-                                        format: string;
-                                        author?: {
-                                            _id: string;
-                                            id?: string;
-                                            username: string;
-                                            name: string;
-                                            /** Format: email */
-                                            email: string;
-                                            image?: string | null;
-                                            createdAt: string;
-                                        } | null;
-                                        createdAt: string;
-                                        meta?: {
-                                            toc?: {
-                                                level: number;
-                                                text: string;
+                                username: string;
+                                name: string;
+                                image?: string | null;
+                            }[];
+                            pager: {
+                                prev: number | null;
+                                next: number | null;
+                                offset: number;
+                            };
+                            total: number;
+                        };
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "AUTHENTICATION_REQUIRED";
+                                /** @enum {string} */
+                                message: "Authentication is required";
+                                redirectTo?: string;
+                            };
+                        };
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "INTERNAL_ERROR";
+                                /** @enum {string} */
+                                message: "Internal server error";
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/bookmarks": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get bookmark of a page for the current user */
+        get: {
+            parameters: {
+                query: {
+                    page_id: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Bookmark for the page (or null when not bookmarked) */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            bookmark: {
+                                _id: string;
+                                page: {
+                                    _id: string;
+                                    path: string;
+                                    revision?: string | {
+                                        _id: string;
+                                        path: string;
+                                        body: string;
+                                        /** @default markdown */
+                                        format: string;
+                                        author?: {
+                                            _id: string;
+                                            id?: string;
+                                            username: string;
+                                            name: string;
+                                            /** Format: email */
+                                            email: string;
+                                            image?: string | null;
+                                            createdAt: string;
+                                        } | null;
+                                        createdAt: string;
+                                        meta?: {
+                                            toc?: {
+                                                level: number;
+                                                text: string;
                                                 anchorId: string;
                                             }[];
                                             wikiLinks?: {
@@ -3051,6 +3360,7 @@ interface paths {
                                                 username: string;
                                             }[];
                                             codeBlockLanguages?: string[];
+                                            rawSpaceLinks?: string[];
                                         };
                                         renderedAst?: unknown;
                                         rendererVersion?: string;
@@ -3250,6 +3560,7 @@ interface paths {
                                                 username: string;
                                             }[];
                                             codeBlockLanguages?: string[];
+                                            rawSpaceLinks?: string[];
                                         };
                                         renderedAst?: unknown;
                                         rendererVersion?: string;
@@ -3535,6 +3846,7 @@ interface paths {
                                                 username: string;
                                             }[];
                                             codeBlockLanguages?: string[];
+                                            rawSpaceLinks?: string[];
                                         };
                                         renderedAst?: unknown;
                                         rendererVersion?: string;
@@ -3762,6 +4074,22 @@ interface paths {
                         };
                     };
                 };
+                /** @description Page not found or not granted */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "PAGE_NOT_FOUND";
+                                /** @enum {string} */
+                                message: "Page not found";
+                            };
+                        };
+                    };
+                };
             };
         };
         put?: never;
@@ -3853,6 +4181,22 @@ interface paths {
                         };
                     };
                 };
+                /** @description Page / revision not found, or the caller cannot access it (existence hidden) */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "PAGE_NOT_FOUND";
+                                /** @enum {string} */
+                                message: "Page not found";
+                            };
+                        };
+                    };
+                };
             };
         };
         put?: never;
@@ -4245,6 +4589,7 @@ interface paths {
                                         username: string;
                                     }[];
                                     codeBlockLanguages?: string[];
+                                    rawSpaceLinks?: string[];
                                 };
                                 renderedAst?: unknown;
                                 rendererVersion?: string;
@@ -4394,6 +4739,7 @@ interface paths {
                                         username: string;
                                     }[];
                                     codeBlockLanguages?: string[];
+                                    rawSpaceLinks?: string[];
                                 };
                                 renderedAst?: unknown;
                                 rendererVersion?: string;
@@ -4548,6 +4894,7 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
                                     renderedAst?: unknown;
                                     rendererVersion?: string;
@@ -4669,6 +5016,22 @@ interface paths {
                         };
                     };
                 };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "INTERNAL_ERROR";
+                                /** @enum {string} */
+                                message: "Internal server error";
+                            };
+                        };
+                    };
+                };
             };
         };
         /** Update existing page */
@@ -4732,6 +5095,7 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
                                     renderedAst?: unknown;
                                     rendererVersion?: string;
@@ -4928,6 +5292,7 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
                                     renderedAst?: unknown;
                                     rendererVersion?: string;
@@ -5000,7 +5365,7 @@ interface paths {
                         };
                     };
                 };
-                /** @description Invalid request (PAGE_EXISTS / NON_EXISTENT_USER_PAGE / PAGE_CREATE_FAILED / INVALID_GRANT) */
+                /** @description Invalid request (PAGE_INVALID_NAME / PAGE_EXISTS / NON_EXISTENT_USER_PAGE / PAGE_CREATE_FAILED / INVALID_GRANT) */
                 400: {
                     headers: {
                         [name: string]: unknown;
@@ -5093,6 +5458,7 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
                                     renderedAst?: unknown;
                                     rendererVersion?: string;
@@ -5252,6 +5618,7 @@ interface paths {
                     include_deleted?: boolean | null;
                     sort?: "updatedAt" | "createdAt" | "path";
                     order?: "asc" | "desc";
+                    revision_id?: string;
                 };
                 header?: never;
                 path?: never;
@@ -5301,6 +5668,7 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
                                     renderedAst?: unknown;
                                     rendererVersion?: string;
@@ -5410,6 +5778,7 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
                                     renderedAst?: unknown;
                                     rendererVersion?: string;
@@ -5479,106 +5848,222 @@ interface paths {
                                 likerCount?: number;
                                 seenUsersCount?: number;
                             } | null;
-                        };
-                    };
-                };
-                /** @description Authentication required */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            error: {
-                                /** @enum {string} */
-                                code: "AUTHENTICATION_REQUIRED";
-                                /** @enum {string} */
-                                message: "Authentication is required";
-                                redirectTo?: string;
-                            };
-                        };
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/pages/children": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** List immediate child segments under a portal path (sidebar tree) */
-        get: {
-            parameters: {
-                query: {
-                    path: string;
-                };
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description First-level child segments (alphabetical) under the path */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            children: {
-                                segment: string;
+                            contentPage?: {
+                                _id: string;
                                 path: string;
-                                isPage: boolean;
-                                hasPortal: boolean;
-                                count: number;
-                            }[];
-                        };
-                    };
-                };
-                /** @description Authentication required */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            error: {
-                                /** @enum {string} */
-                                code: "AUTHENTICATION_REQUIRED";
-                                /** @enum {string} */
-                                message: "Authentication is required";
-                                redirectTo?: string;
-                            };
-                        };
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/pages/grant": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
+                                revision?: string | {
+                                    _id: string;
+                                    path: string;
+                                    body: string;
+                                    /** @default markdown */
+                                    format: string;
+                                    author?: {
+                                        _id: string;
+                                        id?: string;
+                                        username: string;
+                                        name: string;
+                                        /** Format: email */
+                                        email: string;
+                                        image?: string | null;
+                                        createdAt: string;
+                                    } | null;
+                                    createdAt: string;
+                                    meta?: {
+                                        toc?: {
+                                            level: number;
+                                            text: string;
+                                            anchorId: string;
+                                        }[];
+                                        wikiLinks?: {
+                                            raw: string;
+                                            target: string;
+                                            displayText?: string;
+                                        }[];
+                                        mentions?: {
+                                            username: string;
+                                        }[];
+                                        codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
+                                    };
+                                    renderedAst?: unknown;
+                                    rendererVersion?: string;
+                                    parentRevisionId?: string | null;
+                                    /** @enum {string} */
+                                    type?: "snapshot" | "incremental";
+                                    savedBy?: string | {
+                                        _id: string;
+                                        id?: string;
+                                        username: string;
+                                        name: string;
+                                        /** Format: email */
+                                        email: string;
+                                        image?: string | null;
+                                        createdAt: string;
+                                    } | null;
+                                    contributors?: (string | {
+                                        _id: string;
+                                        id?: string;
+                                        username: string;
+                                        name: string;
+                                        /** Format: email */
+                                        email: string;
+                                        image?: string | null;
+                                        createdAt: string;
+                                    })[];
+                                    message?: string;
+                                    /** @enum {string} */
+                                    editVia?: "web" | "oauth" | "pat";
+                                };
+                                redirectTo?: string | null;
+                                /** @enum {string|null} */
+                                status?: "wip" | "published" | "deleted" | "deprecated" | "draft" | null;
+                                grant?: number;
+                                grantedUsers?: string[];
+                                creator?: string | {
+                                    _id: string;
+                                    id?: string;
+                                    username: string;
+                                    name: string;
+                                    /** Format: email */
+                                    email: string;
+                                    image?: string | null;
+                                    createdAt: string;
+                                } | null;
+                                lastUpdateUser?: string | {
+                                    _id: string;
+                                    id?: string;
+                                    username: string;
+                                    name: string;
+                                    /** Format: email */
+                                    email: string;
+                                    image?: string | null;
+                                    createdAt: string;
+                                } | null;
+                                liker?: string[];
+                                /** @default 0 */
+                                commentCount: number;
+                                extended?: {
+                                    [key: string]: unknown;
+                                };
+                                createdAt: string;
+                                updatedAt?: string;
+                                currentRevision?: string | null;
+                                yjsCheckpointAt?: string | null;
+                                latestRevision?: string;
+                                likerCount?: number;
+                                seenUsersCount?: number;
+                            } | null;
+                        };
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "AUTHENTICATION_REQUIRED";
+                                /** @enum {string} */
+                                message: "Authentication is required";
+                                redirectTo?: string;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/pages/children": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List immediate child segments under a portal path (sidebar tree) */
+        get: {
+            parameters: {
+                query: {
+                    path: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description First-level child segments (alphabetical) under the path */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            children: {
+                                segment: string;
+                                path: string;
+                                isPage: boolean;
+                                hasPortal: boolean;
+                                count: number;
+                                lastUpdatedAt?: string | null;
+                                updater?: {
+                                    _id: string;
+                                    id?: string;
+                                    username: string;
+                                    name: string;
+                                    /** Format: email */
+                                    email: string;
+                                    image?: string | null;
+                                    createdAt: string;
+                                } | null;
+                            }[];
+                        };
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "AUTHENTICATION_REQUIRED";
+                                /** @enum {string} */
+                                message: "Authentication is required";
+                                redirectTo?: string;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/pages/grant": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
         get?: never;
         /** Update page grant (visibility) only — no revision pushed */
         put: {
@@ -5639,6 +6124,7 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
                                     renderedAst?: unknown;
                                     rendererVersion?: string;
@@ -6043,6 +6529,7 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
                                     renderedAst?: unknown;
                                     rendererVersion?: string;
@@ -6238,6 +6725,7 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
                                     renderedAst?: unknown;
                                     rendererVersion?: string;
@@ -6366,59 +6854,295 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/pages/watch": {
+    "/pages/link-access": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** Get watch (notification subscription) status for a page */
-        get: {
+        get?: never;
+        put?: never;
+        /** Resolve a page by id, granting first-time link-share access to GRANT_RESTRICTED pages */
+        post: {
             parameters: {
-                query: {
-                    page_id: string;
-                };
+                query?: never;
                 header?: never;
                 path?: never;
                 cookie?: never;
             };
-            requestBody?: never;
-            responses: {
-                /** @description Watching status (true / false) */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            watching: boolean;
-                        };
-                    };
-                };
-                /** @description Invalid page_id */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            error: {
-                                /** @enum {string} */
-                                code: "INVALID_PAGE_ID";
-                                message: string;
-                            };
-                        };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        page_id: string;
                     };
                 };
-                /** @description Authentication required */
-                401: {
+            };
+            responses: {
+                /** @description The resolved page, with `granted` telling whether this call just added the caller to grantedUsers */
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            error: {
+                            page: {
+                                _id: string;
+                                path: string;
+                                revision: {
+                                    _id: string;
+                                    path: string;
+                                    body: string;
+                                    /** @default markdown */
+                                    format: string;
+                                    author?: {
+                                        _id: string;
+                                        id?: string;
+                                        username: string;
+                                        name: string;
+                                        /** Format: email */
+                                        email: string;
+                                        image?: string | null;
+                                        createdAt: string;
+                                    } | null;
+                                    createdAt: string;
+                                    meta?: {
+                                        toc?: {
+                                            level: number;
+                                            text: string;
+                                            anchorId: string;
+                                        }[];
+                                        wikiLinks?: {
+                                            raw: string;
+                                            target: string;
+                                            displayText?: string;
+                                        }[];
+                                        mentions?: {
+                                            username: string;
+                                        }[];
+                                        codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
+                                    };
+                                    renderedAst?: unknown;
+                                    rendererVersion?: string;
+                                    parentRevisionId?: string | null;
+                                    /** @enum {string} */
+                                    type?: "snapshot" | "incremental";
+                                    savedBy?: string | {
+                                        _id: string;
+                                        id?: string;
+                                        username: string;
+                                        name: string;
+                                        /** Format: email */
+                                        email: string;
+                                        image?: string | null;
+                                        createdAt: string;
+                                    } | null;
+                                    contributors?: (string | {
+                                        _id: string;
+                                        id?: string;
+                                        username: string;
+                                        name: string;
+                                        /** Format: email */
+                                        email: string;
+                                        image?: string | null;
+                                        createdAt: string;
+                                    })[];
+                                    message?: string;
+                                    /** @enum {string} */
+                                    editVia?: "web" | "oauth" | "pat";
+                                };
+                                redirectTo?: string | null;
+                                /** @enum {string|null} */
+                                status?: "wip" | "published" | "deleted" | "deprecated" | "draft" | null;
+                                grant?: number;
+                                grantedUsers?: string[];
+                                creator?: {
+                                    _id: string;
+                                    id?: string;
+                                    username: string;
+                                    name: string;
+                                    /** Format: email */
+                                    email: string;
+                                    image?: string | null;
+                                    createdAt: string;
+                                } | null;
+                                lastUpdateUser?: {
+                                    _id: string;
+                                    id?: string;
+                                    username: string;
+                                    name: string;
+                                    /** Format: email */
+                                    email: string;
+                                    image?: string | null;
+                                    createdAt: string;
+                                } | null;
+                                liker?: string[];
+                                /** @default 0 */
+                                commentCount: number;
+                                extended?: {
+                                    [key: string]: unknown;
+                                };
+                                createdAt: string;
+                                updatedAt?: string;
+                                currentRevision?: string | null;
+                                yjsCheckpointAt?: string | null;
+                                latestRevision?: string;
+                                likerCount?: number;
+                                seenUsersCount?: number;
+                            };
+                            granted: boolean;
+                        };
+                    };
+                };
+                /** @description Invalid page_id */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "INVALID_PAGE_ID";
+                                message: string;
+                            };
+                        };
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "AUTHENTICATION_REQUIRED";
+                                /** @enum {string} */
+                                message: "Authentication is required";
+                                redirectTo?: string;
+                            };
+                        };
+                    };
+                };
+                /** @description The caller has no access to the page (isGrantedFor is false) or lacks scope / is a non-web session — 403 is about the caller lacking access, never about the page grant type per se */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "PAGE_NOT_GRANTED";
+                                /** @enum {string} */
+                                message: "Page is not granted for the user";
+                            };
+                        } | {
+                            error: {
+                                /** @enum {string} */
+                                code: "INSUFFICIENT_SCOPE";
+                                message: string;
+                                details?: {
+                                    requiredScope: string;
+                                };
+                            };
+                        };
+                    };
+                };
+                /** @description Page not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "PAGE_NOT_FOUND";
+                                /** @enum {string} */
+                                message: "Page not found";
+                            };
+                        };
+                    };
+                };
+                /** @description Rate limit exceeded for POST /pages/link-access (per-user). Same wire shape as autocomplete rate limiting. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {string} */
+                            error: "rate_limited";
+                            message: string;
+                            retryAfterSeconds: number;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/pages/watch": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get watch (notification subscription) status for a page */
+        get: {
+            parameters: {
+                query: {
+                    page_id: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Watching status (true / false) */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            watching: boolean;
+                        };
+                    };
+                };
+                /** @description Invalid page_id */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "INVALID_PAGE_ID";
+                                message: string;
+                            };
+                        };
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
                                 /** @enum {string} */
                                 code: "AUTHENTICATION_REQUIRED";
                                 /** @enum {string} */
@@ -6470,11 +7194,208 @@ interface paths {
                     };
                     content: {
                         "application/json": {
-                            watching: boolean;
+                            watching: boolean;
+                        };
+                    };
+                };
+                /** @description Invalid page_id */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "INVALID_PAGE_ID";
+                                message: string;
+                            };
+                        };
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "AUTHENTICATION_REQUIRED";
+                                /** @enum {string} */
+                                message: "Authentication is required";
+                                redirectTo?: string;
+                            };
+                        };
+                    };
+                };
+                /** @description Page not found (also covers grant-denied) */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "PAGE_NOT_FOUND";
+                                /** @enum {string} */
+                                message: "Page not found";
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/pages/revert": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Revert a soft-deleted page (restore from /trash/...) */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        page_id: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description The restored page */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            page: {
+                                _id: string;
+                                path: string;
+                                revision?: string | {
+                                    _id: string;
+                                    path: string;
+                                    body: string;
+                                    /** @default markdown */
+                                    format: string;
+                                    author?: {
+                                        _id: string;
+                                        id?: string;
+                                        username: string;
+                                        name: string;
+                                        /** Format: email */
+                                        email: string;
+                                        image?: string | null;
+                                        createdAt: string;
+                                    } | null;
+                                    createdAt: string;
+                                    meta?: {
+                                        toc?: {
+                                            level: number;
+                                            text: string;
+                                            anchorId: string;
+                                        }[];
+                                        wikiLinks?: {
+                                            raw: string;
+                                            target: string;
+                                            displayText?: string;
+                                        }[];
+                                        mentions?: {
+                                            username: string;
+                                        }[];
+                                        codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
+                                    };
+                                    renderedAst?: unknown;
+                                    rendererVersion?: string;
+                                    parentRevisionId?: string | null;
+                                    /** @enum {string} */
+                                    type?: "snapshot" | "incremental";
+                                    savedBy?: string | {
+                                        _id: string;
+                                        id?: string;
+                                        username: string;
+                                        name: string;
+                                        /** Format: email */
+                                        email: string;
+                                        image?: string | null;
+                                        createdAt: string;
+                                    } | null;
+                                    contributors?: (string | {
+                                        _id: string;
+                                        id?: string;
+                                        username: string;
+                                        name: string;
+                                        /** Format: email */
+                                        email: string;
+                                        image?: string | null;
+                                        createdAt: string;
+                                    })[];
+                                    message?: string;
+                                    /** @enum {string} */
+                                    editVia?: "web" | "oauth" | "pat";
+                                };
+                                redirectTo?: string | null;
+                                /** @enum {string|null} */
+                                status?: "wip" | "published" | "deleted" | "deprecated" | "draft" | null;
+                                grant?: number;
+                                grantedUsers?: string[];
+                                creator?: string | {
+                                    _id: string;
+                                    id?: string;
+                                    username: string;
+                                    name: string;
+                                    /** Format: email */
+                                    email: string;
+                                    image?: string | null;
+                                    createdAt: string;
+                                } | null;
+                                lastUpdateUser?: string | {
+                                    _id: string;
+                                    id?: string;
+                                    username: string;
+                                    name: string;
+                                    /** Format: email */
+                                    email: string;
+                                    image?: string | null;
+                                    createdAt: string;
+                                } | null;
+                                liker?: string[];
+                                /** @default 0 */
+                                commentCount: number;
+                                extended?: {
+                                    [key: string]: unknown;
+                                };
+                                createdAt: string;
+                                updatedAt?: string;
+                                currentRevision?: string | null;
+                                yjsCheckpointAt?: string | null;
+                                latestRevision?: string;
+                                likerCount?: number;
+                                seenUsersCount?: number;
+                            };
                         };
                     };
                 };
-                /** @description Invalid page_id */
+                /** @description PAGE_REVERT_FAILED */
                 400: {
                     headers: {
                         [name: string]: unknown;
@@ -6482,8 +7403,7 @@ interface paths {
                     content: {
                         "application/json": {
                             error: {
-                                /** @enum {string} */
-                                code: "INVALID_PAGE_ID";
+                                code: string;
                                 message: string;
                             };
                         };
@@ -6524,14 +7444,13 @@ interface paths {
                 };
             };
         };
-        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/pages/revert": {
+    "/pages/revert-to-revision": {
         parameters: {
             query?: never;
             header?: never;
@@ -6540,7 +7459,7 @@ interface paths {
         };
         get?: never;
         put?: never;
-        /** Revert a soft-deleted page (restore from /trash/...) */
+        /** Revert a page to one of its past revisions (non-destructive — stacks a new revision) */
         post: {
             parameters: {
                 query?: never;
@@ -6552,11 +7471,12 @@ interface paths {
                 content: {
                     "application/json": {
                         page_id: string;
+                        revision_id: string;
                     };
                 };
             };
             responses: {
-                /** @description The restored page */
+                /** @description The page with the reverted body as its new latest revision */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -6598,6 +7518,7 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
                                     renderedAst?: unknown;
                                     rendererVersion?: string;
@@ -6670,7 +7591,7 @@ interface paths {
                         };
                     };
                 };
-                /** @description PAGE_REVERT_FAILED */
+                /** @description PAGE_REVERT_TO_REVISION_FAILED (e.g. the revision does not belong to the page) */
                 400: {
                     headers: {
                         [name: string]: unknown;
@@ -6796,6 +7717,7 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
                                     renderedAst?: unknown;
                                     rendererVersion?: string;
@@ -7091,6 +8013,20 @@ interface paths {
                         };
                     };
                 };
+                /** @description Per-user rate limit exceeded */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {string} */
+                            error: "rate_limited";
+                            message: string;
+                            retryAfterSeconds: number;
+                        };
+                    };
+                };
                 /** @description Renderer pipeline failure */
                 500: {
                     headers: {
@@ -7907,6 +8843,7 @@ interface paths {
                                 fileSize: number;
                                 createdAt: string;
                                 url: string;
+                                originalUrl: string;
                                 inUse: boolean;
                             }[];
                             past: {
@@ -7934,6 +8871,7 @@ interface paths {
                                     fileSize: number;
                                     createdAt: string;
                                     url: string;
+                                    originalUrl: string;
                                     inUse: boolean;
                                 };
                                 referencingRevisions: {
@@ -8082,6 +9020,7 @@ interface paths {
                                 fileSize: number;
                                 createdAt: string;
                                 url: string;
+                                originalUrl: string;
                                 inUse: boolean;
                             }[];
                         };
@@ -8204,6 +9143,7 @@ interface paths {
                                 fileSize: number;
                                 createdAt: string;
                                 url: string;
+                                originalUrl: string;
                                 inUse: boolean;
                             };
                             url: string;
@@ -8509,6 +9449,7 @@ interface paths {
                             fileSize: number;
                             createdAt: string;
                             url: string;
+                            originalUrl: string;
                         };
                     };
                 };
@@ -8780,6 +9721,7 @@ interface paths {
                                                 username: string;
                                             }[];
                                             codeBlockLanguages?: string[];
+                                            rawSpaceLinks?: string[];
                                         };
                                         renderedAst?: unknown;
                                         rendererVersion?: string;
@@ -9509,6 +10451,7 @@ interface paths {
                             /** @enum {string} */
                             registrationMode: "Open" | "Resricted" | "Closed";
                             registrationWhiteList: string[];
+                            linkCardEnabled: boolean;
                         };
                     };
                 };
@@ -9578,6 +10521,7 @@ interface paths {
                         /** @enum {string} */
                         registrationMode: "Open" | "Resricted" | "Closed";
                         registrationWhiteList: string[];
+                        linkCardEnabled: boolean;
                     };
                 };
             };
@@ -9592,6 +10536,7 @@ interface paths {
                             /** @enum {string} */
                             registrationMode: "Open" | "Resricted" | "Closed";
                             registrationWhiteList: string[];
+                            linkCardEnabled: boolean;
                         };
                     };
                 };
@@ -10481,20 +11426,169 @@ interface paths {
                 };
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody?: never;
+            responses: {
+                /** @description User removed */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            deletedId: string;
+                        };
+                    };
+                };
+                /** @description Invalid id */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "VALIDATION_ERROR";
+                                message: string;
+                                details?: {
+                                    fieldErrors: {
+                                        [key: string]: string[];
+                                    };
+                                    formErrors: string[];
+                                };
+                            };
+                        };
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "AUTHENTICATION_REQUIRED";
+                                /** @enum {string} */
+                                message: "Authentication is required";
+                                redirectTo?: string;
+                            };
+                        };
+                    };
+                };
+                /** @description Admin permission required */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "ADMIN_REQUIRED";
+                                /** @enum {string} */
+                                message: "Admin permission required";
+                                redirectTo?: string;
+                            };
+                        };
+                    };
+                };
+                /** @description User not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "NOT_FOUND";
+                                message: string;
+                            };
+                        };
+                    };
+                };
+                /** @description User is not in the INVITED status and cannot be physically removed */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "CONFLICT";
+                                message: string;
+                            };
+                        };
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "INTERNAL_ERROR";
+                                /** @enum {string} */
+                                message: "Internal server error";
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        options?: never;
+        head?: never;
+        /** Update a user's name and email */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        name: string;
+                        /** Format: email */
+                        email: string;
+                    };
+                };
+            };
             responses: {
-                /** @description User removed */
+                /** @description Updated user */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            deletedId: string;
+                            user: {
+                                _id: string;
+                                id?: string;
+                                username: string;
+                                name: string;
+                                /** Format: email */
+                                email: string;
+                                image?: string | null;
+                                introduction?: string;
+                                createdAt: string;
+                                admin?: boolean;
+                                /** @enum {integer} */
+                                status?: 1 | 2 | 3 | 4 | 5;
+                            };
                         };
                     };
                 };
-                /** @description Invalid id */
+                /** @description Validation error */
                 400: {
                     headers: {
                         [name: string]: unknown;
@@ -10564,7 +11658,7 @@ interface paths {
                         };
                     };
                 };
-                /** @description User is not in the INVITED status and cannot be physically removed */
+                /** @description Email already in use by another user */
                 409: {
                     headers: {
                         [name: string]: unknown;
@@ -10597,10 +11691,18 @@ interface paths {
                 };
             };
         };
-        options?: never;
-        head?: never;
-        /** Update a user's name and email */
-        patch: {
+        trace?: never;
+    };
+    "/admin/users/{id}/admin": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /** Grant admin permission to a user */
+        put: {
             parameters: {
                 query?: never;
                 header?: never;
@@ -10609,15 +11711,7 @@ interface paths {
                 };
                 cookie?: never;
             };
-            requestBody?: {
-                content: {
-                    "application/json": {
-                        name: string;
-                        /** Format: email */
-                        email: string;
-                    };
-                };
-            };
+            requestBody?: never;
             responses: {
                 /** @description Updated user */
                 200: {
@@ -10643,7 +11737,7 @@ interface paths {
                         };
                     };
                 };
-                /** @description Validation error */
+                /** @description Invalid id */
                 400: {
                     headers: {
                         [name: string]: unknown;
@@ -10713,21 +11807,6 @@ interface paths {
                         };
                     };
                 };
-                /** @description Email already in use by another user */
-                409: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            error: {
-                                /** @enum {string} */
-                                code: "CONFLICT";
-                                message: string;
-                            };
-                        };
-                    };
-                };
                 /** @description Internal server error */
                 500: {
                     headers: {
@@ -10746,18 +11825,9 @@ interface paths {
                 };
             };
         };
-        trace?: never;
-    };
-    "/admin/users/{id}/admin": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        /** Grant admin permission to a user */
-        put: {
+        post?: never;
+        /** Revoke admin permission from a user */
+        delete: {
             parameters: {
                 query?: never;
                 header?: never;
@@ -10880,9 +11950,21 @@ interface paths {
                 };
             };
         };
-        post?: never;
-        /** Revoke admin permission from a user */
-        delete: {
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/admin/users/{id}/status/active": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /** Activate a user (status -> ACTIVE) */
+        put: {
             parameters: {
                 query?: never;
                 header?: never;
@@ -11005,12 +12087,14 @@ interface paths {
                 };
             };
         };
+        post?: never;
+        delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/admin/users/{id}/status/active": {
+    "/admin/users/{id}/status/suspended": {
         parameters: {
             query?: never;
             header?: never;
@@ -11018,7 +12102,7 @@ interface paths {
             cookie?: never;
         };
         get?: never;
-        /** Activate a user (status -> ACTIVE) */
+        /** Suspend a user (status -> SUSPENDED) */
         put: {
             parameters: {
                 query?: never;
@@ -11149,7 +12233,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/admin/users/{id}/status/suspended": {
+    "/admin/users/{id}/reset-password": {
         parameters: {
             query?: never;
             header?: never;
@@ -11157,8 +12241,9 @@ interface paths {
             cookie?: never;
         };
         get?: never;
-        /** Suspend a user (status -> SUSPENDED) */
-        put: {
+        put?: never;
+        /** Reset a user's password to a random value (returns plaintext) */
+        post: {
             parameters: {
                 query?: never;
                 header?: never;
@@ -11169,7 +12254,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Updated user */
+                /** @description Updated user + new plaintext password */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -11190,6 +12275,7 @@ interface paths {
                                 /** @enum {integer} */
                                 status?: 1 | 2 | 3 | 4 | 5;
                             };
+                            newPassword: string;
                         };
                     };
                 };
@@ -11281,14 +12367,13 @@ interface paths {
                 };
             };
         };
-        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/admin/users/{id}/reset-password": {
+    "/admin/users/{id}/resend-invite": {
         parameters: {
             query?: never;
             header?: never;
@@ -11297,7 +12382,7 @@ interface paths {
         };
         get?: never;
         put?: never;
-        /** Reset a user's password to a random value (returns plaintext) */
+        /** Re-issue an invite token and resend the invitation email (INVITED status only) */
         post: {
             parameters: {
                 query?: never;
@@ -11309,7 +12394,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Updated user + new plaintext password */
+                /** @description Invitation email resent; returns the (unchanged) user */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -11330,7 +12415,6 @@ interface paths {
                                 /** @enum {integer} */
                                 status?: 1 | 2 | 3 | 4 | 5;
                             };
-                            newPassword: string;
                         };
                     };
                 };
@@ -11404,7 +12488,22 @@ interface paths {
                         };
                     };
                 };
-                /** @description Internal server error */
+                /** @description User is not in the INVITED status, so there is no pending invite to resend */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "CONFLICT";
+                                message: string;
+                            };
+                        };
+                    };
+                };
+                /** @description Internal server error (e.g. the invitation email failed to send) */
                 500: {
                     headers: {
                         [name: string]: unknown;
@@ -11705,15 +12804,22 @@ interface paths {
                                 name: string;
                                 version: string;
                                 requires?: string[];
+                                modelAccess?: string[];
                                 hasConfig: boolean;
                                 registers: string[];
                                 adminPlacement: {
                                     /** @enum {string} */
-                                    section: "settings" | "shared" | "storage" | "mail" | "notification" | "auth" | "search" | "renderer";
+                                    section: "settings" | "shared" | "storage" | "mail" | "notification" | "auth" | "search" | "renderer" | "platform";
                                     label: string;
                                     icon?: string;
                                 };
                                 supportsHotReload: boolean;
+                                /**
+                                 * @default active
+                                 * @enum {string}
+                                 */
+                                status: "active" | "failed";
+                                error?: string;
                             }[];
                         };
                     };
@@ -12699,7 +13805,7 @@ interface components {
             };
         };
         /** @enum {string} */
-        ErrorCode: "AUTHENTICATION_REQUIRED" | "ADMIN_REQUIRED" | "THIRD_PARTY_AUTH_REQUIRED" | "USER_REGISTERED" | "USER_SUSPENDED" | "USER_INVITED" | "USER_NOT_ACTIVE" | "EMAIL_NOT_CONFIRMED" | "INTERNAL_ERROR" | "VALIDATION_ERROR" | "INVALID_REQUEST" | "NOT_FOUND" | "CONFLICT" | "SERVICE_UNAVAILABLE" | "APPLICATION_NOT_INSTALLED" | "INVALID_PAGE_ID" | "PAGE_NOT_FOUND" | "PAGE_NOT_GRANTED" | "PAGE_REVISION_ERROR" | "INVALID_GRANT" | "COMMENT_NOT_FOUND" | "NOTIFICATION_NOT_FOUND" | "USER_NOT_FOUND" | "USER_EXISTS" | "USERNAME_TAKEN" | "EMAIL_TAKEN" | "EMAIL_NOT_ALLOWED" | "INVALID_ACTIVATION_TOKEN" | "INVALID_INVITE_TOKEN" | "INVITE_ALREADY_ACCEPTED" | "INVALID_RESET_TOKEN" | "INVALID_EMAIL_CHANGE_TOKEN" | "INVALID_CREDENTIALS" | "REFRESH_TOKEN_REQUIRED" | "REGISTRATION_CLOSED" | "ENCRYPTION_NOT_CONFIGURED" | "MAIL_TEST_FAILED" | "PLUGIN_NOT_FOUND" | "PLUGIN_CONFIG_VALIDATION_FAILED";
+        ErrorCode: "AUTHENTICATION_REQUIRED" | "ADMIN_REQUIRED" | "THIRD_PARTY_AUTH_REQUIRED" | "USER_REGISTERED" | "USER_SUSPENDED" | "USER_INVITED" | "USER_NOT_ACTIVE" | "EMAIL_NOT_CONFIRMED" | "INTERNAL_ERROR" | "VALIDATION_ERROR" | "INVALID_REQUEST" | "NOT_FOUND" | "CONFLICT" | "SERVICE_UNAVAILABLE" | "APPLICATION_NOT_INSTALLED" | "INVALID_PAGE_ID" | "PAGE_NOT_FOUND" | "PAGE_NOT_GRANTED" | "PAGE_REVISION_ERROR" | "PAGE_TWIN_EXISTS" | "INVALID_GRANT" | "COMMENT_NOT_FOUND" | "NOTIFICATION_NOT_FOUND" | "USER_NOT_FOUND" | "USER_EXISTS" | "USERNAME_TAKEN" | "EMAIL_TAKEN" | "EMAIL_NOT_ALLOWED" | "INVALID_ACTIVATION_TOKEN" | "INVALID_INVITE_TOKEN" | "INVITE_ALREADY_ACCEPTED" | "INVALID_RESET_TOKEN" | "INVALID_EMAIL_CHANGE_TOKEN" | "INVALID_CREDENTIALS" | "REFRESH_TOKEN_REQUIRED" | "REGISTRATION_CLOSED" | "ENCRYPTION_NOT_CONFIGURED" | "MAIL_TEST_FAILED" | "PLUGIN_NOT_FOUND" | "PLUGIN_CONFIG_VALIDATION_FAILED";
         ApplicationNotInstalledError: {
             error: {
                 /** @enum {string} */
@@ -12880,6 +13986,12 @@ interface components {
             /** @enum {string} */
             status: "approved" | "denied";
         };
+        ClientInfoResponse: {
+            clientId: string;
+            name: string;
+            firstParty: boolean;
+            trusted: boolean;
+        };
         UserPublic: {
             _id: string;
             id?: string;
@@ -12939,6 +14051,7 @@ interface components {
                         username: string;
                     }[];
                     codeBlockLanguages?: string[];
+                    rawSpaceLinks?: string[];
                 };
                 renderedAst?: unknown;
                 rendererVersion?: string;
@@ -13043,6 +14156,7 @@ interface components {
                         username: string;
                     }[];
                     codeBlockLanguages?: string[];
+                    rawSpaceLinks?: string[];
                 };
                 renderedAst?: unknown;
                 rendererVersion?: string;
@@ -13144,6 +14258,7 @@ interface components {
                     username: string;
                 }[];
                 codeBlockLanguages?: string[];
+                rawSpaceLinks?: string[];
             };
             renderedAst?: unknown;
             rendererVersion?: string;
@@ -13189,6 +14304,7 @@ interface components {
                 username: string;
             }[];
             codeBlockLanguages?: string[];
+            rawSpaceLinks?: string[];
         };
         TocEntry: {
             level: number;
@@ -13227,6 +14343,7 @@ interface components {
              * @enum {string}
              */
             order: "asc" | "desc";
+            revision_id?: string;
         };
         ListPagesResponse: {
             pages: {
@@ -13264,6 +14381,7 @@ interface components {
                             username: string;
                         }[];
                         codeBlockLanguages?: string[];
+                        rawSpaceLinks?: string[];
                     };
                     renderedAst?: unknown;
                     rendererVersion?: string;
@@ -13373,6 +14491,112 @@ interface components {
                             username: string;
                         }[];
                         codeBlockLanguages?: string[];
+                        rawSpaceLinks?: string[];
+                    };
+                    renderedAst?: unknown;
+                    rendererVersion?: string;
+                    parentRevisionId?: string | null;
+                    /** @enum {string} */
+                    type?: "snapshot" | "incremental";
+                    savedBy?: string | {
+                        _id: string;
+                        id?: string;
+                        username: string;
+                        name: string;
+                        /** Format: email */
+                        email: string;
+                        image?: string | null;
+                        createdAt: string;
+                    } | null;
+                    contributors?: (string | {
+                        _id: string;
+                        id?: string;
+                        username: string;
+                        name: string;
+                        /** Format: email */
+                        email: string;
+                        image?: string | null;
+                        createdAt: string;
+                    })[];
+                    message?: string;
+                    /** @enum {string} */
+                    editVia?: "web" | "oauth" | "pat";
+                };
+                redirectTo?: string | null;
+                /** @enum {string|null} */
+                status?: "wip" | "published" | "deleted" | "deprecated" | "draft" | null;
+                grant?: number;
+                grantedUsers?: string[];
+                creator?: string | {
+                    _id: string;
+                    id?: string;
+                    username: string;
+                    name: string;
+                    /** Format: email */
+                    email: string;
+                    image?: string | null;
+                    createdAt: string;
+                } | null;
+                lastUpdateUser?: string | {
+                    _id: string;
+                    id?: string;
+                    username: string;
+                    name: string;
+                    /** Format: email */
+                    email: string;
+                    image?: string | null;
+                    createdAt: string;
+                } | null;
+                liker?: string[];
+                /** @default 0 */
+                commentCount: number;
+                extended?: {
+                    [key: string]: unknown;
+                };
+                createdAt: string;
+                updatedAt?: string;
+                currentRevision?: string | null;
+                yjsCheckpointAt?: string | null;
+                latestRevision?: string;
+                likerCount?: number;
+                seenUsersCount?: number;
+            } | null;
+            contentPage?: {
+                _id: string;
+                path: string;
+                revision?: string | {
+                    _id: string;
+                    path: string;
+                    body: string;
+                    /** @default markdown */
+                    format: string;
+                    author?: {
+                        _id: string;
+                        id?: string;
+                        username: string;
+                        name: string;
+                        /** Format: email */
+                        email: string;
+                        image?: string | null;
+                        createdAt: string;
+                    } | null;
+                    createdAt: string;
+                    meta?: {
+                        toc?: {
+                            level: number;
+                            text: string;
+                            anchorId: string;
+                        }[];
+                        wikiLinks?: {
+                            raw: string;
+                            target: string;
+                            displayText?: string;
+                        }[];
+                        mentions?: {
+                            username: string;
+                        }[];
+                        codeBlockLanguages?: string[];
+                        rawSpaceLinks?: string[];
                     };
                     renderedAst?: unknown;
                     rendererVersion?: string;
@@ -13479,6 +14703,7 @@ interface components {
                             username: string;
                         }[];
                         codeBlockLanguages?: string[];
+                        rawSpaceLinks?: string[];
                     };
                     renderedAst?: unknown;
                     rendererVersion?: string;
@@ -13635,6 +14860,7 @@ interface components {
                             username: string;
                         }[];
                         codeBlockLanguages?: string[];
+                        rawSpaceLinks?: string[];
                     };
                     renderedAst?: unknown;
                     rendererVersion?: string;
@@ -13729,6 +14955,7 @@ interface components {
             fileSize: number;
             createdAt: string;
             url: string;
+            originalUrl: string;
             inUse: boolean;
         };
         AttachmentMeta: {
@@ -13755,6 +14982,7 @@ interface components {
             fileSize: number;
             createdAt: string;
             url: string;
+            originalUrl: string;
         };
         ListAttachmentsResponse: {
             attachments: {
@@ -13781,6 +15009,7 @@ interface components {
                 fileSize: number;
                 createdAt: string;
                 url: string;
+                originalUrl: string;
                 inUse: boolean;
             }[];
         };
@@ -13809,6 +15038,7 @@ interface components {
                 fileSize: number;
                 createdAt: string;
                 url: string;
+                originalUrl: string;
                 inUse: boolean;
             };
             referencingRevisions: {
@@ -13856,6 +15086,7 @@ interface components {
                 fileSize: number;
                 createdAt: string;
                 url: string;
+                originalUrl: string;
                 inUse: boolean;
             }[];
             past: {
@@ -13883,6 +15114,7 @@ interface components {
                     fileSize: number;
                     createdAt: string;
                     url: string;
+                    originalUrl: string;
                     inUse: boolean;
                 };
                 referencingRevisions: {
@@ -14224,30 +15456,44 @@ interface components {
             name: string;
             version: string;
             requires?: string[];
+            modelAccess?: string[];
             hasConfig: boolean;
             registers: string[];
             adminPlacement: {
                 /** @enum {string} */
-                section: "settings" | "shared" | "storage" | "mail" | "notification" | "auth" | "search" | "renderer";
+                section: "settings" | "shared" | "storage" | "mail" | "notification" | "auth" | "search" | "renderer" | "platform";
                 label: string;
                 icon?: string;
             };
             supportsHotReload: boolean;
+            /**
+             * @default active
+             * @enum {string}
+             */
+            status: "active" | "failed";
+            error?: string;
         };
         ListPluginsResponse: {
             plugins: {
                 name: string;
                 version: string;
                 requires?: string[];
+                modelAccess?: string[];
                 hasConfig: boolean;
                 registers: string[];
                 adminPlacement: {
                     /** @enum {string} */
-                    section: "settings" | "shared" | "storage" | "mail" | "notification" | "auth" | "search" | "renderer";
+                    section: "settings" | "shared" | "storage" | "mail" | "notification" | "auth" | "search" | "renderer" | "platform";
                     label: string;
                     icon?: string;
                 };
                 supportsHotReload: boolean;
+                /**
+                 * @default active
+                 * @enum {string}
+                 */
+                status: "active" | "failed";
+                error?: string;
             }[];
         };
         PluginConfigResponse: {
@@ -14300,6 +15546,8 @@ interface components {
                 }[];
             };
         };
+        /** @enum {string} */
+        Capability: "oauth" | "oauth:auth-code" | "oauth:device" | "oauth:pkce" | "pat" | "pages" | "comments" | "bookmarks" | "attachments" | "notifications" | "search" | "collab" | "collab:redis" | "link-card";
     };
     responses: never;
     parameters: never;