Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.dohoo.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.
X-API-Key: dh_live_xxxxxxxxxxxxxxxxxxxxxxxx

​
List all folders


GET /api/upload/folders Returns a list of all folders in your account, including their IDs and names. 
curl https://dohoo.ai/api/upload/folders \
  -H "X-API-Key: dh_live_xxxx"

​
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
​
name
string
required
The display name for the new folder (e.g. Campaign Q1).
curl -X POST https://dohoo.ai/api/upload/folders \
  -H "X-API-Key: dh_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{"name": "Campaign Q1"}'

​
List files in a folder


GET /api/upload/folders/{folderId}/files Returns all files stored inside a specific folder.
​
folderId
string
required
The unique identifier of the folder whose files you want to list.
curl https://dohoo.ai/api/upload/folders/folder_abc123/files \
  -H "X-API-Key: dh_live_xxxx"

​
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.
​
folderId
string
required
The unique identifier of the folder to rename.
​
name
string
required
The new display name for the folder.
curl -X PATCH https://dohoo.ai/api/upload/folders/folder_abc123 \
  -H "X-API-Key: dh_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{"name": "Campaign Q2"}'

​
Delete a folder


DELETE /api/upload/folders/{folderId} Deletes a folder from your account.
​
folderId
string
required
The unique identifier of the folder to delete.
curl -X DELETE https://dohoo.ai/api/upload/folders/folder_abc123 \
  -H "X-API-Key: dh_live_xxxx"
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.