curl --request DELETE \
--url https://www.genviral.io/api/partner/v1/folders/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Folder deleted",
"data": {
"id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
"deleted": true
}
}
Folders
Delete Folder
Delete a folder in the authenticated key scope
DELETE
/
api
/
partner
/
v1
/
folders
/
{folderId}
curl --request DELETE \
--url https://www.genviral.io/api/partner/v1/folders/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Folder deleted",
"data": {
"id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
"deleted": true
}
}
Permanently deletes a folder. Nested children and folder items are removed by database cascade.
Path Parameters
string
required
Folder UUID.
curl --request DELETE \
--url https://www.genviral.io/api/partner/v1/folders/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Folder deleted",
"data": {
"id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
"deleted": true
}
}
Error Responses
400 missing_folder_id- missing route parameter422 invalid_path-folderIdis not a valid UUID404 not_found- folder not visible in key scope401- 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_delete_failed- unexpected failure