> ## Documentation Index
> Fetch the complete documentation index at: https://docs.genviral.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Folders

> Organize partner-scoped files and slideshows in nested folders

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](/api-reference/list-folders) |
| Create folder | `POST /api/partner/v1/folders` | [Create Folder](/api-reference/create-folder) |
| Get folder | `GET /api/partner/v1/folders/{folderId}` | [Get Folder](/api-reference/get-folder) |
| Move folder | `PATCH /api/partner/v1/folders/{folderId}` | [Move Folder](/api-reference/move-folder) |
| Delete folder | `DELETE /api/partner/v1/folders/{folderId}` | [Delete Folder](/api-reference/delete-folder) |
| List folder ancestors | `GET /api/partner/v1/folders/{folderId}/ancestors` | [List Folder Ancestors](/api-reference/list-folder-ancestors) |
| List folder items | `GET /api/partner/v1/folders/{folderId}/items` | [List Folder Items](/api-reference/list-folder-items) |
| Add folder items | `POST /api/partner/v1/folders/{folderId}/items` | [Add Folder Items](/api-reference/add-folder-items) |
| Remove folder items | `DELETE /api/partner/v1/folders/{folderId}/items` | [Remove Folder Items](/api-reference/remove-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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.