Skip to main content
GET

Overview

Returns the folders in your space. By default it returns every folder; pass type 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

type
string
Filter by folder type: assets or videos. Omit to return folders of all types.

Response

folders
array
Array of folder objects.

Examples

Notes

  • Omitting type returns folders of every type; subfolders are identified by a non-null parent_folder_id.