What’s changed
New capabilities
- Silent page writes (#818)
- Page create, page update, and append block children accept
notifications.modeto write without notifying anyone.
- Page create, page update, and append block children accept
- Notion-flavored Markdown preview (#818)
- Page markdown and comment methods accept
markdown_version.v1is the default.v2is the Notion-flavored Markdown preview.
- Page markdown and comment methods accept
- More request options (#818)
filter_propertieson search,is_archivedon data source queries,show_data_source_titleon databases, andfile_uploadon embed blocks.- Status group filters (
group_equals,group_does_not_equal) are typed. They need thestatus-group-filters-2026-10-06beta header.
- Skill upload types (#818)
UploadSkillParametersandUploadSkillResponsecoverPOST /v1/ai/skills/:id/upload. There is no named method yet. The README shows how to call it withrequest()andformDataParams.PageWriteNotificationsSchema,PageMarkdownResponse, and the session filter types are now exported.
API response types
- Comments (#818, #820)
- New fields:
original_content_deleted,has_pending_attachments, and an optionalproperty_idfor comments on a page property. Thecomment.created,comment.updated, andcomment.deletedwebhook payloads also carryproperty_id, anddiscussion_id.
- New fields:
- Other new fields (#818)
show_data_source_titleon databases,limiton relation configs,is_full_pageandevent_idon meeting notes,warningson page markdown updates,email_verifiedon people, andis_favoritedon agents.- Some enums gain values, such as the
transcription_failedstatus and new agent connection types.
- Two response types narrowed to match the API
GetAsyncTaskResponsereportsrow_limit_exceededas a 406, not a 409.- The
browseragent connection type is gone. show_data_source_titleis required on database responses, so hand-built fixtures need it.
Fixes
extractNotionIdandextractDatabaseIdwith bare database links (#819, fixes #812)- For links with no title slug, such as
/workspace/<database id>?v=<view>&p=<page>, they returned the side-peek page ID fromp=. They now return the database ID from the path.
- For links with no title slug, such as
Links
- Full Changelog: v5.28.0...v5.29.0
- NPM Package: https://www.npmjs.com/package/@notionhq/client/v/5.29.0