Upload a new file

POST /filemanager/api/v2/files

Method Details

HTTP Methods:

POST

Content Type:

multipart/form-data

Response Format:

json

Requires Authentication?

Yes

Rate Limited?

Yes

Headers

User-Agent

Products:

Marketing

Upload a new file to the file manager. This endpoint uses multi-part form encoding, rather than JSON.

On success, the response will include the metadata for the file.  See this page for an example.

Required Parameters How to use Description
OAuth Access Token or API Key Authorization: Bearer {token} header
or hapikey={key} query parameter.
Used to authenticate the request. Please see this page for more details about authentication.

Optional query string options

Parameter name Description
overwrite Set to 'true' if you want to overwrite a file of the same name. If false, will append a number to the file name and create a new file.

Allowed Fields in the body

Parameter name Type Description
file_names string The file name of the file you are uploading. Leave empty to use the original file name
files File data The multi-part form encoded file to upload.
folder_paths string The path within file manager to the folder you want to upload the files into.
folder_id long The ID of the folder you are uploading to. Leave blank to send file to root directory.