@notionhq/client 4.0.0

v4.0.0

on Node.js NPM

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: df95f35...v4.0.0

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