> ## 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.