Files
magnus919_agent-skills/notion/references/00-source-index.md
T
Magnus HedemarkGitHubfactory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
3256a87bcb feat(skill): add collaboration & business-app tool layer (Slack, Notion, email, CRM, payments) (#269)
Adds five top-level operational tool skills, one per named tool:

- slack: messages, channels, threads, search, files, and webhook signature
  verification (HMAC-SHA256) via a bounded, stdlib-only slack-cli.
- notion: pages, database queries, search, and guarded page updates via
  notion-cli.
- email: transactional email via Twilio SendGrid (send, deliverability
  bounces/spam reports, Signed Event Webhook verification with a
  self-contained ECDSA P-256 verifier) via email-cli.
- crm: HubSpot CRM records, contact search, and deal pipeline views with
  guarded stage updates via crm-cli.
- stripe: read-only-first balance, payment, and subscription queries with
  a guarded period-end subscription cancellation via stripe-cli.

Each skill ships an executable script (--json output, --limit bounded reads,
--dry-run/--yes mutation gate), a human README with the five required
sections, a schema-v1 evals/evals.json with six output-quality cases, a dated
source index + operations reference, and a deterministic unittest suite run
by check-artifacts. All five are indexed in the top-level README and the
generated catalogs were regenerated. Eval coverage rises from 78/139 to
83/144.

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
2026-08-03 20:19:26 -04:00

1.5 KiB

Notion — Source Index

Last Updated: 2026-08-03

This skill is a distilled operating layer over Notion's public developer documentation. Facts and endpoint names in this skill are grounded in the sources below; refresh this index when Notion ships API changes.

Topic Source URL
API reference (endpoints, versioning) Notion API reference https://developers.notion.com/reference
Versioning and the Notion-Version header API versioning https://developers.notion.com/reference/versioning
Authentication and integration tokens Authorization https://developers.notion.com/reference/authorization
Pages (retrieve, create, update) Page endpoints https://developers.notion.com/reference/patch-page
Database queries and filters Query a database https://developers.notion.com/reference/post-database-query
Search Search endpoint https://developers.notion.com/reference/post-search
Property types and values Property value objects https://developers.notion.com/reference/property-value-object

Refresh procedure

  • Re-check the API reference when a call returns validation_error for a documented body shape or when Notion-Version deprecations are announced.
  • The Notion-Version header is a security-adjacent contract pin: before changing the default in notion-cli, verify the new version's property object shapes in the versioning page.
  • Update research_checked in SKILL.md frontmatter and this file's Last Updated when you verify the sources again.