---
name: SDK (JS)
slug: notion-sdk-js
type: github
source_url: https://github.com/makenotion/notion-sdk-js
organization: Notion
organization_slug: notion
total_releases: 79
latest_version: v5.19.0
latest_date: 2026-04-17
last_updated: 2026-04-19
tracking_since: 2021-05-13
canonical: https://releases.sh/notion/notion-sdk-js
organization_url: https://releases.sh/notion
---

<Release version="v5.19.0" date="April 17, 2026" published="2026-04-17T18:51:55.000Z" url="https://github.com/makenotion/notion-sdk-js/releases/tag/v5.19.0">
## What's Changed

* **Add `update` method to `comments` namespace for UpdateComment endpoint** in https://github.com/makenotion/notion-sdk-js/pull/705
* **Update `markdown` field descriptions in comments endpoints to match updated API spec** in https://github.com/makenotion/notion-sdk-js/pull/709
* **Add `delete` method to `client.comments` for Delete Comment endpoint** in https://github.com/makenotion/notion-sdk-js/pull/706
* **Bump version to `v5.19.0`** in https://github.com/makenotion/notion-sdk-js/pull/710

## Links

- **Full Changelog**: https://github.com/makenotion/notion-sdk-js/compare/v5.18.0...v5.19.0
- **NPM Package**: https://www.npmjs.com/package/@notionhq/client/v/5.19.0

</Release>

<Release version="v5.18.0" date="April 13, 2026" published="2026-04-13T18:04:52.000Z" url="https://github.com/makenotion/notion-sdk-js/releases/tag/v5.18.0">
## What's Changed

* **Support multi-value filters for select, status, and multi_select property filters** in https://github.com/makenotion/notion-sdk-js/pull/707
* **Bump version to `v5.18.0`** in https://github.com/makenotion/notion-sdk-js/pull/708

## Links

- **Full Changelog**: https://github.com/makenotion/notion-sdk-js/compare/v5.17.0...v5.18.0
- **NPM Package**: https://www.npmjs.com/package/@notionhq/client/v/5.18.0
</Release>

<Release version="v5.17.0" date="April 7, 2026" published="2026-04-07T17:14:42.000Z" url="https://github.com/makenotion/notion-sdk-js/releases/tag/v5.17.0">
## What's Changed

* **Add `markdown` parameter to Create Comment endpoint** in https://github.com/makenotion/notion-sdk-js/pull/703
* **Bump version to `v5.17.0`** in https://github.com/makenotion/notion-sdk-js/pull/704

## Links

- **Full Changelog**: https://github.com/makenotion/notion-sdk-js/compare/v5.16.0...v5.17.0
- **NPM Package**: https://www.npmjs.com/package/@notionhq/client/v/5.17.0
</Release>

<Release version="v5.16.0" date="March 30, 2026" published="2026-03-30T18:34:22.000Z" url="https://github.com/makenotion/notion-sdk-js/releases/tag/v5.16.0">
## What's Changed

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

## Links

- **Full Changelog**: https://github.com/makenotion/notion-sdk-js/compare/v5.15.0...v5.16.0
- **NPM Package**: https://www.npmjs.com/package/@notionhq/client/v/5.16.0
</Release>

<Release version="v5.15.0" date="March 25, 2026" published="2026-03-25T15:18:07.000Z" url="https://github.com/makenotion/notion-sdk-js/releases/tag/v5.15.0">
## What's Changed

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

## Links

- **Full Changelog**: https://github.com/makenotion/notion-sdk-js/compare/v5.14.0...v5.15.0
- **NPM Package**: https://www.npmjs.com/package/@notionhq/client/v/5.15.0
</Release>

<Release version="v5.14.0" date="March 19, 2026" published="2026-03-19T23:14:42.000Z" url="https://github.com/makenotion/notion-sdk-js/releases/tag/v5.14.0">
## What's Changed

* **Sync `api-endpoints`: add status property support** by @ksinder in https://github.com/makenotion/notion-sdk-js/pull/686
  * See the ["Working with views" guide](https://developers.notion.com/guides/data-apis/working-with-views) and [changelog](https://developers.notion.com/page/changelog) on our developer website for more information
* **Add Views API endpoints** by @ksinder in https://github.com/makenotion/notion-sdk-js/pull/684
* **Bump version to `v5.14.0`** by @github-actions[bot] in https://github.com/makenotion/notion-sdk-js/pull/688

## Links

- **Full Changelog**: https://github.com/makenotion/notion-sdk-js/compare/v5.13.0...v5.14.0
- **NPM Package**: https://www.npmjs.com/package/@notionhq/client/v/5.14.0
</Release>

<Release version="v5.13.0" date="March 14, 2026" published="2026-03-14T16:43:59.000Z" url="https://github.com/makenotion/notion-sdk-js/releases/tag/v5.13.0">
## 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 https://github.com/makenotion/notion-sdk-js/pull/683
* **Security-related upgrades and improvements to repo GitHub actions** by @elb-notion in https://github.com/makenotion/notion-sdk-js/pull/652
* **Proposal: Add ability to quickly run starter project on Val Town** by @charmaine in https://github.com/makenotion/notion-sdk-js/pull/541
* **Bump version to `v5.13.0`** by @github-actions[bot] in https://github.com/makenotion/notion-sdk-js/pull/685

## New Contributors

* @charmaine made their first contribution in https://github.com/makenotion/notion-sdk-js/pull/541

## Links

- **Full Changelog**: https://github.com/makenotion/notion-sdk-js/compare/v5.12.0...v5.13.0
- **NPM Package**: https://www.npmjs.com/package/@notionhq/client/v/5.13.0
</Release>

<Release version="v5.12.0" date="March 9, 2026" published="2026-03-09T20:48:33.000Z" url="https://github.com/makenotion/notion-sdk-js/releases/tag/v5.12.0">
## 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 https://github.com/makenotion/notion-sdk-js/pull/676
* Add support for API version `2026-03-11` by @ksinder in https://github.com/makenotion/notion-sdk-js/pull/675
* fix: "Illegal invocation" error in Cloudflare Workers by @craigary in https://github.com/makenotion/notion-sdk-js/pull/681

## New Contributors

* @craigary made their first contribution in https://github.com/makenotion/notion-sdk-js/pull/681

## Links

- **Full Changelog**: https://github.com/makenotion/notion-sdk-js/compare/v5.11.1...v5.12.0
- **NPM Package**: https://www.npmjs.com/package/@notionhq/client/v/5.12.0
</Release>

<Release version="v5.11.1" date="March 2, 2026" published="2026-03-02T23:18:04.000Z" url="https://github.com/makenotion/notion-sdk-js/releases/tag/v5.11.1">
## What's Changed

- Sync api-endpoints: unsupported block type, update page docstring tweak by @ksinder in https://github.com/makenotion/notion-sdk-js/pull/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**: https://github.com/makenotion/notion-sdk-js/compare/v5.11.0...v5.11.1
- **NPM Package**: https://www.npmjs.com/package/@notionhq/client/v/5.11.1
</Release>

<Release version="v5.11.0" date="February 27, 2026" published="2026-02-27T00:16:01.000Z" url="https://github.com/makenotion/notion-sdk-js/releases/tag/v5.11.0">
## What's Changed

* Add `pages.retrieveMarkdown` and `pages.updateMarkdown` endpoints by @ksinder in https://github.com/makenotion/notion-sdk-js/pull/669
* Add warnings for unknown parameters passed to API methods by @dimasriat in https://github.com/makenotion/notion-sdk-js/pull/667

## New Contributors

* @dimasriat made their first contribution in https://github.com/makenotion/notion-sdk-js/pull/667

## Links

- **Full Changelog**: https://github.com/makenotion/notion-sdk-js/compare/v5.10.0...v5.11.0
- **NPM Package**: https://www.npmjs.com/package/@notionhq/client/v/5.11.0
</Release>

<Release version="v5.10.0" date="February 26, 2026" published="2026-02-26T18:59:54.000Z" url="https://github.com/makenotion/notion-sdk-js/releases/tag/v5.10.0">
## What's Changed

* Upgrade dev dependencies by @ksinder in https://github.com/makenotion/notion-sdk-js/pull/665
* Add automatic retry support with exponential backoff by @ksinder in https://github.com/makenotion/notion-sdk-js/pull/664
* Update transcription block response shape by @haustle in https://github.com/makenotion/notion-sdk-js/pull/668

## New Contributors

* @haustle made their first contribution in https://github.com/makenotion/notion-sdk-js/pull/668

## Links

- **Full Changelog**: https://github.com/makenotion/notion-sdk-js/compare/v5.9.0...v5.10.0
- **NPM Package**: https://www.npmjs.com/package/@notionhq/client/v/5.10.0
</Release>

<Release version="v5.9.0" date="January 29, 2026" published="2026-01-29T20:57:27.000Z" url="https://github.com/makenotion/notion-sdk-js/releases/tag/v5.9.0">
## 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()`](https://github.com/makenotion/notion-sdk-js?tab=readme-ov-file#custom-requests) with a properly formatted, absolute API path instead.

## Links

- **Full Changelog**: https://github.com/makenotion/notion-sdk-js/compare/v5.8.0...v5.9.0
- **NPM Package**: https://www.npmjs.com/package/@notionhq/client/v/5.9.0
</Release>

<Release version="v5.8.0" date="January 23, 2026" published="2026-01-23T21:01:02.000Z" url="https://github.com/makenotion/notion-sdk-js/releases/tag/v5.8.0">
## What's Changed
* Sync api-endpoints: add `position` to `AppendBlockChildrenParameters` by @ksinder in https://github.com/makenotion/notion-sdk-js/pull/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 https://github.com/makenotion/notion-sdk-js/pull/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 https://github.com/makenotion/notion-sdk-js/pull/659

**Full Changelog**: https://github.com/makenotion/notion-sdk-js/compare/v5.7.0...v5.8.0
</Release>

<Release version="v5.7.0" date="January 15, 2026" published="2026-01-15T02:25:43.000Z" url="https://github.com/makenotion/notion-sdk-js/releases/tag/v5.7.0">
## What's Changed

* Add 'Contributing' section to README. by @toolness in https://github.com/makenotion/notion-sdk-js/pull/655
* Sync api-endpoints: add `position` to `CreatePageBodyParameters` by @ksinder in https://github.com/makenotion/notion-sdk-js/pull/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**: https://github.com/makenotion/notion-sdk-js/compare/v5.6.0...v5.7.0
- **NPM Package**: https://www.npmjs.com/package/@notionhq/client/v/5.7.0
</Release>

<Release version="v5.6.0" date="December 16, 2025" published="2025-12-16T02:05:44.000Z" url="https://github.com/makenotion/notion-sdk-js/releases/tag/v5.6.0">
## What's Changed

* Add husky, lint-staged by @michaelfromyeg in https://github.com/makenotion/notion-sdk-js/pull/642
* Put build step back in prepare by @michaelfromyeg in https://github.com/makenotion/notion-sdk-js/pull/643
* Remove `examples/` in favor of `notion-cookbook` by @ksinder in https://github.com/makenotion/notion-sdk-js/pull/647
* Add `Client.pages.move` endpoint to Notion TS SDK by @ksinder in https://github.com/makenotion/notion-sdk-js/pull/646
* Bump version to v5.6.0 by @github-actions[bot] in https://github.com/makenotion/notion-sdk-js/pull/650

## Links

- **Full Changelog**: https://github.com/makenotion/notion-sdk-js/compare/v5.4.0...v5.6.0
- **NPM Package**: https://www.npmjs.com/package/@notionhq/client/v/5.6.0
</Release>

<Release version="v5.4.0" date="November 10, 2025" published="2025-11-10T00:13:36.000Z" url="https://github.com/makenotion/notion-sdk-js/releases/tag/v5.4.0">
## What's Changed

* Tidy up gitignore, add CLAUDE.md by @michaelfromyeg in https://github.com/makenotion/notion-sdk-js/pull/638
* Add support for the place property type @michaelfromyeg in https://github.com/makenotion/notion-sdk-js/pull/637

## Links

- **Full Changelog:** https://github.com/makenotion/notion-sdk-js/compare/v5.3.0...v5.4.0
- **NPM Package:** https://npmjs.com/package/@notionhq/client/v/5.4.0
</Release>

<Release version="v5.3.0" date="October 18, 2025" published="2025-10-18T16:23:26.000Z" url="https://github.com/makenotion/notion-sdk-js/releases/tag/v5.3.0">
## What's Changed

* `api-endpoints` sync: add pagination for `ListDataSourceTemplates` endpoint by @ksinder in https://github.com/makenotion/notion-sdk-js/pull/633
* Bump version to v5.3.0 by @github-actions[bot] in https://github.com/makenotion/notion-sdk-js/pull/634

## Links

- **Full Changelog**: https://github.com/makenotion/notion-sdk-js/compare/v5.2.1...v5.3.0
- **NPM Package**: https://npmjs.com/package/@notionhq/client/v/5.3.0
</Release>

<Release version="v5.2.1" date="October 17, 2025" published="2025-10-17T23:54:49.000Z" url="https://github.com/makenotion/notion-sdk-js/releases/tag/v5.2.1">
## What's Changed

* Sync api-endpoints: support templates in Update Page by @ksinder in https://github.com/makenotion/notion-sdk-js/pull/631

## Links

- **Full Changelog**: https://github.com/makenotion/notion-sdk-js/compare/v5.2.0...v5.2.1
- **NPM Package**: https://npmjs.com/package/@notionhq/client/v/5.2.1
</Release>

<Release version="v5.2.0" date="October 13, 2025" published="2025-10-13T21:29:49.000Z" url="https://github.com/makenotion/notion-sdk-js/releases/tag/v5.2.0">
## What's Changed

* API schema sync: small consolidation refactors and fixes by @ksinder in https://github.com/makenotion/notion-sdk-js/pull/622
* API schema sync: **remove `data_source_id` type from `DataSource.database_parent`** by @ksinder in https://github.com/makenotion/notion-sdk-js/pull/626
* Sync API schema: CreatePage + templates; `workspace_id` field; query wiki filters by @ksinder in https://github.com/makenotion/notion-sdk-js/pull/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**: https://github.com/makenotion/notion-sdk-js/compare/1e9562d46199c633cc10b05cbc250a82114e93dc...v5.2.0
- **NPM Package**: https://npmjs.com/package/@notionhq/client/v/5.2.0
</Release>

<Release version="v5.1.0" date="September 13, 2025" published="2025-09-13T17:09:55.000Z" url="https://github.com/makenotion/notion-sdk-js/releases/tag/v5.1.0">
## What's Changed

- [Add support for `is_locked` on update page and database APIs](https://github.com/makenotion/notion-sdk-js/commit/c1fc444b556dbc7b8a9af1abd3b1447211dfb538)
- [Add `request_id` to `Client` log lines](https://github.com/makenotion/notion-sdk-js/commit/09703a17f55f57f2753a00f5079abf409f45085b)
- [Remove `page_id` as a possible parent for `CreateDataSourceBodyParameters`](https://github.com/makenotion/notion-sdk-js/commit/d5ba92f04e7b3561ec97e1fc27b27f597663229c)
- [SDK `dataSource.update`: add support for changing `parent`](https://github.com/makenotion/notion-sdk-js/commit/698cd6ca37cdc2d0757ff40b2fed492a774344c5)

## Links

- **Full Changelog**: https://github.com/makenotion/notion-sdk-js/compare/6945289f774aa0150d9c382b1f88c752dbe0f925...v5.1.0
- **NPM Package**: https://npmjs.com/package/@notionhq/client/v/5.1.0
</Release>

<Pagination page="1" total-pages="4" total-items="79" next="https://releases.sh/notion/notion-sdk-js.md?page=2" />