Get Full Folder Tree
Retrieves the complete folder hierarchy starting from the root folder
GET
/api/v1/{app_id}/folders/tree- API
- DAM
- OpenAPI
- dam-api
- Updated
- Apr 26, 2026
dam-api:GET:/api/v1/{app_id}/folders/tree
Retrieves the complete folder hierarchy starting from the root folder
API ownership
- API family: DAM public reads
- Best for: Public asset-library folder, media, facet, and shareable-link reads. Use Management API DAM routes for authenticated administration.
- Guide route: /media/dam/latest
The OpenAPI contract defines the method, path, parameters, request body, and responses for this operation.
Operation
- Method:
GET - Path:
/api/v1/\{app_id\}/folders/tree - Summary: Get Full Folder Tree
- Description: Retrieves the complete folder hierarchy starting from the root folder
- OpenAPI contract: dam-api
- Operation ID: Not documented in the OpenAPI contract.
Operation key uses API family, method, and path because this OpenAPI contract does not publish an operation ID.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| app_id | path | Yes | string | App ID |
Request body
Not documented in the OpenAPI contract.
Responses
| Status | Description | Content |
|---|---|---|
| 200 | Full folder tree | application/json (object) |
| 400 | Invalid request | application/json (object) |
| 404 | Root folder not found | application/json (object) |
| 500 | Internal server error | application/json (object) |
200 - object
Full Folder Tree Response
| Property | Type | Required | Details |
|---|---|---|---|
data | object | No | - |
success | boolean | No | - |
Folder Tree Item
| Property | Type | Required | Details |
|---|---|---|---|
children | object[] | No | - |
created_at | string | No | - |
file_count | integer | No | - |
has_content_access | boolean | No | - |
id | string | No | - |
image_count | integer | No | - |
is_default | boolean | No | - |
name | string | No | - |
parent_id | string | No | - |
public | boolean | No | - |
slug | string | No | - |
updated_at | string | No | - |
video_count | integer | No | - |
Generated example (synthetic):
{
"data": {
"children": [
{
"children": [],
"created_at": "string",
"file_count": 0,
"has_content_access": false,
"id": "string",
"image_count": 0,
"is_default": false,
"name": "string",
"parent_id": "string",
"public": false,
"slug": "string",
"updated_at": "string",
"video_count": 0
}
],
"created_at": "string",
"file_count": 0,
"has_content_access": false,
"id": "string",
"image_count": 0,
"is_default": false,
"name": "string",
"parent_id": "string",
"public": false,
"slug": "string",
"updated_at": "string",
"video_count": 0
},
"success": false
}400 - object
Error
| Property | Type | Required | Details |
|---|---|---|---|
details | string[] | No | - |
error | string | No | - |
Generated example (synthetic):
{
"details": [
"string"
],
"error": "string"
}404 - object
Error
| Property | Type | Required | Details |
|---|---|---|---|
details | string[] | No | - |
error | string | No | - |
Generated example (synthetic):
{
"details": [
"string"
],
"error": "string"
}500 - object
Error
| Property | Type | Required | Details |
|---|---|---|---|
details | string[] | No | - |
error | string | No | - |
Generated example (synthetic):
{
"details": [
"string"
],
"error": "string"
}Contract identity
Use these fields to confirm you are implementing the intended endpoint contract.
- API family: DAM public reads
- Method:
GET - Path:
/api/v1/\{app_id\}/folders/tree - Operation ID: Not documented in the OpenAPI contract.
- OpenAPI tag: Folders
- OpenAPI summary: Get Full Folder Tree