curl --request POST \
--url https://www.genviral.io/api/partner/v1/folders \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "March Campaign",
"media_type": "upload",
"parent_folder_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
}'
{
"ok": true,
"code": 201,
"message": "Folder created",
"data": {
"id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
"name": "March Campaign",
"media_type": "upload",
"parent_folder_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
"file_count": 0,
"subfolder_count": 0,
"preview_files": []
}
}
Folders
Create Folder
Create a folder in the authenticated key scope
POST
/
api
/
partner
/
v1
/
folders
curl --request POST \
--url https://www.genviral.io/api/partner/v1/folders \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "March Campaign",
"media_type": "upload",
"parent_folder_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
}'
{
"ok": true,
"code": 201,
"message": "Folder created",
"data": {
"id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
"name": "March Campaign",
"media_type": "upload",
"parent_folder_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
"file_count": 0,
"subfolder_count": 0,
"preview_files": []
}
}
Creates a folder for one media type. Use
parent_folder_id to create nested folders.
Body Parameters
string
required
Folder name (
1-255 chars).string
required
Folder media type:
ai_image, ai_video, upload, or slideshow.string
Optional parent folder ID for nesting.
curl --request POST \
--url https://www.genviral.io/api/partner/v1/folders \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "March Campaign",
"media_type": "upload",
"parent_folder_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
}'
{
"ok": true,
"code": 201,
"message": "Folder created",
"data": {
"id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
"name": "March Campaign",
"media_type": "upload",
"parent_folder_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
"file_count": 0,
"subfolder_count": 0,
"preview_files": []
}
}
Error Responses
400 invalid_json- malformed JSON body404 parent_folder_not_found-parent_folder_idnot visible in key scope409 folder_name_conflict- duplicate folder name at destination422 invalid_payload- body validation failed500 folder_create_failed- unexpected create failure
