claude_file_upload: Upload, downloand, and manage files for Claude

In ellmer: Chat with Large Language Models

Upload, downloand, and manage files for Claude

Description

Use the beta Files API to upload files to and manage files in Claude. This is currently experimental because the API is in beta and may change. Note that you need beta-headers = "files-api-2025-04-14" to use the API.

Claude offers 100GB of file storage per organization, with each file having a maximum size of 500MB. For more details see https://docs.claude.com/en/docs/build-with-claude/files

• claude_file_upload() uploads a file and returns an object that you can use in chat.

• claude_file_list() lists all uploaded files.

• claude_file_get() returns an object for an previously uploaded file.

• claude_file_download() downloads the file with the given ID. Note that you can only download files created by skills or the code execution tool.

• claude_file_delete() deletes the file with the given ID.

Usage

claude_file_upload(
  path,
  base_url = "https://api.anthropic.com/v1/",
  beta_headers = "files-api-2025-04-14",
  credentials = NULL
)

claude_file_list(
  base_url = "https://api.anthropic.com/v1/",
  credentials = NULL,
  beta_headers = "files-api-2025-04-14"
)

claude_file_get(
  file_id,
  base_url = "https://api.anthropic.com/v1/",
  credentials = NULL,
  beta_headers = "files-api-2025-04-14"
)

claude_file_download(
  file_id,
  path,
  base_url = "https://api.anthropic.com/v1/",
  credentials = NULL,
  beta_headers = "files-api-2025-04-14"
)

claude_file_delete(
  file_id,
  base_url = "https://api.anthropic.com/v1/",
  credentials = NULL,
  beta_headers = "files-api-2025-04-14"
)

Arguments

path	Path to download the file to.
base_url	The base URL to the endpoint; the default is Claude's public API.
beta_headers	Beta headers to use for the request. Defaults to files-api-2025-04-14.
credentials	Override the default credentials. You generally should not need this argument; instead set the ANTHROPIC_API_KEY environment variable. The best place to set this is in .Renviron, which you can easily edit by calling usethis::edit_r_environ(). If you do need additional control, this argument takes a zero-argument function that returns either a string (the API key), or a named list (added as additional headers to every request).
file_id	ID of the file to get information about, download, or delete.

Examples

## Not run: 
file <- claude_file_upload("path/to/file.pdf")
chat <- chat_anthropic(beta_headers = "files-api-2025-04-14")
chat$chat("Please summarize the document.", file)

## End(Not run)

ellmer documentation built on July 14, 2026, 1:07 a.m.