Skip to main content
POST
Upload Files to Project

Permissions

Requires Vault API and Modify workspace projects permissions.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

project_id
string
required

The project ID.

Body

multipart/form-data
files
file[]

Path to the files to be uploaded, e.g. @/path/to/hello_world.pdf. Each file is a separate multipart/form-data. PDF, DOCX, XLSX, PPT, TXT, RTF, CSV, EML, and other file formats supported (reference our Help Center). Max size of 500 MB for all file types. A maximum of 50 files can be uploaded per API request. Beware of HTTPS timeouts if too many large files are sent at a time.

Example:

"@/path/to/hello_world.pdf"

file_paths
string[]

The desired folder structure for the file(s), e.g. /caselaw/usa/california/sf/hello_world.pdf. This will be reconciled with the names in the provided files paths.

Example:

"/caselaw/usa/california/sf/hello_world.pdf"

duplicate_mode
enum<string>

Determines how duplicate file names are handled. skip will not update if a file with the same name already exists. replace will create a new file record (with its own unique file_id) and set its root_file_id to the original file_id. keep will rename the new file to avoid collision (e.g. document (1).pdf).

Available options:
skip,
replace,
keep
Example:

"skip"

Response

Files successfully uploaded

project_id
string

The project ID.

file_ids
string[]

Array of file IDs that were added to the project.