Notion

CLI-first rewrite with the Maton SDK examples; clarify that the CLI and SDKs keep separate credential stores, and reword webhook egress warnings

CLI-first rewrite: the maton CLI with OAuth login is the documented path, every example is a maton command, SDK examples added, and the raw HTTP fallback feeds the key on stdin instead of reading it from the environment

- Removed the file `skill-card.md` from the repository. - No changes made to code or functionality; documentation file only was deleted. - The skill continues to provide Notion API integration with managed OAuth as before.

- Clarified that all write operations (create, update, delete) require explicit user confirmation of the target resource and connection before execution. - Updated the description and introductory text to emphasize stricter confirmation requirements for write actions. - Adjusted documentation and usage notes to specify no writing is permitted without prior user approval. - Reinforced security best practices and scope boundaries regarding resource operations and connection selection.

Version 1.0.9 - Expanded Security & Permissions section with detailed user safety steps for write operations. - Added requirements for confirming targets (IDs), verifying connections, and stating if an action is reversible or destructive before any write. - Listed specific irreversible/high-risk operations that require extra caution. - Clarified strict scope boundaries and the need for explicit user approval before bulk or batch changes. - No changes to the skill's functionality or API surface.

Version 1.0.8 - Added comprehensive CLI usage examples for interacting with Notion via the Maton CLI. - Expanded installation and authentication instructions, including Homebrew and npm options. - Provided side-by-side CLI and Python code samples for all major workflows (connections, search, data sources, pages). - Clarified how to specify and manage multiple Notion connections in both CLI and API workflows. - Improved documentation structure, making setup and usage clearer for both CLI and API users.

- Changed all base URLs from gateway.maton.ai and ctrl.maton.ai to api.maton.ai. - Updated sample code and instructions to use the new api.maton.ai endpoints. - Added a security & permissions section, clarifying write operation requirements. - Minor wording and formatting improvements in documentation. - Removed the LICENSE.txt file.

- Added homepage field to metadata for better discoverability and navigation to Maton platform. - Minor metadata improvements; no changes to functionality or API usage.

- Added a metadata section for clawdbot, specifying an emoji and required environment variable (MATON_API_KEY). - No functional or API changes; documentation and compatibility remain the same.

Version 1.0.4 - No file changes detected in this release. - No updates or modifications to documentation or source code.

- Added a note recommending the api-gateway skill for third party apps other than Notion. - Replaced all shell/bash and JavaScript code examples with Python equivalents using `urllib.request` and standard libraries. - Updated code snippets and quick start instructions to reflect the new Python-based examples for API usage and connection management. - No changes to the API endpoints or core functionality; documentation updates only.

- Clarified the gateway base URL pattern: use `/notion/{native-api-path}` instead of `/notion/v1/{endpoint}`. - Added instructions for specifying the Notion connection via the new `Maton-Connection` header when multiple OAuth connections exist. - Improved the "Getting Your API Key" section to mention account creation. - Updated example connection response to include `creation_time`, `last_updated_time`, and `metadata`. - Improved documentation formatting and consistency, with adjustments to connection management and quick start sections.

- Clarified the relationship between databases and data sources: `GET /databases/{id}` now returns a `data_sources` array. - Added an example output for the `GET /databases/{id}` data sources structure for clarity. - Expanded connection management documentation with both "list connections" and "get single connection" response examples. - Added example for the "Update Page Icon" endpoint. - Improved explanations of endpoints and usage throughout for accuracy and consistency.

- Initial release of Notion API integration with managed OAuth. - Supports querying databases, creating/updating pages, and managing blocks in Notion workspaces. - API gateway proxies requests to Notion API and handles OAuth token injection. - Includes detailed setup instructions, API reference, connection management, and code examples (bash, JavaScript, Python). - Databases and data sources are clearly separated for querying and schema updates. - Comprehensive error handling and resource links provided.