Upload a File


Upload a file to your site. The authenticated user must have write permissions. If you provide a folder path that does not exist, it will be created automatically.

Uploads are atomic; it is not possible resume an interrupted upload.

In order to upload a file using the v1.2 legacy ExaVault API, it was originally necessary to first use the getFileUploadUrl function to generate a target URL, and legacy code may still use that function.


POST https://mysite.files.com/v1.2/upload

Replace mysite.files.com with your site address.

Request Parameters

All of the parameters listed below are query parameters. The body of the request should contain only the bytes to be uploaded for the file.

NameData TypeDescription
access_tokenstringRequired. The session key that identifies which user is authenticated. Either an access token returned by the authenticateUser function, or a a Files.com user API Key.
fileSizeintegerRequired. Size of the file to upload, in bytes.
destinationPathstringRequired. Full path, including the filename, where the file will be uploaded.
allowOverwritebooleanTrue if the file should be overwritten, false if different file names should be generated.
This will override the site-wide setting for allowing overwrites.

Get Instant Access to Files.com

The button below will take you to our Free Trial signup page. Click on the white "Start My Free Trial" button, then fill out the short form on the next page. Your account will be activated instantly. You can dive in and start yourself or let us help. The choice is yours.

Start My Free Trial

©2024 Files.com. All right reserved


  • Start My Free Trial
  • Pricing
  • Docs
  • API and SDKs
  • Contact



(800) 286-8372


9am–8pm Eastern