動画の容量と保存 · 参考資料確認日 2026年9月21日
Notion APIの20 MB境界とworkspaceのファイル上限
multipartを使えばどのworkspaceにも大容量ファイルを置けるわけではありません。アップロード方式とworkspaceの許容量の両方を確かめます。
方式の20 MBとworkspace上限を分ける
Notion APIの概要はDirect Uploadを<=20 MB、より大きなファイルをmultipartで送る経路として案内しています。workspaceごとのファイル上限はFreeが5 MiB、Paidが5 GiBです。20 MBと5 MiB/5 GiBを同じ単位に丸めたり、multipartならFreeの5 MiBを超えられると考えたりしないでください。
botのworkspace_limits.max_file_upload_size_in_bytesで、そのworkspaceに適用される正確なバイト上限を取得できます。関連する案内には20 MiBや5 GBという別表記もあるため、境界付近は表現を推測して通すよりこの値で判定します。multipartの各partにも最終partを除いて5～20 binary megabytesの条件があり、10 MBのpartが推奨されています。
上限を取得してから送信・添付する
botのworkspaceとmax_file_upload_size_in_bytesを確認し、ファイルの実バイト数と比べてください。方式は<=20 MBのDirectか大きいファイルのmultipartから選び、part条件を守って送信します。ファイル名は900 bytes以内にします。
送信後はpendingのFile Uploadを1時間以内にページなどへ添付します。添付されないと期限切れになるためです。APIで得たダウンロードURLも1時間で失効するので、再利用時は対象オブジェクトを再取得してください。
参考資料
- developers.notion.com
https://developers.notion.com/guides/data-apis/working-with-files-and-media
確認日：2026-09-21
- developers.notion.com
https://developers.notion.com/guides/data-apis/uploading-small-files
確認日：2026-09-21
- developers.notion.com
https://developers.notion.com/guides/data-apis/sending-larger-files
確認日：2026-09-21