Media

Folders

Requests, objects, and responses.

Guide →

Base URL and authentication

List folders

GET /media/v1/libraries/{library_id}/folders

ParameterLocationTypeDescription
library_idpathstringLibrary ID
parentquerystringParent 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

NameTypeDescription
foldersarray<object>All immediate child folders of parent, sorted by path.
folders[].namestringFinal path segment naming the child folder.
folders[].pathstringFull folder path relative to the library root.
folders[].asset_countnumberNumber 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

FieldTypeRequiredDescription
foldersobject[]yesFolders
Export

On this page