Get list of directories

Tree structure of directories.

This endpoint returns hierarchical data about directories in video hosting.

GET /streaming/directories/tree

Try it

Python

Python

import os
from gcore import Gcore

client = Gcore(
    api_key=os.environ.get("GCORE_API_KEY"),  # This is the default and can be omitted
)
directories_tree = client.streaming.directories.get_tree()
print(directories_tree.tree)

200

{
  "tree": [
    {
      "id": 123,
      "name": "<string>",
      "parent_id": 123,
      "items_count": 123,
      "created_at": "<string>",
      "updated_at": "<string>",
      "descendants": "<array>"
    }
  ]
}

Authorizations

Authorization · string · header · required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Response

200 - application/json

Successful

tree · object[]

Show child attributes

tree. id · integer

ID of the directory

tree. name · string

Title of the directory

tree. parent_id · integer

ID of a parent directory. "null" if it's in the root.

tree. items_count · integer

Number of objects in this directory. Counting files and folders. The quantity is calculated only at one level (not recursively in all subfolders).

tree. created_at · string

Time of creation. Datetime in ISO 8601 format.

tree. updated_at · string

Time of last update of the directory entity. Datetime in ISO 8601 format.

tree. descendants · array

Array of subdirectories, if any.