Get Folders

Use this API to retrieve all video folders associated with your account. This can be used to organize, filter, or group videos based on folder assignments.

Prerequisites

• You have already created or uploaded videos into folders.
• You have a valid memories.ai API key.

Host URL

• https://api.memories.ai

Endpoint

GET /serve/api/video/get_folder

import requests

api_url = "https://api.memories.ai"
api_key = "<YOUR_API_KEY>"

url = f"{api_url}/serve/api/video/get_folder"
headers = {
    "Authorization": api_key
}

response = requests.get(url, headers=headers)

if response.status_code != 200:
    print("Failed to retrieve folders:", response.status_code)
    print(response.text)
else:
    result = response.json()
    folders = result.get("data", [])
    print(f"Retrieved {len(folders)} folders:")
    for folder in folders:
        print(f"- {folder.get('id')}: {folder.get('foldersName')}")

Request Parameters

Name	Location	Type	Required	Description
Authorization	header	string	Yes	Your API key for authentication

Response Example

{
  "code": "0000",
  "msg": "success",
  "data": [
    {
      "account": "[email protected]",
      "foldersName": "Default folder",
      "parentId": null,
      "level": 1,
      "id": "-1"
    },
    {
      "account": "[email protected]",
      "foldersName": "test",
      "parentId": null,
      "level": 1,
      "id": "590235112738787328"
    },
    {
      "account": "[email protected]",
      "foldersName": "API",
      "parentId": null,
      "level": 1,
      "id": "-2"
    }
  ],
  "failed": false,
  "success": true
}

Response Structure

Name	Type	Description
code	string	Response status code
msg	string	Human-readable status message
data	list of objects	List of folder metadata
» id	int	Unique folder identifier
» account	string	account username/email
» foldersName	string	Name of the folder
» parentId	string	parent folder id
» level	string	folder level

Notes

• Folder IDs returned from this API can be used to filter videos in other APIs (e.g., list_videos).
• This API returns all folders available to the authenticated user.