Box

Text

The Box connector is a text connector for Box file storage. It lists items in a folder, downloads file content, and ingests claims via db.ingest_text(). Supports file type filtering to process only the document types you need.

How it works

Uses the Box Content API (api.box.com/2.0) with Bearer token auth
Lists items in the specified folder (default: root folder "0")
Downloads file content via the /files/{id}/content endpoint
Optional file type filtering (e.g. only pdf, docx, txt)
Each file is ingested as a separate text document via db.ingest_text()
Provenance tracks the Box file ID and file name as source identifiers

Authentication

Box supports developer tokens (short-lived, for testing) and OAuth 2.0 tokens (for production). Developer tokens expire after 60 minutes. For long-running use, set up a Box application with OAuth 2.0 and use a refresh token flow.

1 Create a Box developer token or OAuth app

Go to the Box Developer Console, create a new app, and generate a Developer Access Token. For production use, configure OAuth 2.0 with the base_explorer scope.

2 Install requests

$ pip install requests

3 Connect

conn = db.connect("box",
    token=os.environ["BOX_TOKEN"],
)
result = conn.run(db)

Parameter	Required	Default	Description
`token`	Yes	—	Box API access token (developer token or OAuth)
`folder_id`	No	`"0"`	Box folder ID (default `"0"` = root folder)
`max_files`	No	`50`	Maximum number of files to process
`file_types`	No	All types	List of file extensions to include (e.g. `["pdf", "docx", "txt"]`)
`extraction`	No	`heuristic`	Text extraction mode: `heuristic` or `llm`
`save`	No	`False`	Encrypt and persist token

Basic usage

conn = db.connect("box",
    token=os.environ["BOX_TOKEN"],
)
result = conn.run(db)
print(f"Ingested {result.claims_ingested} claims from {result.files_processed} files")

With file type filter

conn = db.connect("box",
    token=os.environ["BOX_TOKEN"],
    file_types=["pdf", "docx", "txt"],
    max_files=100,
    extraction="llm",
)
result = conn.run(db)

Specific folder

conn = db.connect("box",
    token=os.environ["BOX_TOKEN"],
    folder_id="123456789",
    save=True,
)
result = conn.run(db)

Box