Skip to main content
Use folders to group partner files (ai_image, ai_video, upload) and slideshows (slideshow) in the authenticated key scope.

​
Endpoints

OperationEndpointReference
List foldersGET /api/partner/v1/foldersList Folders
Create folderPOST /api/partner/v1/foldersCreate Folder
Get / move / delete folderGET/PATCH/DELETE /api/partner/v1/folders/{folderId}Manage Folder
List folder ancestorsGET /api/partner/v1/folders/{folderId}/ancestorsList Folder Ancestors
List / add / remove folder itemsGET/POST/DELETE /api/partner/v1/folders/{folderId}/itemsManage Folder Items

​
Notes

  • Folder visibility is always scope-safe:
    • workspace key -> only that workspace
    • personal key -> only personal rows (workspace_id = null)
  • slideshow folders accept slideshow IDs.
  • ai_image, ai_video, and upload folders accept file IDs.