FileStorage

Upload and download files for your automations

File storage allows agents to upload and download files from websites. Storage is persistent and session-scoped so you can retrieve files after the session ends.

from notte_sdk import NotteClient

client = NotteClient()
storage = client.FileStorage()

# Upload files before the session
storage.upload("document.pdf")

# Attach storage to session
with client.Session(storage=storage) as session:
    agent = client.Agent(session=session)
    agent.run(task="Upload document.pdf and download the receipt")

# Download files after the session
for file_name in storage.list_downloaded_files():
    storage.download(file_name=file_name, local_dir="./downloads")

Methods

upload

upload(file_path: str, upload_file_name: str | None = None) -> bool

Upload a local file to storage.

Parameters:

• file_path - Path to the local file
• upload_file_name - Optional custom name for the file in storage

Returns: bool - Success status

---

download

download(file_name: str, local_dir: str, force: bool = False) -> bool

Download a file from storage to a local directory.

Parameters:

• file_name - Name of the file in storage
• local_dir - Local directory to save the file
• force - Overwrite existing file (default: False)

Returns: bool - Success status

---

list_uploaded_files

list_uploaded_files() -> list[str]

List files you’ve uploaded to storage.

Returns: list[str] - List of uploaded filenames

---

list_downloaded_files

list_downloaded_files() -> list[str]

List files downloaded by agents during sessions.

Returns: list[str] - List of downloaded filenames

Parameters

session_id · UnionType[str, None] · default: "None"