Media
Folders
Requests, objects, and responses.
List folders
GET /media/v1/libraries/{library_id}/folders
| Parameter | Location | Type | Description |
|---|---|---|---|
| library_id | path | string | Library ID |
| parent | query | string | Parent folder path; omit or use an empty string for the root. Returns every child folder of that level at once without paging; limit or cursor returns 400 |
Returns: Folders.
Response
HTTP 200
Successful response.
application/json
| Name | Type | Description |
|---|---|---|
| folders | array<object> | All immediate child folders of parent, sorted by path. |
| folders[].name | string | Final path segment naming the child folder. |
| folders[].path | string | Full folder path relative to the library root. |
| folders[].asset_count | number | Number of assets in this folder and all descendant folders. |
curl -X GET "https://api.deepraxis.ai/media/v1/libraries/${LIBRARY_ID}/folders" \
-H "Authorization: Bearer $PRAXIS_API_KEY"HTTP 200
{
"folders": [
{
"name": "examples",
"path": "examples",
"asset_count": 1
}
]
}Folders
| Field | Type | Required | Description |
|---|---|---|---|
| folders | object[] | yes | Folders |