#17684: fix(skills): update notion skill for API 2025-09-03
stale
size: S
Cluster:
Skill Improvements and Fixes
Updates the Notion skill documentation to reflect the architectural changes in API version 2025-09-03 (Data Sources).
Changes:
- Updated database creation to use .
- Updated page creation to use .
- Clarified that pages must target the data source ID, not the database ID.
- Updated examples to match the new schema structure.
<!-- greptile_comment -->
<h3>Greptile Summary</h3>
Updated Notion skill documentation to reflect API version 2025-09-03's architectural changes, where databases now use a "data sources" model. The documentation correctly shows the new patterns:
- Database creation now uses `POST /v1/databases` with `initial_data_source` for schema definition
- Page creation requires `type: "data_source_id"` parent instead of `database_id`
- Querying continues to use `POST /v1/data_sources/{id}/query`
The PR description contains incomplete placeholder text (periods after "Updated database creation to use" and "Updated page creation to use"), though the actual code examples in the documentation are complete and correct.
<h3>Confidence Score: 4/5</h3>
- This PR is safe to merge - it's a documentation-only update with accurate technical content
- The documentation correctly reflects the Notion API 2025-09-03 changes with accurate code examples. Minor deduction for the incomplete PR description and the removal of the GET blocks operation documentation, but these don't affect the correctness of what's present.
- No files require special attention
<sub>Last reviewed commit: 32ecf0b</sub>
<!-- greptile_other_comments_section -->
<sub>(2/5) Greptile learns from your feedback when you react with thumbs up/down!</sub>
<!-- /greptile_comment -->
Most Similar PRs
#18411: docs(notion): add file upload documentation to Notion skill
by sigvardt · 2026-02-16
77.3%
#15803: fix(skills/github): add GraphQL introspection guidance
by rixau · 2026-02-13
75.2%
#5273: fix: skill frontmatter fixes + description improvements (35 skills)
by Terwox · 2026-01-31
75.1%
#7656: docs(slack): improve skill documentation with thread support and AP...
by pswpswpsw · 2026-02-03
74.8%
#8873: fix: document skill loading locations in system prompt
by ytfh44 · 2026-02-04
74.1%
#3933: fix(skills): Make skill scripts executable
by jaysonsantos · 2026-01-29
73.8%
#15860: docs(github): add GraphQL API guidance and schema introspection
by Shuai-DaiDai · 2026-02-14
73.1%
#13594: fix(skills): correct apple-notes SKILL.md memo -a syntax
by lailoo · 2026-02-10
72.4%
#19579: fix(skills): complete clawhub SKILL.md with missing commands
by buddyh · 2026-02-18
72.1%
#11048: fix: address repository issues (env, author, CI comments, security ...
by cavula · 2026-02-07
71.9%