# File Restoration

cPanel Account Backups / File Restoration

## Restore databases

 - [POST /Backup/restore_databases](https://api.docs.cpanel.net/specifications/cpanel.openapi/file-restoration/restore_databases.md): This function restores a database's backup files.



When the MySQL Client role is disabled, the system also  this function.



You  pass either the    parameter.

## Restore email filters

 - [POST /Backup/restore_email_filters](https://api.docs.cpanel.net/specifications/cpanel.openapi/file-restoration/restore_email_filters.md): This function restores an account's email filters.



When the Receive Mail role is disabled, the system also  this function.



You  use the  parameter when you call this function in one of the following formats:
* As part of a  request body to upload and restore a backup file to the server.
* As a query parameter to restore an existing file on the server.

## Restore email forwarders

 - [POST /Backup/restore_email_forwarders](https://api.docs.cpanel.net/specifications/cpanel.openapi/file-restoration/restore_email_forwarders.md): This function restores an account's email forwarders.



When the Receive Mail role is disabled, the system also  this function.



You  use the  parameter when you call this function in one of the following formats:
* As part of a  request body to upload and restore a backup file to the server. For more information about this structure, read Mozilla's POST Method documentation.
* As a query parameter to restore an existing file on the server.

## Restore files

 - [POST /Backup/restore_files](https://api.docs.cpanel.net/specifications/cpanel.openapi/file-restoration/restore_files.md): This function restores an account's files.



When the File Storage role is disabled, the system also  this function.



You  use the  parameter when you call this function in one of the following formats:
* As part of a  request body to upload and restore a backup file to the server. For more information about this structure, read Mozilla's POST Method documentation.
* As a query parameter to restore an existing file on the server.

## Return backups in home directory

 - [GET /Restore/directory_listing](https://api.docs.cpanel.net/specifications/cpanel.openapi/file-restoration/directory_listing.md): This function lists all of the backup files and directories in the user's home directory.



When you disable the File Storage role, the system  this function.

## Return cPanel accounts with backup metadata

 - [GET /Restore/get_users](https://api.docs.cpanel.net/specifications/cpanel.openapi/file-restoration/get_users.md): This function lists a reseller's users that have existing backup metadata.



When you disable the File Storage role, the system  this function.

## Return backup storage locations

 - [GET /Restore/query_file_info](https://api.docs.cpanel.net/specifications/cpanel.openapi/file-restoration/query_file_info.md): This function lists all of an item's backup locations. An item can be a file, a directory, or a symlink.



When you disable the File Storage role, the system  this function.

## Restore file or directory

 - [GET /Restore/restore_file](https://api.docs.cpanel.net/specifications/cpanel.openapi/file-restoration/restore_file.md): This function restores a file or directory from a backup to the file or directory's original location.



When you disable the File Storage role, the system  this function.