@visus-io/notion-sdk-ts 3.1.0 → 3.2.0

package/dist/schemas/comment.schema.js

@@ -53,12 +53,18 @@ const commentAttachmentFileSchema = z.object({
     url: z.url(),
     expiry_time: shared_schema_1.notionDateStringSchema,
 });
-/** Comment attachment schema. */
+/** Comment attachment schema.
+ *
+ * @category Comments
+ */
 exports.commentAttachmentSchema = z.object({
     category: z.enum(['image', 'video', 'file', 'audio', 'pdf']),
     file: commentAttachmentFileSchema,
 });
-/** Comment display name schema (user or custom). */
+/** Comment display name schema (user or custom).
+ *
+ * @category Comments
+ */
 exports.commentDisplayNameSchema = z.union([
     z.object({
         type: z.literal('user'),
@@ -69,6 +75,9 @@ exports.commentDisplayNameSchema = z.union([
         resolved_name: z.string().trim(),
     }),
 ]);
+/**
+ * @category Comments
+ */
 exports.commentSchema = z.object({
     object: z.literal('comment'),
     id: z.uuid(),

package/dist/schemas/customEmoji.schema.d.ts

@@ -4,10 +4,15 @@ import * as z from 'zod';
  *
  * Notion API reference:
  * https://developers.notion.com/reference/list-custom-emojis
+ *
+ * @category Custom Emoji & Icons
  */
 export declare const customEmojiSchema: z.ZodObject<{
     id: z.ZodUUID;
     name: z.ZodString;
     url: z.ZodURL;
 }, z.core.$strip>;
+/**
+ * @category Custom Emoji & Icons
+ */
 export type NotionCustomEmoji = z.infer<typeof customEmojiSchema>;

package/dist/schemas/customEmoji.schema.js

@@ -40,6 +40,8 @@ const z = __importStar(require("zod"));
  *
  * Notion API reference:
  * https://developers.notion.com/reference/list-custom-emojis
+ *
+ * @category Custom Emoji & Icons
  */
 exports.customEmojiSchema = z.object({
     id: z.uuid(),

package/dist/schemas/dataSource.schema.d.ts

@@ -7,6 +7,8 @@ import * as z from 'zod';
  *
  * Notion API reference:
  * https://developers.notion.com/reference/data-source
+ *
+ * @category Databases & Data Sources
  */
 export declare const dataSourceSchema: z.ZodObject<{
     object: z.ZodLiteral<"data_source">;
@@ -820,22 +822,38 @@ export declare const dataSourceSchema: z.ZodObject<{
     public_url: z.ZodUnion<readonly [z.ZodURL, z.ZodNull]>;
     is_inline: z.ZodBoolean;
     in_trash: z.ZodBoolean;
+    database_type: z.ZodOptional<z.ZodEnum<{
+        tasks: "tasks";
+        projects: "projects";
+        skills: "skills";
+    }>>;
 }, z.core.$strip>;
+/**
+ * @category Databases & Data Sources
+ */
 export type NotionDataSource = z.infer<typeof dataSourceSchema>;
 /**
- * A single data source template reference, as returned by the
- * List data source templates endpoint.
+ * A single data source template reference. The List data source templates endpoint
+ * returns an array of these.
  *
  * Notion API reference:
  * https://developers.notion.com/reference/list-data-source-templates
+ *
+ * @category Databases & Data Sources
  */
 export declare const dataSourceTemplateSchema: z.ZodObject<{
     id: z.ZodUUID;
     name: z.ZodString;
     is_default: z.ZodBoolean;
 }, z.core.$strip>;
+/**
+ * @category Databases & Data Sources
+ */
 export type DataSourceTemplate = z.infer<typeof dataSourceTemplateSchema>;
-/** Response shape of the List data source templates endpoint. */
+/** Response shape of the List data source templates endpoint.
+ *
+ * @category Databases & Data Sources
+ */
 export declare const dataSourceTemplateListSchema: z.ZodObject<{
     templates: z.ZodArray<z.ZodObject<{
         id: z.ZodUUID;
@@ -845,4 +863,7 @@ export declare const dataSourceTemplateListSchema: z.ZodObject<{
     has_more: z.ZodBoolean;
     next_cursor: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * @category Databases & Data Sources
+ */
 export type DataSourceTemplateList = z.infer<typeof dataSourceTemplateListSchema>;

package/dist/schemas/dataSource.schema.js

@@ -42,6 +42,7 @@ const richText_schema_1 = require("./richText.schema");
 const shared_schema_1 = require("./shared.schema");
 const user_schema_1 = require("./user.schema");
 const propertyObjects_schema_1 = require("./propertyObjects.schema");
+const database_schema_1 = require("./database.schema");
 /**
  * Notion data source object schema.
  *
@@ -50,6 +51,8 @@ const propertyObjects_schema_1 = require("./propertyObjects.schema");
  *
  * Notion API reference:
  * https://developers.notion.com/reference/data-source
+ *
+ * @category Databases & Data Sources
  */
 exports.dataSourceSchema = z.object({
     /** Always "data_source" */
@@ -62,11 +65,11 @@ exports.dataSourceSchema = z.object({
     parent: parent_schema_1.parentSchema,
     /** Information about the database's parent (the data source's grandparent) */
     database_parent: parent_schema_1.parentSchema,
-    /** Date and time when this data source was created (ISO 8601) */
+    /** Creation date and time for this data source, in ISO 8601 format */
     created_time: shared_schema_1.notionDateStringSchema,
     /** User who created the data source */
     created_by: user_schema_1.userSchema,
-    /** Date and time when this data source was updated (ISO 8601) */
+    /** Last edited date and time for this data source, in ISO 8601 format */
     last_edited_time: shared_schema_1.notionDateStringSchema,
     /** User who last edited the data source */
     last_edited_by: user_schema_1.userSchema,
@@ -86,20 +89,27 @@ exports.dataSourceSchema = z.object({
     is_inline: z.boolean(),
     /** Whether the data source is in the trash */
     in_trash: z.boolean(),
+    /** Canonical database type this data source's parent database was built from, if any */
+    database_type: z.enum(database_schema_1.DATABASE_TYPES).optional(),
 });
 /**
- * A single data source template reference, as returned by the
- * List data source templates endpoint.
+ * A single data source template reference. The List data source templates endpoint
+ * returns an array of these.
  *
  * Notion API reference:
  * https://developers.notion.com/reference/list-data-source-templates
+ *
+ * @category Databases & Data Sources
  */
 exports.dataSourceTemplateSchema = z.object({
     id: z.uuid(),
     name: z.string().trim(),
     is_default: z.boolean(),
 });
-/** Response shape of the List data source templates endpoint. */
+/** Response shape of the List data source templates endpoint.
+ *
+ * @category Databases & Data Sources
+ */
 exports.dataSourceTemplateListSchema = z.object({
     templates: z.array(exports.dataSourceTemplateSchema),
     has_more: z.boolean(),

package/dist/schemas/database.schema.d.ts

@@ -8,12 +8,34 @@ import * as z from 'zod';
  * Notion API reference:
  * https://developers.notion.com/reference/database
  */
-/** Data source reference with id and name. */
+/** Data source reference with id and name.
+ *
+ * @category Databases & Data Sources
+ */
 export declare const dataSourceRefSchema: z.ZodObject<{
     id: z.ZodUUID;
     name: z.ZodString;
 }, z.core.$strip>;
+/**
+ * @category Databases & Data Sources
+ */
 export type DataSourceRef = z.infer<typeof dataSourceRefSchema>;
+/**
+ * A canonical database type.
+ *
+ * Pass one of these values as `database_type` when you create a database. Notion builds the
+ * database from its schema for that type, not a custom schema.
+ *
+ * @category Databases & Data Sources
+ */
+export declare const DATABASE_TYPES: readonly ["tasks", "projects", "skills"];
+/**
+ * @category Databases & Data Sources
+ */
+export type DatabaseType = (typeof DATABASE_TYPES)[number];
+/**
+ * @category Databases & Data Sources
+ */
 export declare const databaseSchema: z.ZodObject<{
     object: z.ZodLiteral<"database">;
     id: z.ZodUUID;
@@ -527,5 +549,13 @@ export declare const databaseSchema: z.ZodObject<{
     is_inline: z.ZodBoolean;
     is_locked: z.ZodOptional<z.ZodBoolean>;
     public_url: z.ZodNullable<z.ZodURL>;
+    database_type: z.ZodOptional<z.ZodEnum<{
+        tasks: "tasks";
+        projects: "projects";
+        skills: "skills";
+    }>>;
 }, z.core.$strip>;
+/**
+ * @category Databases & Data Sources
+ */
 export type NotionDatabase = z.infer<typeof databaseSchema>;

package/dist/schemas/database.schema.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.databaseSchema = exports.dataSourceRefSchema = void 0;
+exports.databaseSchema = exports.DATABASE_TYPES = exports.dataSourceRefSchema = void 0;
 const z = __importStar(require("zod"));
 const file_schema_1 = require("./file.schema");
 const icon_schema_1 = require("./icon.schema");
@@ -50,11 +50,26 @@ const user_schema_1 = require("./user.schema");
  * Notion API reference:
  * https://developers.notion.com/reference/database
  */
-/** Data source reference with id and name. */
+/** Data source reference with id and name.
+ *
+ * @category Databases & Data Sources
+ */
 exports.dataSourceRefSchema = z.object({
     id: z.uuid(),
     name: z.string().trim(),
 });
+/**
+ * A canonical database type.
+ *
+ * Pass one of these values as `database_type` when you create a database. Notion builds the
+ * database from its schema for that type, not a custom schema.
+ *
+ * @category Databases & Data Sources
+ */
+exports.DATABASE_TYPES = ['tasks', 'projects', 'skills'];
+/**
+ * @category Databases & Data Sources
+ */
 exports.databaseSchema = z.object({
     object: z.literal('database'),
     id: z.uuid(),
@@ -73,4 +88,5 @@ exports.databaseSchema = z.object({
     is_inline: z.boolean(),
     is_locked: z.boolean().optional(),
     public_url: z.nullable(z.url()),
+    database_type: z.enum(exports.DATABASE_TYPES).optional(),
 });

package/dist/schemas/emoji.schema.d.ts

@@ -2,14 +2,19 @@ import * as z from 'zod';
 /**
  * Notion emoji object schema.
  *
- * Emojis can be used as icons for pages, databases, and other objects.
- * Contains the emoji character as a string.
+ * You can use emojis as icons for pages, databases, and other objects.
+ * This schema stores the emoji character as a string.
  *
  * Notion API reference:
  * https://developers.notion.com/reference/emoji-object
+ *
+ * @category Custom Emoji & Icons
  */
 export declare const emojiSchema: z.ZodObject<{
     type: z.ZodLiteral<"emoji">;
     emoji: z.ZodString;
 }, z.core.$strip>;
+/**
+ * @category Custom Emoji & Icons
+ */
 export type NotionEmoji = z.infer<typeof emojiSchema>;

package/dist/schemas/emoji.schema.js

@@ -38,11 +38,13 @@ const z = __importStar(require("zod"));
 /**
  * Notion emoji object schema.
  *
- * Emojis can be used as icons for pages, databases, and other objects.
- * Contains the emoji character as a string.
+ * You can use emojis as icons for pages, databases, and other objects.
+ * This schema stores the emoji character as a string.
  *
  * Notion API reference:
  * https://developers.notion.com/reference/emoji-object
+ *
+ * @category Custom Emoji & Icons
  */
 exports.emojiSchema = z.object({
     type: z.literal('emoji'),

package/dist/schemas/file.schema.d.ts

@@ -2,8 +2,9 @@ import * as z from 'zod';
 /**
  * Notion file object schemas.
  *
- * Files can be Notion-hosted (uploaded through the UI), API-uploaded (via file upload API),
- * or externally hosted (with a URL). Used for page/block icons, covers, and file attachments.
+ * Files can be Notion-hosted (uploaded through the UI), API-uploaded (via the file upload
+ * API), or externally hosted (with a URL). This schema applies to page and block icons,
+ * covers, and file attachments.
  *
  * Notion API reference:
  * https://developers.notion.com/reference/file-object
@@ -30,6 +31,9 @@ declare const externalFileSchema: z.ZodObject<{
         url: z.ZodURL;
     }, z.core.$strip>;
 }, z.core.$strip>;
+/**
+ * @category File Uploads
+ */
 export declare const fileSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"file">;
     file: z.ZodObject<{
@@ -47,8 +51,20 @@ export declare const fileSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         url: z.ZodURL;
     }, z.core.$strip>;
 }, z.core.$strip>], "type">;
+/**
+ * @category File Uploads
+ */
 export type NotionFile = z.infer<typeof fileSchema>;
+/**
+ * @category File Uploads
+ */
 export type NotionHostedFile = z.infer<typeof notionFileSchema>;
+/**
+ * @category File Uploads
+ */
 export type UploadedFile = z.infer<typeof fileUploadSchema>;
+/**
+ * @category File Uploads
+ */
 export type ExternalFile = z.infer<typeof externalFileSchema>;
 export {};

package/dist/schemas/file.schema.js

@@ -39,8 +39,9 @@ const shared_schema_1 = require("./shared.schema");
 /**
  * Notion file object schemas.
  *
- * Files can be Notion-hosted (uploaded through the UI), API-uploaded (via file upload API),
- * or externally hosted (with a URL). Used for page/block icons, covers, and file attachments.
+ * Files can be Notion-hosted (uploaded through the UI), API-uploaded (via the file upload
+ * API), or externally hosted (with a URL). This schema applies to page and block icons,
+ * covers, and file attachments.
  *
  * Notion API reference:
  * https://developers.notion.com/reference/file-object
@@ -67,6 +68,9 @@ const externalFileSchema = z.object({
         url: z.url(),
     }),
 });
+/**
+ * @category File Uploads
+ */
 exports.fileSchema = z.discriminatedUnion('type', [
     notionFileSchema,
     fileUploadSchema,

package/dist/schemas/fileUpload.schema.d.ts

@@ -2,11 +2,14 @@ import * as z from 'zod';
 /**
  * Notion file upload object schema.
  *
- * File uploads represent files uploaded to Notion via the API. They have a temporary
- * upload URL and can be in various states (pending, uploaded, expired, failed).
+ * File uploads represent files uploaded to Notion through the API. Each file upload has
+ * a temporary upload URL. Each file upload has one of these states: pending, uploaded,
+ * expired, or failed.
  *
  * Notion API reference:
  * https://developers.notion.com/reference/file-upload-object
+ *
+ * @category File Uploads
  */
 export declare const fileUploadSchema: z.ZodObject<{
     object: z.ZodLiteral<"file_upload">;
@@ -26,4 +29,7 @@ export declare const fileUploadSchema: z.ZodObject<{
     complete_url: z.ZodString;
     file_import_result: z.ZodString;
 }, z.core.$strip>;
+/**
+ * @category File Uploads
+ */
 export type NotionFileUpload = z.infer<typeof fileUploadSchema>;

package/dist/schemas/fileUpload.schema.js

@@ -39,11 +39,14 @@ const shared_schema_1 = require("./shared.schema");
 /**
  * Notion file upload object schema.
  *
- * File uploads represent files uploaded to Notion via the API. They have a temporary
- * upload URL and can be in various states (pending, uploaded, expired, failed).
+ * File uploads represent files uploaded to Notion through the API. Each file upload has
+ * a temporary upload URL. Each file upload has one of these states: pending, uploaded,
+ * expired, or failed.
  *
  * Notion API reference:
  * https://developers.notion.com/reference/file-upload-object
+ *
+ * @category File Uploads
  */
 exports.fileUploadSchema = z.object({
     object: z.literal('file_upload'),

package/dist/schemas/icon.schema.d.ts

@@ -11,10 +11,19 @@ import * as z from 'zod';
  * Notion API reference:
  * https://developers.notion.com/reference/emoji-object
  */
-/** Colors available for native (icon-picker) icons. */
+/** Colors available for native (icon-picker) icons.
+ *
+ * @category Custom Emoji & Icons
+ */
 export declare const NATIVE_ICON_COLORS: readonly ["gray", "lightgray", "brown", "yellow", "orange", "green", "blue", "purple", "pink", "red"];
+/**
+ * @category Custom Emoji & Icons
+ */
 export type NativeIconColor = (typeof NATIVE_ICON_COLORS)[number];
-/** Native (icon-picker) icon. */
+/** Native (icon-picker) icon.
+ *
+ * @category Custom Emoji & Icons
+ */
 export declare const nativeIconSchema: z.ZodObject<{
     type: z.ZodLiteral<"icon">;
     icon: z.ZodObject<{
@@ -33,8 +42,14 @@ export declare const nativeIconSchema: z.ZodObject<{
         }>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
+/**
+ * @category Custom Emoji & Icons
+ */
 export type NativeIcon = z.infer<typeof nativeIconSchema>;
-/** Custom emoji icon. */
+/** Custom emoji icon.
+ *
+ * @category Custom Emoji & Icons
+ */
 export declare const customEmojiIconSchema: z.ZodObject<{
     type: z.ZodLiteral<"custom_emoji">;
     custom_emoji: z.ZodObject<{
@@ -43,8 +58,14 @@ export declare const customEmojiIconSchema: z.ZodObject<{
         url: z.ZodOptional<z.ZodURL>;
     }, z.core.$strip>;
 }, z.core.$strip>;
+/**
+ * @category Custom Emoji & Icons
+ */
 export type CustomEmojiIcon = z.infer<typeof customEmojiIconSchema>;
-/** Shared icon schema covering all icon object variants. */
+/** Shared icon schema covering all icon object variants.
+ *
+ * @category Custom Emoji & Icons
+ */
 export declare const iconSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"file">;
     file: z.ZodObject<{
@@ -89,4 +110,7 @@ export declare const iconSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z
         url: z.ZodOptional<z.ZodURL>;
     }, z.core.$strip>;
 }, z.core.$strip>]>;
+/**
+ * @category Custom Emoji & Icons
+ */
 export type NotionIcon = z.infer<typeof iconSchema>;

package/dist/schemas/icon.schema.js

@@ -49,7 +49,10 @@ const file_schema_1 = require("./file.schema");
  * Notion API reference:
  * https://developers.notion.com/reference/emoji-object
  */
-/** Colors available for native (icon-picker) icons. */
+/** Colors available for native (icon-picker) icons.
+ *
+ * @category Custom Emoji & Icons
+ */
 exports.NATIVE_ICON_COLORS = [
     'gray',
     'lightgray',
@@ -62,7 +65,10 @@ exports.NATIVE_ICON_COLORS = [
     'pink',
     'red',
 ];
-/** Native (icon-picker) icon. */
+/** Native (icon-picker) icon.
+ *
+ * @category Custom Emoji & Icons
+ */
 exports.nativeIconSchema = z.object({
     type: z.literal('icon'),
     icon: z.object({
@@ -70,7 +76,10 @@ exports.nativeIconSchema = z.object({
         color: z.enum(exports.NATIVE_ICON_COLORS).optional(),
     }),
 });
-/** Custom emoji icon. */
+/** Custom emoji icon.
+ *
+ * @category Custom Emoji & Icons
+ */
 exports.customEmojiIconSchema = z.object({
     type: z.literal('custom_emoji'),
     custom_emoji: z.object({
@@ -79,7 +88,10 @@ exports.customEmojiIconSchema = z.object({
         url: z.url().optional(),
     }),
 });
-/** Shared icon schema covering all icon object variants. */
+/** Shared icon schema covering all icon object variants.
+ *
+ * @category Custom Emoji & Icons
+ */
 exports.iconSchema = z.union([
     file_schema_1.fileSchema,
     emoji_schema_1.emojiSchema,

package/dist/schemas/meetingNotesQuery.schema.d.ts

@@ -4,12 +4,20 @@ import * as z from 'zod';
  *
  * Notion API reference:
  * https://developers.notion.com/reference/query-meeting-notes
+ *
+ * @category Pages
  */
 export declare const MEETING_NOTES_QUERY_PROPERTIES: readonly ["title", "attendees", "created_time", "created_by", "last_edited_time", "last_edited_by"];
+/**
+ * @category Pages
+ */
 export type MeetingNotesQueryProperty = (typeof MEETING_NOTES_QUERY_PROPERTIES)[number];
 /**
- * Response shape is genuinely non-standard: no `object` field, no `next_cursor` at
- * all -- pagination is controlled purely by `limit` (max 50 per request, no cursor).
+ * This response shape is non-standard. It has no `object` field and no `next_cursor`
+ * field. The `limit` parameter alone controls pagination, up to 50 results per request,
+ * with no cursor.
+ *
+ * @category Pages
  */
 export declare const meetingNotesQueryResponseSchema: z.ZodObject<{
     results: z.ZodArray<z.ZodObject<{
@@ -4184,4 +4192,7 @@ export declare const meetingNotesQueryResponseSchema: z.ZodObject<{
         }>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+/**
+ * @category Pages
+ */
 export type MeetingNotesQueryResponse = z.infer<typeof meetingNotesQueryResponseSchema>;

package/dist/schemas/meetingNotesQuery.schema.js

@@ -42,6 +42,8 @@ const pagination_schema_1 = require("./pagination.schema");
  *
  * Notion API reference:
  * https://developers.notion.com/reference/query-meeting-notes
+ *
+ * @category Pages
  */
 exports.MEETING_NOTES_QUERY_PROPERTIES = [
     'title',
@@ -52,8 +54,11 @@ exports.MEETING_NOTES_QUERY_PROPERTIES = [
     'last_edited_by',
 ];
 /**
- * Response shape is genuinely non-standard: no `object` field, no `next_cursor` at
- * all -- pagination is controlled purely by `limit` (max 50 per request, no cursor).
+ * This response shape is non-standard. It has no `object` field and no `next_cursor`
+ * field. The `limit` parameter alone controls pagination, up to 50 results per request,
+ * with no cursor.
+ *
+ * @category Pages
  */
 exports.meetingNotesQueryResponseSchema = z.object({
     results: z.array(block_schema_1.blockSchema),

package/dist/schemas/page.schema.d.ts

@@ -7,6 +7,8 @@ import * as z from 'zod';
  *
  * Notion API reference:
  * https://developers.notion.com/reference/page
+ *
+ * @category Pages
  */
 export declare const pageSchema: z.ZodObject<{
     object: z.ZodLiteral<"page">;
@@ -239,6 +241,9 @@ export declare const pageSchema: z.ZodObject<{
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"string">;
             string: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"unsupported">;
+            unsupported: z.ZodObject<{}, z.core.$strip>;
         }, z.core.$strip>], "type">;
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
@@ -900,4 +905,7 @@ export declare const pageSchema: z.ZodObject<{
     url: z.ZodURL;
     public_url: z.ZodNullable<z.ZodURL>;
 }, z.core.$strip>;
+/**
+ * @category Pages
+ */
 export type NotionPage = z.infer<typeof pageSchema>;

package/dist/schemas/page.schema.js

@@ -49,6 +49,8 @@ const user_schema_1 = require("./user.schema");
  *
  * Notion API reference:
  * https://developers.notion.com/reference/page
+ *
+ * @category Pages
  */
 exports.pageSchema = z.object({
     object: z.literal('page'),

package/dist/schemas/pageMarkdown.schema.d.ts

@@ -7,6 +7,8 @@ import * as z from 'zod';
  *
  * Notion API reference:
  * https://developers.notion.com/guides/data-apis/working-with-markdown-content
+ *
+ * @category Pages
  */
 export declare const pageMarkdownSchema: z.ZodObject<{
     object: z.ZodLiteral<"page_markdown">;
@@ -15,12 +17,18 @@ export declare const pageMarkdownSchema: z.ZodObject<{
     truncated: z.ZodBoolean;
     unknown_block_ids: z.ZodArray<z.ZodUUID>;
 }, z.core.$strip>;
+/**
+ * @category Pages
+ */
 export type PageMarkdown = z.infer<typeof pageMarkdownSchema>;
 /**
- * `PATCH /v1/pages/{page_id}/markdown` returns `pageMarkdownSchema` synchronously, or
- * (when `allow_async: true` triggers async processing) an `async_task` handle to poll
- * via {@link AsyncTasksAPI}. Both response bodies carry a literal `object` field, so
- * they discriminate cleanly without needing the HTTP status code.
+ * `PATCH /v1/pages/{page_id}/markdown` returns `pageMarkdownSchema` synchronously. If
+ * `allow_async: true` triggers async processing, it returns an `async_task` handle
+ * instead. Poll the handle through {@link AsyncTasksAPI}. Both response bodies carry a
+ * literal `object` field, so you can discriminate between them without checking the
+ * HTTP status code.
+ *
+ * @category Pages
  */
 export declare const markdownContentResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     object: z.ZodLiteral<"page_markdown">;
@@ -56,4 +64,7 @@ export declare const markdownContentResponseSchema: z.ZodDiscriminatedUnion<[z.Z
         message: z.ZodString;
     }, z.core.$strip>>;
 }, z.core.$strip>], "object">;
+/**
+ * @category Pages
+ */
 export type MarkdownContentResponse = z.infer<typeof markdownContentResponseSchema>;