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 folderGET /api/partner/v1/folders/{folderId}Get Folder
Move folderPATCH /api/partner/v1/folders/{folderId}Move Folder
Delete folderDELETE /api/partner/v1/folders/{folderId}Delete Folder
List folder ancestorsGET /api/partner/v1/folders/{folderId}/ancestorsList Folder Ancestors
List folder itemsGET /api/partner/v1/folders/{folderId}/itemsList Folder Items
Add folder itemsPOST /api/partner/v1/folders/{folderId}/itemsAdd Folder Items
Remove folder itemsDELETE /api/partner/v1/folders/{folderId}/itemsRemove 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.