Skip to main content
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

​
folderId
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 parameter
  • 422 invalid_path - folderId is not a valid UUID
  • 404 not_found - folder not visible in key scope
  • 401 - authentication failed (missing/invalid/revoked token)
  • 402 subscription_required - active Creator/Professional/Business plan required
  • 403 tier_not_allowed - Scheduler tier cannot use Partner API
  • 500 folder_delete_failed - unexpected failure