Delete a folder, or a search folder, and what is in it. It does not go to Deleted Items; to put a folder there, move it with mail_folders_move. mail_folders_permanent_delete purges it.
The folder ID, or a well-known folder name. Well-known names work regardless of the locale of the user’s mailbox: archive, clutter, conflicts, conversationhistory, deleteditems, drafts, inbox, junkemail, localfailures, msgfolderroot, outbox, recoverableitemsdeletions, scheduled, searchfolders, sentitems, serverfailures, syncissues.