Skip to main content
The Media Library API gives you programmatic access to the file storage system within your HoopAI Platform sub-account. Use it to upload images, videos, and documents (up to 25 MB for general files, 500 MB for video), list and search existing files and folders, rename or bulk-update items, and soft-delete or permanently trash files.

​
Base URL

https://services.leadconnectorhq.com

​
Authentication

Every request must include a bearer token in the Authorization header. 
Authorization: Bearer <access_token>
Use an access token generated for a Sub-Account user type, or a Private Integration Token scoped to the sub-account. The altType query parameter must be set to location and altId to your location ID on all requests.

​
OAuth scopes

ScopeAccess
medias.readonlyRead and list files and folders
medias.writeUpload, rename, move, and delete files and folders

​
Quick start

List files and folders in a location’s media library: 
curl -X GET "https://services.leadconnectorhq.com/medias/files?altType=location&altId=sx6wyHhbFdRXh302LLNR&sortBy=createdAt&sortOrder=asc" \
  -H "Authorization: Bearer <access_token>"

​
Endpoints

MethodPathDescription
GET/medias/filesGet List of Files / Folders
POST/medias/upload-fileUpload File into Media Storage
POST/medias/folderCreate Folder
POST/medias/{id}Update File / Folder
DELETE/medias/{id}Delete File or Folder
PUT/medias/update-filesBulk Update Files / Folders
PUT/medias/delete-filesBulk Delete / Trash Files or Folders
Last modified on March 4, 2026