Skip to content

Upgrade notion-cli to Notion API 2025-09-03#1

Merged
joshed-io merged 1 commit intomainfrom
notion-cli-upgrade-2025-09-03
Feb 13, 2026
Merged

Upgrade notion-cli to Notion API 2025-09-03#1
joshed-io merged 1 commit intomainfrom
notion-cli-upgrade-2025-09-03

Conversation

@joshed-io
Copy link
Member

@joshed-io joshed-io commented Feb 13, 2026

Summary

  • Upgrades the Notion CLI from the legacy API (2022-02-22) to the current 2025-09-03 collection, adding full coverage of the Notion API
  • Adds new CLI commands: block, comment, datasource, file, user, docs, auth-internal, auth-public, integration
  • Adds generated API clients for all new endpoints (blocks CRUD, comments, data sources, file uploads, OAuth, pages CRUD, users), comprehensive tests, CI workflow, and expanded documentation

Test plan

  • Run npx tsx cli.ts --help and verify all new commands appear
  • Run existing commands (page get, database get, search) against a live Notion workspace
  • Run new commands (block get, user list, comment list, etc.) against a live workspace
  • Run npx vitest to execute the test suite
  • Verify the CI workflow triggers on push

Migrate the CLI from the legacy Notion API (2022-02-22) to the current
2025-09-03 collection. This is a significant expansion that adds full
coverage of the Notion API.

Key changes:
- Upgrade Notion-Version header from 2022-02-22 to 2025-09-03
- Add new commands: block, comment, datasource, file, user, docs,
  auth-internal, auth-public, integration
- Add generated API clients for all new endpoints (blocks CRUD,
  comments, data sources, file uploads, OAuth, pages CRUD, users)
- Expand existing page/database commands with create, update, archive,
  move, and property retrieval
- Add CI workflow (.github/workflows/notion-cli.yml)
- Add comprehensive tests for all commands
- Update README with full command reference and documentation
- Add UPGRADE.md tracking the API migration details
@joshed-io joshed-io merged commit 36be00f into main Feb 13, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant