PipedreamHQ/pipedream

[ACTION] Simplify Notion upload image affordance

Open

#20537 opened on Apr 7, 2026

View on GitHub
 (1 comment) (0 reactions) (0 assignees)JavaScript (7,438 stars) (5,305 forks)batch import
actionenhancementgood first issuehelp wantedtriaged

Description

It seems like the add block action is limited in its scope and only supports adding a small subsection of content. Ex. it only supports adding external image urls.

https://github.com/PipedreamHQ/pipedream/blob/master/components/notion/actions/append-block/append-block.mjs

https://www.notion.com/help/images-files-and-media#media-block-types https://developers.notion.com/reference/patch-block-children

We need this append-block action to support uploading base64 encoded data urls. i.e. Append block children with type: "file"

In the meantime, we can work around this with this series of actions:

  • create file upload (with the encoded data uri to upload)
  • send file upload
  • append block to parent (with a fake image url to get a block id, since this block doesn't let us specify any payload)
  • update child block (with {"type": "image","image": {"caption": [],"file_upload": {"id": "{{ @sendFile.id }}"}}}

Is there a specific app this action is for? Notion

Please provide a link to the relevant API docs for the specific service / operation. https://developers.notion.com/reference/patch-block-children

Contributor guide

Tech stack
javascriptnodejsrest api
Domain
backendapi
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
JavaScriptNotion API basicsPipedream components
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
75
Research direction
Start by examining the existing append block.mjs file at the given GitHub link to understand the current implementation. Then review the Notion API documentation for patch block children endpoint, specifically the file upload section. Consider how to handle base64 encoded data by converting to a temporary file or using a data URI directly. Check if there are any existing action components in the repository that perform file uploads for reference.