Skip to main content
The Dohoo Folders API lets you create a folder structure inside your media library so you can keep your uploads organized by campaign, client, platform, or any other convention that fits your workflow. Each folder can hold any number of uploaded files, and you can list, rename, or delete folders at any time.
All Folders API requests require your API key in the X-API-Key header.

​
List all folders


GET /api/upload/folders Returns a list of all folders in your account, including their IDs and names.

​
Create a folder


POST /api/upload/folders Creates a new folder with the name you provide. The response includes the new folder’s id, which you’ll use when listing its contents, renaming it, or deleting it. Request body
​
string
required
The display name for the new folder (e.g. Campaign Q1).

​
List files in a folder


GET /api/upload/folders/{folderId}/files Returns all files stored inside a specific folder.
​
string
required
The unique identifier of the folder whose files you want to list.

​
Rename a folder


PATCH /api/upload/folders/{folderId} Updates the display name of an existing folder. Only the name field is updated — the folder’s contents and ID remain unchanged.
​
string
required
The unique identifier of the folder to rename.
​
string
required
The new display name for the folder.

​
Delete a folder


DELETE /api/upload/folders/{folderId} Deletes a folder from your account.
​
string
required
The unique identifier of the folder to delete.
Deleting a folder permanently deletes all files inside it as well. This action cannot be undone. Make sure you no longer need any of the files the folder contains before deleting it.