curl -X GET "https://app.hoox.video/api/public/v1/folder/list" \
-H "Authorization: Bearer your_api_key"
curl -X GET "https://app.hoox.video/api/public/v1/folder/list?type=assets" \
-H "Authorization: Bearer your_api_key"
import requests
url = "https://app.hoox.video/api/public/v1/folder/list"
headers = {"Authorization": "Bearer your_api_key"}
response = requests.get(url, headers=headers, params={"type": "assets"})
print(response.json()["folders"])
const url = new URL('https://app.hoox.video/api/public/v1/folder/list');
url.searchParams.set('type', 'assets');
const res = await fetch(url, {
headers: { 'Authorization': 'Bearer your_api_key' },
});
const { folders } = await res.json();
console.log(folders);
{
"folders": [
{
"id": "662f8c1d3a4b5e6f70123456",
"name": "Summer Campaign",
"type": "assets",
"parent_folder_id": null,
"created_at": "2026-06-19T10:00:00.000Z"
},
{
"id": "662f8c1d3a4b5e6f70987654",
"name": "Hero shots",
"type": "assets",
"parent_folder_id": "662f8c1d3a4b5e6f70123456",
"created_at": "2026-06-19T10:05:00.000Z"
}
]
}
Folder
List Folders
List the folders in your space, optionally filtered by type
GET
/
api
/
public
/
v1
/
folder
/
list
curl -X GET "https://app.hoox.video/api/public/v1/folder/list" \
-H "Authorization: Bearer your_api_key"
curl -X GET "https://app.hoox.video/api/public/v1/folder/list?type=assets" \
-H "Authorization: Bearer your_api_key"
import requests
url = "https://app.hoox.video/api/public/v1/folder/list"
headers = {"Authorization": "Bearer your_api_key"}
response = requests.get(url, headers=headers, params={"type": "assets"})
print(response.json()["folders"])
const url = new URL('https://app.hoox.video/api/public/v1/folder/list');
url.searchParams.set('type', 'assets');
const res = await fetch(url, {
headers: { 'Authorization': 'Bearer your_api_key' },
});
const { folders } = await res.json();
console.log(folders);
{
"folders": [
{
"id": "662f8c1d3a4b5e6f70123456",
"name": "Summer Campaign",
"type": "assets",
"parent_folder_id": null,
"created_at": "2026-06-19T10:00:00.000Z"
},
{
"id": "662f8c1d3a4b5e6f70987654",
"name": "Hero shots",
"type": "assets",
"parent_folder_id": "662f8c1d3a4b5e6f70123456",
"created_at": "2026-06-19T10:05:00.000Z"
}
]
}
Overview
Returns the folders in your space. By default it returns every folder; passtype to return only asset folders or only video folders. Use a folder’s id as folder_id when calling Submit Asset Generation, or check this list before creating a new folder to avoid duplicates.
Authentication
This endpoint requires API key authentication. Include your API key in the
Authorization header.Query Parameters
string
Filter by folder type:
assets or videos. Omit to return folders of all types.Response
array
Array of folder objects.
Examples
curl -X GET "https://app.hoox.video/api/public/v1/folder/list" \
-H "Authorization: Bearer your_api_key"
curl -X GET "https://app.hoox.video/api/public/v1/folder/list?type=assets" \
-H "Authorization: Bearer your_api_key"
import requests
url = "https://app.hoox.video/api/public/v1/folder/list"
headers = {"Authorization": "Bearer your_api_key"}
response = requests.get(url, headers=headers, params={"type": "assets"})
print(response.json()["folders"])
const url = new URL('https://app.hoox.video/api/public/v1/folder/list');
url.searchParams.set('type', 'assets');
const res = await fetch(url, {
headers: { 'Authorization': 'Bearer your_api_key' },
});
const { folders } = await res.json();
console.log(folders);
{
"folders": [
{
"id": "662f8c1d3a4b5e6f70123456",
"name": "Summer Campaign",
"type": "assets",
"parent_folder_id": null,
"created_at": "2026-06-19T10:00:00.000Z"
},
{
"id": "662f8c1d3a4b5e6f70987654",
"name": "Hero shots",
"type": "assets",
"parent_folder_id": "662f8c1d3a4b5e6f70123456",
"created_at": "2026-06-19T10:05:00.000Z"
}
]
}
Notes
- Omitting
typereturns folders of every type; subfolders are identified by a non-nullparent_folder_id.
Was this page helpful?

