FileUploadsEndpoint: R6 Class for File Uploads Endpoint

In notionapi: Client for the 'Notion API'

R6 Class for File Uploads Endpoint

Description

Handle all file uploads operations in the Notion API

Note: Access this endpoint through the client instance, e.g., notion$file_uploads. Not to be instantiated directly.

Value

A list containing the parsed API response.

Methods

Public methods

• FileUploadsEndpoint$new()

• FileUploadsEndpoint$create()

• FileUploadsEndpoint$send()

• FileUploadsEndpoint$complete()

• FileUploadsEndpoint$retrieve()

• FileUploadsEndpoint$list()

---

Method new()

Initialise file uploads endpoint. Not to be called directly, e.g., use notion$file_uploads instead.

Usage

FileUploadsEndpoint$new(client)

Arguments

client

Notion Client instance

---

Method create()

Create a file upload

Usage

FileUploadsEndpoint$create(
  mode = NULL,
  filename = NULL,
  content_type = NULL,
  number_of_parts = NULL,
  external_url = NULL
)

Arguments

mode

Character. How the file is being sent. Use "multi_part" for files larger than 20MB. Use "external_url" for files that are temporarily hosted publicly elsewhere. Default is "single_part".

filename

Character. Name of the file to be created. Required when mode is "multi_part". Must include an extension, or have one inferred from the content_type parameter.

content_type

Character. MIME type of the file to be created.

number_of_parts

Integer. When mode is "multi_part", the number of parts you are uploading.

external_url

Character. When mode is "external_url", provide the HTTPS URL of a publicly accessible file to import into your workspace.

---

Method send()

Upload a file

Usage

FileUploadsEndpoint$send(file_upload_id, file, part_number = NULL)

Arguments

file_upload_id

Character (required). Identifier for a Notion file upload object.

file

Named list (JSON object). The raw binary file contents to upload. Must contain named elements:

• filename. Character. The name of the file, including it's extension (e.g., "report.pdf")

• data. Raw. The binary contents of the file, as returned by e.g., readBin()

• type. Character. Optional. The MIME type of the file (e.g., "application/pdf", "image/png"). If not supplied, the type is inferred from filename by curl::form_file(). Supported file types are listed here.

part_number

Character. The current part number when uploading files greater than 20MB in parts. Must be an integer between 1 and 1,000

---

Method complete()

Complete a multi-part file upload

Usage

FileUploadsEndpoint$complete(file_upload_id)

Arguments

file_upload_id

Character (required). Identifier for a Notion file upload object.

Details

Endpoint documentation

---

Method retrieve()

Retrieve a file upload

Usage

FileUploadsEndpoint$retrieve(file_upload_id)

Arguments

file_upload_id

Character (required). Identifier for a Notion file upload object.

Details

Endpoint documentation

---

Method list()

List file uploads

Usage

FileUploadsEndpoint$list(status = NULL, start_cursor = NULL, page_size = NULL)

Arguments

status

Character. If supplied, the endpoint will return file uploads with the specified status. Available options are "pending", "uploaded", "expired", "failed".

start_cursor

Character. For pagination. If provided, returns results starting from this cursor. If NULL, returns the first page of results.

page_size

Integer. Number of items to return per page (1-100). Defaults to 100

Details

Endpoint documentation

Examples

notion <- notion_client()

# ----- Direct upload (files <= 20MB)
# Step 1: Create a File Upload object
(resp <- notion$file_uploads$create("single_part"))
file_upload_id <- resp[["id"]]

# Step 2: Upload file contents
#* replace with your file
path <- file.path(tempdir(), "test.pdf")
writeBin(charToRaw("placeholder"), path)
raw <- readBin(path, "raw", file.size(path))

notion$file_uploads$send(
  file_upload_id,
  list(
    filename = basename(path),
    data = raw
  )
)

# Retrieve the file upload
notion$file_uploads$retrieve(file_upload_id)


# ----- Multi-part upload (files > 20MB)
# Step 1: Split raw content into parts
#* replace with your file
raw <- as.raw(rep(65L, 11 * 1024 * 1024))
mid <- ceiling(length(raw) / 2)
parts <- list(raw[seq_len(mid)], raw[seq(mid + 1L, length(raw))])

# Step 2: Create a File Upload object
(resp <- notion$file_uploads$create(
  mode = "multi_part",
  filename = "test-large.txt",
  number_of_parts = 2L
))
file_upload_id <- resp[["id"]]

# Step 3: Send each part
for (i in seq_along(parts)) {
  notion$file_uploads$send(
    file_upload_id,
    file = list(
      filename = "test-large.txt",
      data = parts[[i]]
    ),
    part_number = as.character(i)
  )
}

# Step 4: Complete the upload
notion$file_uploads$complete(
  file_upload_id
)

# Retrieve the file upload
notion$file_uploads$retrieve(
  file_upload_id
)


# ----- Import external files
notion$file_uploads$create(
  "external_url",
  "dummy.pdf",
  content_type = "application/pdf",
  external_url = "https://github.com/brenwin1/notionapi/blob/main/tests/testthat/test.pdf"
)

notionapi documentation built on April 13, 2026, 9:07 a.m.