Folders - Genviral

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

Endpoints

Operation	Endpoint	Reference
List folders	`GET /api/partner/v1/folders`	List Folders
Create folder	`POST /api/partner/v1/folders`	Create Folder
Get folder	`GET /api/partner/v1/folders/{folderId}`	Get Folder
Move folder	`PATCH /api/partner/v1/folders/{folderId}`	Move Folder
Delete folder	`DELETE /api/partner/v1/folders/{folderId}`	Delete Folder
List folder ancestors	`GET /api/partner/v1/folders/{folderId}/ancestors`	List Folder Ancestors
List folder items	`GET /api/partner/v1/folders/{folderId}/items`	List Folder Items
Add folder items	`POST /api/partner/v1/folders/{folderId}/items`	Add Folder Items
Remove folder items	`DELETE /api/partner/v1/folders/{folderId}/items`	Remove Folder Items

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.