Files & Folders

Manage your media files using files and folders

There are many reasons you might want to upload a file to the API, including to combine an audio tag with your generated audio, to add a soundtrack, or to upload source files for voice cloning.

Uploading a File

To upload a file, you need to first create an upload URL (address) to send the file to. The URL will be valid for 7 days from when you create it, and doesn't need any authentication to use after it's been created.

You'll need to provide a filepath (where the file will live) and a file type (such as WAV or MP3), and have the option to provide additional information or metadata to help you find your file in future.


Note that all files uploaded can be viewed by anyone in your organisation

If you want to restrict access to certain users for sensitive content, you can create a "child" organisation to restrict the access to certain users in your team

Moving or Deleting a File

To move a file to a different location, you can simply supply the File ID to the following endpoint, along with the updated file path:

To delete a file, provide the File ID instead to this endpoint:

Adding or Changing Categories, Tags and Metadata

There are a few ways you can easily identify your files, so that they can be found. These include fixed categories, to identify the purpose of your file (such as sound design, voice files etc), as well as more flexible tags (to identify what project your file belongs to) and custom metadata (to provide details such as whose voice it is, or other custom data).

Creating or Deleting a Folder

Creating a folder is really simple - you just need to specify the name of the folder. To delete a folder, specify which folder you'd like to remove.


Did you know?

You can now see and manage your files and folders at as well as via the API.

What’s Next

Find out more about what you can do with your Files: