Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://developers.notion.com/docs/working-with-files-and-media below:

Working with files and media

Files, images, and other media bring your Notion workspace to life — from company logos and product photos to contract PDFs and design assets. With the Notion API, you can programmatically upload, attach, and reuse these files wherever they’re needed.

In this guide, you’ll learn how to:

• Upload a new file using the Direct Upload method (single-part)
• Retrieve existing files already uploaded to your workspace

We’ll also walk through the different upload methods and supported file types, so you can choose the best path for your integration.

The Notion API supports three ways to add files to your workspace:

Uploaded files can be attached to:

• Media blocks: file, image, pdf, audio, video
• Page properties: files properties in databases
• Page-level visuals: page icon and cover

💡 Need support for another block or content type? Let us know here.

Before uploading, make sure your file type is supported. Here’s what the API accepts:

⚠️

Ensure your file type matches the context

For example:

• You can’t use a video in an image block
• Page icons can’t be PDFs
• Text files can’t be embedded in video blocks

• Free workspaces are limited to 5 MiB (binary megabytes) per file
• Paid workspaces are limited to 5 GiB per file.
  • Files larger than 20 MiB must be split into parts and uploaded using multi-part mode in the API.

These are the same size limits that apply to uploads in the Notion app UI.

Use the Retrieve a user or List all users API to get the file size limit for a bot user. Public integrations that can be added to both free or paid workspaces can retrieve or cache each bot's file size limit. This can help avoid HTTP 400 validation errors for attempting to send files above the size limit.

type APIUserObject = {
  object: "user",
  type: "bot",
  // ... other fields omitted

  bot: {
    // ... other fields omitted

    // Limits and restrictions that apply to the bot's workspace.
    workspace_limits: {
      // The maximum allowable size of a file upload, in bytes.
      max_file_upload_size_in_bytes: number,
    },
  }
}

For example, in a free workspace where bots are limited to FileUploads of 5 MiB, the response looks like:

{
  "object": "user",
  "id": "be51669b-1932-4a11-8d35-38fbc2e1e4fd",
  "type": "bot",
  "bot": {
    "owner": {
      "type": "workspace"
    },
    "workspace_name": "Cat's Notion",
    "workspace_limits": {
      "max_file_upload_size_in_bytes": 5242880
    }
  }
}

Updated about 1 month ago

• Table of Contents
• • Upload methods at a glance
  • Supported block types
  • Supported file types
    • File size limits

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4