Skip to main content

Get Upload URL

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 contains 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, Files.com creates it automatically. Uploads are atomic — you cannot 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 to overwrite an existing file at the destination path, false to generate a different file name. Overrides the site-wide setting for allowing overwrites.