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
Response
Array of folder objects.
Show folder properties
Show folder properties
Unique identifier of the folder. For an asset folder, pass this as
folder_id to Submit Asset Generation.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?

