curl --request PATCH \
--url https://www.genviral.io/api/partner/v1/folders/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"parent_folder_id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"
}'
{
"ok": true,
"code": 200,
"message": "Folder updated",
"data": {
"id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
"name": "Product Shots",
"media_type": "upload",
"parent_folder_id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
"path": "/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
"file_count": 12,
"subfolder_count": 2,
"preview_files": [],
"created_at": "2026-03-01T09:00:00.000Z",
"updated_at": "2026-03-01T10:00:00.000Z"
}
}
Folders
Move Folder
Move a folder to a new parent or to the root level
PATCH
/
api
/
partner
/
v1
/
folders
/
{folderId}
curl --request PATCH \
--url https://www.genviral.io/api/partner/v1/folders/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"parent_folder_id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"
}'
{
"ok": true,
"code": 200,
"message": "Folder updated",
"data": {
"id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
"name": "Product Shots",
"media_type": "upload",
"parent_folder_id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
"path": "/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
"file_count": 12,
"subfolder_count": 2,
"preview_files": [],
"created_at": "2026-03-01T09:00:00.000Z",
"updated_at": "2026-03-01T10:00:00.000Z"
}
}
Reparents a folder. This endpoint only moves folders; it does not rename them.
Path Parameters
string
required
Folder UUID.
Body Parameters
string | null
required
Destination parent folder ID. Send
null to move the folder to the root level.curl --request PATCH \
--url https://www.genviral.io/api/partner/v1/folders/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"parent_folder_id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"
}'
{
"ok": true,
"code": 200,
"message": "Folder updated",
"data": {
"id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
"name": "Product Shots",
"media_type": "upload",
"parent_folder_id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
"path": "/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
"file_count": 12,
"subfolder_count": 2,
"preview_files": [],
"created_at": "2026-03-01T09:00:00.000Z",
"updated_at": "2026-03-01T10:00:00.000Z"
}
}
Error Responses
400 invalid_json- malformed JSON body422 invalid_path-folderIdis not a valid UUID422 invalid_payload- missing or invalidparent_folder_id404 not_found- folder or parent folder not visible in key scope409 folder_move_conflict- invalid move (self, descendant, or destination name conflict)401- authentication failed (missing/invalid/revoked token)402 subscription_required- active Creator/Professional/Business plan required403 tier_not_allowed- Scheduler tier cannot use Partner API500 folder_update_failed- unexpected failure
