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

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,8 +1232,10 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
-                                    renderedAst?: unknown;
+                                    renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                    renderedAstArtifactKey?: string;
                                     rendererVersion?: string;
                                     parentRevisionId?: string | null;
                                     /** @enum {string} */
@@ -2152,6 +2159,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;
@@ -2171,7 +2236,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description User profile with statistics + recent activity */
+                /** @description User profile with statistics (createdPagesCount, bookmarksCount, likesCount, commentsCount — the last two are the target user's OWN likes/comments, not activity their pages received) + recent activity */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -2194,6 +2259,8 @@ interface paths {
                             };
                             createdPagesCount: number;
                             bookmarksCount: number;
+                            likesCount: number;
+                            commentsCount: number;
                             recentPages?: {
                                 _id: string;
                                 path: string;
@@ -2229,8 +2296,10 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
-                                    renderedAst?: unknown;
+                                    renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                    renderedAstArtifactKey?: string;
                                     rendererVersion?: string;
                                     parentRevisionId?: string | null;
                                     /** @enum {string} */
@@ -2335,8 +2404,10 @@ interface paths {
                                                 username: string;
                                             }[];
                                             codeBlockLanguages?: string[];
+                                            rawSpaceLinks?: string[];
                                         };
-                                        renderedAst?: unknown;
+                                        renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                        renderedAstArtifactKey?: string;
                                         rendererVersion?: string;
                                         parentRevisionId?: string | null;
                                         /** @enum {string} */
@@ -2548,8 +2619,10 @@ interface paths {
                                                 username: string;
                                             }[];
                                             codeBlockLanguages?: string[];
+                                            rawSpaceLinks?: string[];
                                         };
-                                        renderedAst?: unknown;
+                                        renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                        renderedAstArtifactKey?: string;
                                         rendererVersion?: string;
                                         parentRevisionId?: string | null;
                                         /** @enum {string} */
@@ -2765,8 +2838,10 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
-                                    renderedAst?: unknown;
+                                    renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                    renderedAstArtifactKey?: string;
                                     rendererVersion?: string;
                                     parentRevisionId?: string | null;
                                     /** @enum {string} */
@@ -2902,39 +2977,140 @@ 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?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                    renderedAstArtifactKey?: string;
+                                    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 +3121,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 +3159,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 +3219,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,40 +3240,124 @@ 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;
-                                                anchorId: 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?: {
                                                 raw: string;
@@ -3051,8 +3368,10 @@ interface paths {
                                                 username: string;
                                             }[];
                                             codeBlockLanguages?: string[];
+                                            rawSpaceLinks?: string[];
                                         };
-                                        renderedAst?: unknown;
+                                        renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                        renderedAstArtifactKey?: string;
                                         rendererVersion?: string;
                                         parentRevisionId?: string | null;
                                         /** @enum {string} */
@@ -3250,8 +3569,10 @@ interface paths {
                                                 username: string;
                                             }[];
                                             codeBlockLanguages?: string[];
+                                            rawSpaceLinks?: string[];
                                         };
-                                        renderedAst?: unknown;
+                                        renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                        renderedAstArtifactKey?: string;
                                         rendererVersion?: string;
                                         parentRevisionId?: string | null;
                                         /** @enum {string} */
@@ -3535,8 +3856,10 @@ interface paths {
                                                 username: string;
                                             }[];
                                             codeBlockLanguages?: string[];
+                                            rawSpaceLinks?: string[];
                                         };
-                                        renderedAst?: unknown;
+                                        renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                        renderedAstArtifactKey?: string;
                                         rendererVersion?: string;
                                         parentRevisionId?: string | null;
                                         /** @enum {string} */
@@ -3762,6 +4085,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 +4192,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,8 +4600,10 @@ interface paths {
                                         username: string;
                                     }[];
                                     codeBlockLanguages?: string[];
+                                    rawSpaceLinks?: string[];
                                 };
-                                renderedAst?: unknown;
+                                renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                renderedAstArtifactKey?: string;
                                 rendererVersion?: string;
                                 parentRevisionId?: string | null;
                                 /** @enum {string} */
@@ -4355,7 +4712,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Full revision document */
+                /** @description Full revision document. `renderedAst` shape is content-negotiated via the `X-Crowi-Ast-Version` request header (RFC-0023): requests declaring `X-Crowi-Ast-Version: 1` receive the typed `{astVersion, root}` envelope; all other requests receive the stored bare mdast Root verbatim. The response varies on this header (`Vary: X-Crowi-Ast-Version`). */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -4394,8 +4751,10 @@ interface paths {
                                         username: string;
                                     }[];
                                     codeBlockLanguages?: string[];
+                                    rawSpaceLinks?: string[];
                                 };
-                                renderedAst?: unknown;
+                                renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                renderedAstArtifactKey?: string;
                                 rendererVersion?: string;
                                 parentRevisionId?: string | null;
                                 /** @enum {string} */
@@ -4506,7 +4865,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description The requested page with populated revision */
+                /** @description The requested page with populated revision. `revision.renderedAst` shape is content-negotiated via the `X-Crowi-Ast-Version` request header (RFC-0023): requests declaring `X-Crowi-Ast-Version: 1` receive the typed `{astVersion, root}` envelope; all other requests receive the stored bare mdast Root verbatim. The response varies on this header (`Vary: X-Crowi-Ast-Version`). */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -4548,8 +4907,10 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
-                                    renderedAst?: unknown;
+                                    renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                    renderedAstArtifactKey?: string;
                                     rendererVersion?: string;
                                     parentRevisionId?: string | null;
                                     /** @enum {string} */
@@ -4669,6 +5030,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,8 +5109,10 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
-                                    renderedAst?: unknown;
+                                    renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                    renderedAstArtifactKey?: string;
                                     rendererVersion?: string;
                                     parentRevisionId?: string | null;
                                     /** @enum {string} */
@@ -4928,8 +5307,10 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
-                                    renderedAst?: unknown;
+                                    renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                    renderedAstArtifactKey?: string;
                                     rendererVersion?: string;
                                     parentRevisionId?: string | null;
                                     /** @enum {string} */
@@ -5000,7 +5381,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,8 +5474,10 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
-                                    renderedAst?: unknown;
+                                    renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                    renderedAstArtifactKey?: string;
                                     rendererVersion?: string;
                                     parentRevisionId?: string | null;
                                     /** @enum {string} */
@@ -5252,6 +5635,7 @@ interface paths {
                     include_deleted?: boolean | null;
                     sort?: "updatedAt" | "createdAt" | "path";
                     order?: "asc" | "desc";
+                    revision_id?: string;
                 };
                 header?: never;
                 path?: never;
@@ -5259,7 +5643,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Page list (newest first) with optional portal page */
+                /** @description Page list (newest first) with optional portal page and an accurate `total` (the full, unpaginated count of the same viewer-visible set `pages` is a page of). The portal document is the only row carrying `revision.renderedAst`; its shape is content-negotiated via the `X-Crowi-Ast-Version` request header (RFC-0023, same semantics as GET /pages). The response varies on this header (`Vary: X-Crowi-Ast-Version`). */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5301,8 +5685,10 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
-                                    renderedAst?: unknown;
+                                    renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                    renderedAstArtifactKey?: string;
                                     rendererVersion?: string;
                                     parentRevisionId?: string | null;
                                     /** @enum {string} */
@@ -5410,8 +5796,10 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
-                                    renderedAst?: unknown;
+                                    renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                    renderedAstArtifactKey?: string;
                                     rendererVersion?: string;
                                     parentRevisionId?: string | null;
                                     /** @enum {string} */
@@ -5479,105 +5867,223 @@ 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?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                    renderedAstArtifactKey?: string;
+                                    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;
+                            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;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        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 */
@@ -5639,8 +6145,10 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
-                                    renderedAst?: unknown;
+                                    renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                    renderedAstArtifactKey?: string;
                                     rendererVersion?: string;
                                     parentRevisionId?: string | null;
                                     /** @enum {string} */
@@ -6043,8 +6551,10 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
-                                    renderedAst?: unknown;
+                                    renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                    renderedAstArtifactKey?: string;
                                     rendererVersion?: string;
                                     parentRevisionId?: string | null;
                                     /** @enum {string} */
@@ -6238,8 +6748,10 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
-                                    renderedAst?: unknown;
+                                    renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                    renderedAstArtifactKey?: string;
                                     rendererVersion?: string;
                                     parentRevisionId?: string | null;
                                     /** @enum {string} */
@@ -6366,60 +6878,375 @@ 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: {
-                                /** @enum {string} */
+                            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?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                    renderedAstArtifactKey?: string;
+                                    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} */
+                                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";
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        /** Set watch (notification subscription) status for a page */
+        put: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        page_id: string;
+                        watching: boolean;
+                    };
+                };
+            };
+            responses: {
+                /** @description Updated watching status */
+                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} */
                                 message: "Authentication is required";
@@ -6444,37 +7271,157 @@ interface paths {
                         };
                     };
                 };
-            };
-        };
-        /** Set watch (notification subscription) status for a page */
-        put: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": {
-                        page_id: string;
-                        watching: boolean;
-                    };
-                };
-            };
-            responses: {
-                /** @description Updated watching status */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            watching: boolean;
-                        };
-                    };
-                };
-                /** @description Invalid page_id */
+            };
+        };
+        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?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                    renderedAstArtifactKey?: string;
+                                    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 PAGE_REVERT_FAILED */
                 400: {
                     headers: {
                         [name: string]: unknown;
@@ -6482,8 +7429,7 @@ interface paths {
                     content: {
                         "application/json": {
                             error: {
-                                /** @enum {string} */
-                                code: "INVALID_PAGE_ID";
+                                code: string;
                                 message: string;
                             };
                         };
@@ -6524,14 +7470,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 +7485,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 +7497,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,8 +7544,10 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
-                                    renderedAst?: unknown;
+                                    renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                    renderedAstArtifactKey?: string;
                                     rendererVersion?: string;
                                     parentRevisionId?: string | null;
                                     /** @enum {string} */
@@ -6670,7 +7618,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,8 +7744,10 @@ interface paths {
                                             username: string;
                                         }[];
                                         codeBlockLanguages?: string[];
+                                        rawSpaceLinks?: string[];
                                     };
-                                    renderedAst?: unknown;
+                                    renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                    renderedAstArtifactKey?: string;
                                     rendererVersion?: string;
                                     parentRevisionId?: string | null;
                                     /** @enum {string} */
@@ -7063,14 +8013,15 @@ interface paths {
                 };
             };
             responses: {
-                /** @description Rendered mdast tree (serialised — same shape as a persisted revision.renderedAst) */
+                /** @description Rendered mdast tree (serialised — same shape as a persisted revision.renderedAst). Content-negotiated via the `X-Crowi-Ast-Version` request header (RFC-0023): requests declaring `X-Crowi-Ast-Version: 1` receive the typed `{astVersion, root}` envelope; all other requests receive the bare mdast Root. The response varies on this header (`Vary: X-Crowi-Ast-Version`). */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            renderedAst?: unknown;
+                            renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                            renderedAstArtifactKey?: string;
                         };
                     };
                 };
@@ -7091,6 +8042,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 +8872,7 @@ interface paths {
                                 fileSize: number;
                                 createdAt: string;
                                 url: string;
+                                originalUrl: string;
                                 inUse: boolean;
                             }[];
                             past: {
@@ -7934,6 +8900,7 @@ interface paths {
                                     fileSize: number;
                                     createdAt: string;
                                     url: string;
+                                    originalUrl: string;
                                     inUse: boolean;
                                 };
                                 referencingRevisions: {
@@ -8082,6 +9049,7 @@ interface paths {
                                 fileSize: number;
                                 createdAt: string;
                                 url: string;
+                                originalUrl: string;
                                 inUse: boolean;
                             }[];
                         };
@@ -8204,6 +9172,7 @@ interface paths {
                                 fileSize: number;
                                 createdAt: string;
                                 url: string;
+                                originalUrl: string;
                                 inUse: boolean;
                             };
                             url: string;
@@ -8272,6 +9241,21 @@ interface paths {
                         };
                     };
                 };
+                /** @description MIME type not in the unified upload allow-list (feature-attachment-upload-policy) */
+                415: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: {
+                                /** @enum {string} */
+                                code: "INVALID_PAGE_ID" | "PAGE_NOT_FOUND" | "FILE_MISSING" | "FILE_TOO_LARGE" | "DISALLOWED_MIME" | "INVALID_ATTACHMENT_ID" | "ATTACHMENT_NOT_FOUND" | "FORBIDDEN_FOR_DELETE" | "UPLOAD_FAILED" | "REMOVE_FAILED";
+                                message: string;
+                            };
+                        };
+                    };
+                };
                 /** @description Upload / storage failure */
                 500: {
                     headers: {
@@ -8346,7 +9330,7 @@ interface paths {
                     content: {
                         "application/json": {
                             /** @enum {string} */
-                            error: "too_large" | "disallowed_type" | "rate_limited" | "no_permission";
+                            error: "too_large" | "disallowed_type" | "DISALLOWED_MIME" | "rate_limited" | "no_permission";
                             message: string;
                             details?: {
                                 [key: string]: unknown;
@@ -8379,7 +9363,7 @@ interface paths {
                     content: {
                         "application/json": {
                             /** @enum {string} */
-                            error: "too_large" | "disallowed_type" | "rate_limited" | "no_permission";
+                            error: "too_large" | "disallowed_type" | "DISALLOWED_MIME" | "rate_limited" | "no_permission";
                             message: string;
                             details?: {
                                 [key: string]: unknown;
@@ -8395,7 +9379,7 @@ interface paths {
                     content: {
                         "application/json": {
                             /** @enum {string} */
-                            error: "too_large" | "disallowed_type" | "rate_limited" | "no_permission";
+                            error: "too_large" | "disallowed_type" | "DISALLOWED_MIME" | "rate_limited" | "no_permission";
                             message: string;
                             details?: {
                                 [key: string]: unknown;
@@ -8403,7 +9387,7 @@ interface paths {
                         };
                     };
                 };
-                /** @description MIME type not in the per-intent allow-list */
+                /** @description MIME type not in the unified upload allow-list (feature-attachment-upload-policy) */
                 415: {
                     headers: {
                         [name: string]: unknown;
@@ -8411,7 +9395,7 @@ interface paths {
                     content: {
                         "application/json": {
                             /** @enum {string} */
-                            error: "too_large" | "disallowed_type" | "rate_limited" | "no_permission";
+                            error: "too_large" | "disallowed_type" | "DISALLOWED_MIME" | "rate_limited" | "no_permission";
                             message: string;
                             details?: {
                                 [key: string]: unknown;
@@ -8427,7 +9411,7 @@ interface paths {
                     content: {
                         "application/json": {
                             /** @enum {string} */
-                            error: "too_large" | "disallowed_type" | "rate_limited" | "no_permission";
+                            error: "too_large" | "disallowed_type" | "DISALLOWED_MIME" | "rate_limited" | "no_permission";
                             message: string;
                             details?: {
                                 [key: string]: unknown;
@@ -8509,6 +9493,7 @@ interface paths {
                             fileSize: number;
                             createdAt: string;
                             url: string;
+                            originalUrl: string;
                         };
                     };
                 };
@@ -8780,8 +9765,10 @@ interface paths {
                                                 username: string;
                                             }[];
                                             codeBlockLanguages?: string[];
+                                            rawSpaceLinks?: string[];
                                         };
-                                        renderedAst?: unknown;
+                                        renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                                        renderedAstArtifactKey?: string;
                                         rendererVersion?: string;
                                         parentRevisionId?: string | null;
                                         /** @enum {string} */
@@ -9509,6 +10496,7 @@ interface paths {
                             /** @enum {string} */
                             registrationMode: "Open" | "Resricted" | "Closed";
                             registrationWhiteList: string[];
+                            linkCardEnabled: boolean;
                         };
                     };
                 };
@@ -9578,6 +10566,7 @@ interface paths {
                         /** @enum {string} */
                         registrationMode: "Open" | "Resricted" | "Closed";
                         registrationWhiteList: string[];
+                        linkCardEnabled: boolean;
                     };
                 };
             };
@@ -9592,6 +10581,7 @@ interface paths {
                             /** @enum {string} */
                             registrationMode: "Open" | "Resricted" | "Closed";
                             registrationWhiteList: string[];
+                            linkCardEnabled: boolean;
                         };
                     };
                 };
@@ -10481,20 +11471,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 +11703,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 +11736,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 +11756,7 @@ interface paths {
                 };
                 cookie?: never;
             };
-            requestBody?: {
-                content: {
-                    "application/json": {
-                        name: string;
-                        /** Format: email */
-                        email: string;
-                    };
-                };
-            };
+            requestBody?: never;
             responses: {
                 /** @description Updated user */
                 200: {
@@ -10643,7 +11782,7 @@ interface paths {
                         };
                     };
                 };
-                /** @description Validation error */
+                /** @description Invalid id */
                 400: {
                     headers: {
                         [name: string]: unknown;
@@ -10713,21 +11852,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 +11870,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 +11995,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 +12132,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 +12147,7 @@ interface paths {
             cookie?: never;
         };
         get?: never;
-        /** Activate a user (status -> ACTIVE) */
+        /** Suspend a user (status -> SUSPENDED) */
         put: {
             parameters: {
                 query?: never;
@@ -11149,7 +12278,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/admin/users/{id}/status/suspended": {
+    "/admin/users/{id}/reset-password": {
         parameters: {
             query?: never;
             header?: never;
@@ -11157,8 +12286,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 +12299,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Updated user */
+                /** @description Updated user + new plaintext password */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -11190,6 +12320,7 @@ interface paths {
                                 /** @enum {integer} */
                                 status?: 1 | 2 | 3 | 4 | 5;
                             };
+                            newPassword: string;
                         };
                     };
                 };
@@ -11281,14 +12412,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 +12427,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 +12439,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 +12460,6 @@ interface paths {
                                 /** @enum {integer} */
                                 status?: 1 | 2 | 3 | 4 | 5;
                             };
-                            newPassword: string;
                         };
                     };
                 };
@@ -11404,7 +12533,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 +12849,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 +13850,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 +14031,12 @@ interface components {
             /** @enum {string} */
             status: "approved" | "denied";
         };
+        ClientInfoResponse: {
+            clientId: string;
+            name: string;
+            firstParty: boolean;
+            trusted: boolean;
+        };
         UserPublic: {
             _id: string;
             id?: string;
@@ -12939,8 +14096,10 @@ interface components {
                         username: string;
                     }[];
                     codeBlockLanguages?: string[];
+                    rawSpaceLinks?: string[];
                 };
-                renderedAst?: unknown;
+                renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                renderedAstArtifactKey?: string;
                 rendererVersion?: string;
                 parentRevisionId?: string | null;
                 /** @enum {string} */
@@ -13008,6 +14167,16 @@ interface components {
             likerCount?: number;
             seenUsersCount?: number;
         };
+        RenderedAstEnvelope: {
+            /** @enum {number} */
+            astVersion: 1;
+            root?: unknown;
+        };
+        LegacyRenderedAstRoot: {
+            /** @enum {string} */
+            type: "root";
+            children: unknown[];
+        };
         PageWithRevision: {
             _id: string;
             path: string;
@@ -13043,8 +14212,10 @@ interface components {
                         username: string;
                     }[];
                     codeBlockLanguages?: string[];
+                    rawSpaceLinks?: string[];
                 };
-                renderedAst?: unknown;
+                renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                renderedAstArtifactKey?: string;
                 rendererVersion?: string;
                 parentRevisionId?: string | null;
                 /** @enum {string} */
@@ -13144,8 +14315,10 @@ interface components {
                     username: string;
                 }[];
                 codeBlockLanguages?: string[];
+                rawSpaceLinks?: string[];
             };
-            renderedAst?: unknown;
+            renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+            renderedAstArtifactKey?: string;
             rendererVersion?: string;
             parentRevisionId?: string | null;
             /** @enum {string} */
@@ -13189,6 +14362,7 @@ interface components {
                 username: string;
             }[];
             codeBlockLanguages?: string[];
+            rawSpaceLinks?: string[];
         };
         TocEntry: {
             level: number;
@@ -13227,6 +14401,7 @@ interface components {
              * @enum {string}
              */
             order: "asc" | "desc";
+            revision_id?: string;
         };
         ListPagesResponse: {
             pages: {
@@ -13264,8 +14439,10 @@ interface components {
                             username: string;
                         }[];
                         codeBlockLanguages?: string[];
+                        rawSpaceLinks?: string[];
                     };
-                    renderedAst?: unknown;
+                    renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                    renderedAstArtifactKey?: string;
                     rendererVersion?: string;
                     parentRevisionId?: string | null;
                     /** @enum {string} */
@@ -13373,8 +14550,116 @@ interface components {
                             username: string;
                         }[];
                         codeBlockLanguages?: string[];
+                        rawSpaceLinks?: string[];
+                    };
+                    renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                    renderedAstArtifactKey?: string;
+                    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;
+                    renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                    renderedAstArtifactKey?: string;
                     rendererVersion?: string;
                     parentRevisionId?: string | null;
                     /** @enum {string} */
@@ -13442,6 +14727,7 @@ interface components {
                 likerCount?: number;
                 seenUsersCount?: number;
             } | null;
+            total: number;
         };
         GetPageResponse: {
             page: {
@@ -13479,8 +14765,10 @@ interface components {
                             username: string;
                         }[];
                         codeBlockLanguages?: string[];
+                        rawSpaceLinks?: string[];
                     };
-                    renderedAst?: unknown;
+                    renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                    renderedAstArtifactKey?: string;
                     rendererVersion?: string;
                     parentRevisionId?: string | null;
                     /** @enum {string} */
@@ -13635,8 +14923,10 @@ interface components {
                             username: string;
                         }[];
                         codeBlockLanguages?: string[];
+                        rawSpaceLinks?: string[];
                     };
-                    renderedAst?: unknown;
+                    renderedAst?: components["schemas"]["RenderedAstEnvelope"] | components["schemas"]["LegacyRenderedAstRoot"];
+                    renderedAstArtifactKey?: string;
                     rendererVersion?: string;
                     parentRevisionId?: string | null;
                     /** @enum {string} */
@@ -13729,6 +15019,7 @@ interface components {
             fileSize: number;
             createdAt: string;
             url: string;
+            originalUrl: string;
             inUse: boolean;
         };
         AttachmentMeta: {
@@ -13755,6 +15046,7 @@ interface components {
             fileSize: number;
             createdAt: string;
             url: string;
+            originalUrl: string;
         };
         ListAttachmentsResponse: {
             attachments: {
@@ -13781,6 +15073,7 @@ interface components {
                 fileSize: number;
                 createdAt: string;
                 url: string;
+                originalUrl: string;
                 inUse: boolean;
             }[];
         };
@@ -13809,6 +15102,7 @@ interface components {
                 fileSize: number;
                 createdAt: string;
                 url: string;
+                originalUrl: string;
                 inUse: boolean;
             };
             referencingRevisions: {
@@ -13856,6 +15150,7 @@ interface components {
                 fileSize: number;
                 createdAt: string;
                 url: string;
+                originalUrl: string;
                 inUse: boolean;
             }[];
             past: {
@@ -13883,6 +15178,7 @@ interface components {
                     fileSize: number;
                     createdAt: string;
                     url: string;
+                    originalUrl: string;
                     inUse: boolean;
                 };
                 referencingRevisions: {
@@ -13920,7 +15216,7 @@ interface components {
         };
         UploadAttachmentError: {
             /** @enum {string} */
-            error: "too_large" | "disallowed_type" | "rate_limited" | "no_permission";
+            error: "too_large" | "disallowed_type" | "DISALLOWED_MIME" | "rate_limited" | "no_permission";
             message: string;
             details?: {
                 [key: string]: unknown;
@@ -14224,30 +15520,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 +15610,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;