Get Upload URL

Summary

Returns a URL for uploading a file to your site. Once you receive the target URL, POST your file contents to that address. The body of that request should contain only the bytes to be stored in the target file.

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.

Endpoint

GET https://mysite.files.com/v1.2/getUploadFileUrl

Replace mysite.files.com with your site address.

Request Parameters

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.