hermes - 💡(How to fix) Fix [Feature]: Notion Direct File Upload (v1/file_uploads) in default skills [1 participants]

Problem or Use Case

The default Notion skills currently lack support for direct file uploads using Notion’s v1/file_uploads API. This prevents attaching local or generated files (e.g. images, PDFs, artifacts) directly to Notion pages, as the existing workflow relies on externally hosted URLs and misses Notion’s new, official upload flow.

Reference:

• https://developers.notion.com/guides/data-apis/working-with-files-and-media

Proposed Solution

Default Notion skills should support the complete direct file upload and attachment flow using Notion’s v1/file_uploads API, including:

1. Create file upload metadata (POST /v1/file_uploads)
2. Upload the file content to the provided URL(s)
3. Complete and attach upload as required by Notion
4. Attach the uploaded file to Notion blocks/pages/databases as supported

The implementation should:

• Add a new Notion skill action (e.g. notion_upload_file) wrapping the full upload lifecycle
• Support common MIME types, file size limits, and relevant error handling
• Return a reference usable for subsequent Notion create or update calls
• Include tests for both success and failure paths (auth error, unsupported type, upload error)
• Update docs with usage examples for Hermes workflows

Alternatives Considered

Workarounds with externally hosted URLs or separate file storage are brittle, less secure, and do not leverage the latest Notion Data API features. Using the direct upload flow is the most robust, official, and future-proof approach.

Feature Type

New bundled skill

Scope

Small (single file, < 50 lines)

Contribution

• I'd like to implement this myself and submit a PR

Debug Report (optional)