Delete Folder

​

Path Parameters

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