fix(deps): update dependency @notionhq/client to v5

[renovate]

This PR contains the following updates:

Package	Change	Age	Confidence
@notionhq/client (source)	^2.2.15 → ^5.0.0

---

Release Notes

makenotion/notion-sdk-js (@​notionhq/client)

v5.16.0

Compare Source

What's Changed

• Add icon support to paragraph blocks (tab block items) by @​notion-buildkite-app[bot] in #​697
• Add gateway_timeout to APIErrorCode enum by @​notion-buildkite-app[bot] in #​698
• Update SDK types: H4 blocks; view API property encoding; "me" person filters by @​notion-buildkite-app[bot] in #​701
• Bump version to v5.16.0 by @​github-actions[bot] in #​702

Links

• Full Changelog: makenotion/notion-sdk-js@v5.15.0...v5.16.0
• NPM Package: https://www.npmjs.com/package/@​notionhq/client/v/5.16.0

v5.15.0

Compare Source

What's Changed

• Sync api-endpoints: tab block support, verification property updates by @​ksinder in #​690
• Modularize api-endpoints.ts into individual files + add webhook types by @​ksinder in #​691
• Move view/dashboard types from common.ts to views.ts by @​ksinder in #​692
• Add custom_emojis.list() endpoint by @​ksinder in #​693
• Bump version to v5.15.0 by @​github-actions[bot] in #​694

Links

• Full Changelog: makenotion/notion-sdk-js@v5.14.0...v5.15.0
• NPM Package: https://www.npmjs.com/package/@​notionhq/client/v/5.15.0

v5.14.0

Compare Source

What's Changed

• Sync api-endpoints: add status property support by @​ksinder in #​686
  • See the "Working with views" guide and changelog on our developer website for more information
• Add Views API endpoints by @​ksinder in #​684
• Bump version to v5.14.0 by @​github-actions[bot] in #​688

Links

• Full Changelog: makenotion/notion-sdk-js@v5.13.0...v5.14.0
• NPM Package: https://www.npmjs.com/package/@​notionhq/client/v/5.14.0

v5.13.0

Compare Source

What's Changed

• [AI] Add support for update_content and replace_content operations to PATCH /v1/pages/:id/markdown endpoint by @​notion-circleci-github-app[bot] in #​683
• Security-related upgrades and improvements to repo GitHub actions by @​elb-notion in #​652
• Proposal: Add ability to quickly run starter project on Val Town by @​charmaine in #​541
• Bump version to v5.13.0 by @​github-actions[bot] in #​685

New Contributors

• @​charmaine made their first contribution in #​541

Links

• Full Changelog: makenotion/notion-sdk-js@v5.12.0...v5.13.0
• NPM Package: https://www.npmjs.com/package/@​notionhq/client/v/5.13.0

v5.12.0

Compare Source

What's Changed

• [AI] Add optional timezone parameter to template body parameter for pages.create and pages.update by @​notion-circleci-github-app[bot] in #​676
• Add support for API version 2026-03-11 by @​ksinder in #​675
• fix: "Illegal invocation" error in Cloudflare Workers by @​craigary in #​681

New Contributors

• @​craigary made their first contribution in #​681

Links

• Full Changelog: makenotion/notion-sdk-js@v5.11.1...v5.12.0
• NPM Package: https://www.npmjs.com/package/@​notionhq/client/v/5.12.0

v5.11.1

Compare Source

What's Changed

• Sync api-endpoints: unsupported block type, update page docstring tweak by @​ksinder in #​672
  • New string field unsupported[block_type] in UnsupportedBlockObjectResponse to provide a hint on what an underlying unsupported block type is
  • Minor TSDoc change for updatePage endpoint: remove "properties" suffix from API name; just "Update page" now.
    • This reflects the fact that the endpoint does more than just updating properties/schema

Links

• Full Changelog: makenotion/notion-sdk-js@v5.11.0...v5.11.1
• NPM Package: https://www.npmjs.com/package/@​notionhq/client/v/5.11.1

v5.11.0

Compare Source

What's Changed

• Add pages.retrieveMarkdown and pages.updateMarkdown endpoints by @​ksinder in #​669
• Add warnings for unknown parameters passed to API methods by @​dimasriat in #​667

New Contributors

• @​dimasriat made their first contribution in #​667

Links

• Full Changelog: makenotion/notion-sdk-js@v5.10.0...v5.11.0
• NPM Package: https://www.npmjs.com/package/@​notionhq/client/v/5.11.0

v5.10.0

Compare Source

What's Changed

• Upgrade dev dependencies by @​ksinder in #​665
• Add automatic retry support with exponential backoff by @​ksinder in #​664
• Update transcription block response shape by @​haustle in #​668

New Contributors

• @​haustle made their first contribution in #​668

Links

• Full Changelog: makenotion/notion-sdk-js@v5.9.0...v5.10.0
• NPM Package: https://www.npmjs.com/package/@​notionhq/client/v/5.10.0

v5.9.0

Compare Source

What's Changed

• Fix: Prevent path traversal in Client.request() #​661
  • Note when upgrading: This means that callers can no longer use ../ to switch the meaning of a request that accepts an ID path parameter to navigate to a different Notion API endpoint. Please use Client.request() with a properly formatted, absolute API path instead.

Links

• Full Changelog: makenotion/notion-sdk-js@v5.8.0...v5.9.0
• NPM Package: https://www.npmjs.com/package/@​notionhq/client/v/5.9.0

v5.8.0

Compare Source

What's Changed

• Sync api-endpoints: add position to AppendBlockChildrenParameters by @​ksinder in #​658
  • Specifically, this change is a backwards-compatible improvement to support a more expressive position parameter in the PATCH /v1/blocks/:block_id/children body to append at a specific position in the parent's children array.
    • The parameter cannot be used with the older after parameter, which will be officially removed in the next public API version.
• Sync api-endpoints: add list_start_index and list_format by @​vshen-notion in #​659
  • For numbered_list_item, support distinguishing where list numbering starts and what type of list (number, letter, roman numeral), by exposing list_start_index and list_format

New Contributors

• @​vshen-notion made their first contribution in #​659

Full Changelog: makenotion/notion-sdk-js@v5.7.0...v5.8.0

v5.7.0

Compare Source

What's Changed

• Add 'Contributing' section to README. by @​toolness in #​655
• Sync api-endpoints: add position to CreatePageBodyParameters by @​ksinder in #​656
  • Backwards-compatible improvement: support the new, optional position parameter in the POST /v1/pages body, which attaches the newly created page at a specific location in a parent page.
  • The parameter cannot be used if the parent is not a regular page.

Links

• Full Changelog: makenotion/notion-sdk-js@v5.6.0...v5.7.0
• NPM Package: https://www.npmjs.com/package/@​notionhq/client/v/5.7.0

v5.6.0

Compare Source

What's Changed

• Add husky, lint-staged by @​michaelfromyeg in #​642
• Put build step back in prepare by @​michaelfromyeg in #​643
• Remove examples/ in favor of notion-cookbook by @​ksinder in #​647
• Add Client.pages.move endpoint to Notion TS SDK by @​ksinder in #​646
• Bump version to v5.6.0 by @​github-actions[bot] in #​650

Links

• Full Changelog: makenotion/notion-sdk-js@v5.4.0...v5.6.0
• NPM Package: https://www.npmjs.com/package/@​notionhq/client/v/5.6.0

v5.5.0

Compare Source

v5.4.0

Compare Source

What's Changed

• Tidy up gitignore, add CLAUDE.md by @​michaelfromyeg in #​638
• Add support for the place property type @​michaelfromyeg in #​637

Links

• Full Changelog: makenotion/notion-sdk-js@v5.3.0...v5.4.0
• NPM Package: https://npmjs.com/package/@​notionhq/client/v/5.4.0

v5.3.0

Compare Source

What's Changed

• api-endpoints sync: add pagination for ListDataSourceTemplates endpoint by @​ksinder in #​633
• Bump version to v5.3.0 by @​github-actions[bot] in #​634

Links

• Full Changelog: makenotion/notion-sdk-js@v5.2.1...v5.3.0
• NPM Package: https://npmjs.com/package/@​notionhq/client/v/5.3.0

v5.2.1

Compare Source

What's Changed

• Sync api-endpoints: support templates in Update Page by @​ksinder in #​631

Links

• Full Changelog: makenotion/notion-sdk-js@v5.2.0...v5.2.1
• NPM Package: https://npmjs.com/package/@​notionhq/client/v/5.2.1

v5.2.0

Compare Source

What's Changed

• API schema sync: small consolidation refactors and fixes by @​ksinder in #​622
• API schema sync: remove data_source_id type from DataSource.database_parent by @​ksinder in #​626
• Sync API schema: CreatePage + templates; workspace_id field; query wiki filters by @​ksinder in #​628
  • Including workspace_id in bot responses alongside workspace_name
  • Introducing a new API endpoint notion.dataSources.listTemplates with one path parameter, data_source_id, for listing the available page templates under a data source
  • Adding a new optional parameter template to CreatePageBodyParameters with polymorphic type options of none (don't apply any template; existing behavior), default (apply data source's default template), and template_id (apply a custom template ID)
  • Adding a new optional parameter result_type to QueryDataSourceBodyParameters to allow for only surfacing "page" or "data_source" result types in the case of wikis (where databases can be nested)

Links

• Full Changelog: makenotion/notion-sdk-js@1e9562d...v5.2.0
• NPM Package: https://npmjs.com/package/@​notionhq/client/v/5.2.0

v5.1.0

Compare Source

What's Changed

• Add support for is_locked on update page and database APIs
• Add request_id to Client log lines
• Remove page_id as a possible parent for CreateDataSourceBodyParameters
• SDK dataSource.update: add support for changing parent

Links

• Full Changelog: makenotion/notion-sdk-js@6945289...v5.1.0
• NPM Package: https://npmjs.com/package/@​notionhq/client/v/5.1.0

v5.0.0

Compare Source

What's Changed

Major changes and highlights from v4.0.2 to v5.0.0.

⚡️ Major API and SDK updates

• Added support for multiple data sources
  • Prepared the SDK for Notion API version 2025-09-03, introducing notion.dataSources.* endpoints to manage databases at the data source level and repurposing notion.databases.* endpoints for the database container. #​600 #​601 #​602 #​603 #​607 #​609
• Removed support for `notion.databases.list
  • The list databases method has been removed, since this endpoint has been deprecated & unsupported since 2022-02-22, and v5 of the SDK is tailored toward 2025-09-03 #​600
• Added support for verification filters for data sources
  • Added verification filter property to queryDataSources API shape #​604

📝 API shape and type improvements

• Richer API error details
  • SDK now surfaces the optional additional_data field in API error responses for better diagnostics. #​603
• API schema syncs
  • DataSourceObjectResponse["parent"] now supports the data_source_id variant.
  • Search filter enum updated from page | database to page | data_source.
  • Typechecking added for all examples/ projects in CI. #​602

🧩 Examples and internal maintenance

• Examples directory
  • Migrated all examples/ to TypeScript and committed missing build files. #​603 #​600
• CI improvements
  • All examples are now typechecked as part of continuous integration. #​602
• Other
  • Added Copilot instructions file for repo #​610

🛠 Miscellaneous fixes

• Documentation
  • Updated the minimum recommended TypeScript version in the README after a dependency upgrade. #​598
• Patch releases
  • Version bumps and lockfile updates to keep publish and infra consistent. #​596 #​597

[!NOTE]
v5.0.0 and 2025-09-03 bring fairly major changes to the SDK and to the API schema!

You can help us by tracking any friction as you upgrade, as well as any issues or improvement opportunities with the JavaScript → TypeScript changes in the examples/ projects, and filing an issue or opening a pull request for each.

New Contributors

• @​hallie made their first contribution in #​604

Links

• Full Changelog: makenotion/notion-sdk-js@f12b584...v5.0.0
• Upgrade Guide: https://developers.notion.com/docs/upgrade-guide-2025-09-03
• NPM Package: https://npmjs.com/package/@​notionhq/client/v/5.0.0

v4.0.2

Compare Source

What's Changed

• Update Notion JS SDK with GetComment endpoint by @​julyou in #​595
  • Introduces notion.comments.retrieve({...}) endpoint to fetch a comment by its ID; this was previously a hidden and un-documented endpoint
  • Introduces API shape to manually refresh an API token by passing grant_type: "refresh_token" with a refresh_token to notion.oauth.token(...)
  • Minor refactors and additional type exports
• Bump TypeScript dependency to 5.9 by @​ksinder in #​597
  • WARNING: This might be effectively a breaking change in some cases since part of the SDK contract is exporting types for Notion's public API endpoints. Before upgrading, confirm your TypeScript version is sufficiently new or that the types are compatible with your system.

Full Changelog: makenotion/notion-sdk-js@f849574...v4.0.2

View this version on NPM: https://www.npmjs.com/package/@​notionhq/client/v/4.0.2

v4.0.1

Compare Source

What's Changed

• Support additional headers passed to notion.request()

Full Changelog: makenotion/notion-sdk-js@f7bfcfd...v4.0.1

View this version on NPM: https://www.npmjs.com/package/@​notionhq/client/v/4.0.1

v4.0.0

Compare Source

What's Changed

• Remove no-op duplicates from union types across all endpoints by @​ksinder in #​579
• Remove legacy (<=2021) v1 API shape for page properties by @​ksinder in #​580
  • Removes support for the legacy (pre-Q3-2021) shape for page properties parameters from CreatePageBodyParameters and UpdatePageBodyParameters in src/api-endpoints.ts.
  • This collapses the union type of {old properties shape, new properties shape} down to the new shape only.
  • In the old shape, properties was a fairly ambiguous Record<string, ...> mapping each property key to the property value (a union type across all possible property types' values) e.g.

    {
      // ...
      "numberId": 24,
    }

  • In the new shape (the only one we want to support going forward), the value must be wrapped in an object that uses the polymorphic type pattern with the actual value defined in a sub-object to disambiguate:

    {
      // ...
      "numberId": {
        "type": "number",
        "number": 24
      }
    }

  • This matches up with our responses in the API read path so most, if not all, integrations are likely already using syntax compatible with the new shape
• chore: add JSDoc comments to API types by @​julyou in #​585
• Add support for attachments in Comment API by @​julyou in #​586
• CreatePage: support workspace-level private pages (+ misc param type refactors) by @​ksinder in #​587
  • No-op refactors/cleanups: extracting some components into separate type aliases, e.g. AnnotationRequest
  • Support the new mode in POST /v1/pages (CreatePage) API where:
    • parent can be omitted, or passed as {"workspace": true}, to create top-level private pages at the workspace level (for public integrations only)
    • properties is also optional. For standalone pages, this results in title defaulting to an empty string
• Sync API endpoints: add display_name to Comment, more extraction refactors and docstrings by @​ksinder in #​588
  • This includes miscellaneous extraction refactors for named subsets of parameters and other cleanups like new parameter docstrings.
  • The only functional change is adding the new display_name object to the CommentObjectResponse, and some fixes from previous PRs around parenthesizing a & (b | c) in allOf → oneOf OpenAPI types to get the correct result rather than defaulting to the incorrect interpretation (a & b) | c.
• Sync latest API endpoints schema as of 2025-06-30 by @​ksinder in #​590
  • Most of these are no-op re-ordering of type definitions.
  • Some added and edited comments/docstrings.
  • The only semantic change is adding support for the abc music language to LanguageRequest.

New Contributors

• @​julyou made their first contribution in #​585

Full Changelog: makenotion/notion-sdk-js@df95f35...v4.0.0

View this version on NPM: https://www.npmjs.com/package/@​notionhq/client/v/4.0.0

v3.1.3

Compare Source

What's Changed

• Add comments and docstrings to several API endpoint schemas by @​ksinder in #​573
• fix(types): Support browser fetch and remove node-fetch types by @​dvanoni in #​574

Full Changelog: makenotion/notion-sdk-js@0e38438...v3.1.3

View this version on NPM: https://www.npmjs.com/package/@​notionhq/client/v/3.1.3

v3.1.2

Compare Source

What's Changed

• Add max_file_upload_size_in_bytes field to User response by @​ksinder in #​570

Full Changelog: makenotion/notion-sdk-js@194f06d...v3.1.2

View this version on NPM: https://www.npmjs.com/package/@​notionhq/client/v/3.1.2

v3.1.1

Compare Source

What's Changed

• Updates node/nvm version required by @​typeoneerror in #​568

New Contributors

• @​typeoneerror made their first contribution in #​568

Full Changelog: makenotion/notion-sdk-js@f8bb1d0...v3.1.1

View this version on NPM: https://www.npmjs.com/package/@​notionhq/client/v/3.1.1

v3.1.0

Compare Source

What's Changed

• Add support for File Upload API endpoints by @​ksinder in #​565
  • Sync the latest OpenAPI schema for Notion's Public API to src/api-endpoints.ts
  • Introduce the /v1/file_uploads family of API endpoints (File Upload Create, Get, List, Send, Complete)
    • notion.fileUploads.send builds a FormData object to send fields via multipart/form-data
  • Add several refactors to extract common reused schema components, which drastically reduces the size of the file
• Add file upload API example and fix Blob send logic by @​ksinder in #​566
  • Fix the FormData parameter passing logic in src/Client.ts for the Send File Upload API
  • Add examples/intro-to-notion-api/intermediate/5-upload-file.js example of using the File Upload API to upload and attach a file

Full Changelog: makenotion/notion-sdk-js@f2e1665...v3.1.0

View this version on NPM: https://www.npmjs.com/package/@​notionhq/client/v/3.1.0

v3.0.1

Compare Source

What's Changed

• Support width_ratio parameter and field on column Blocks by @​ksinder in #​561
• Export several common api-endpoints types from src/index.ts by @​ksinder in #​562

Full Changelog: makenotion/notion-sdk-js@8b867fd...v3.0.1

View this version on NPM: https://www.npmjs.com/package/@​notionhq/client/v/3.0.1

v3.0.0

Compare Source

What's Changed

This update, v2.3.0 → v3.0.0, is marked as a major version upgrade due to the Node minimum version increase to 18, as part of the change to use built-in fetch as the default in the Client constructor instead of node-fetch.

• Sync OpenAPI schema as of 2025-04-08 to src/api-endpoints.ts by @​ksinder in #​558
  • Refactor common parameter shapes into new types: InternalFileRequest, ExternalFileRequest, and InternalOrExternalFileWithNameRequest
  • Support commenting on a non-page block in the Create Comment API by accepting a parent type of block_id
• Use isomorphic fetch by @​sv2dev in #​506
  • This updates the minimum Node engine version from 12 to 18.
• Small typo fixes in docs and example files
  • docs: fix incorrect example path in README by @​R-jisu in #​556
  • Update .env.example by @​jtsmith1287 in #​532
  • Update README.md with correct cd command by @​crosskayla in #​493

Full Changelog: makenotion/notion-sdk-js@650d23b...v3.0.0

View this version on NPM: https://www.npmjs.com/package/@​notionhq/client/v/3.0.0

New Contributors

• @​sv2dev made their first contribution in #​506
• @​R-jisu made their first contribution in #​556
• @​jtsmith1287 made their first contribution in #​532
• @​crosskayla made their first contribution in #​493

---

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
tech-blog	Error		Mar 30, 2026 5:31pm