# Restore files

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.

Endpoint: POST /Backup/restore_files
Version: 11.134.0.5
Security: BasicAuth

## Query parameters:

  - `backup` (string)
    The backup file to restore.



 pass this parameter to restore backup files that already exist on the server.



To restore multiple backup files, increment the parameter name. For example: , , and .

  - `directory` (string)
    The directory to which to restore the file. The default is the user's  directory.
    Example: "/home/user/example"

  - `timeout` (integer)
    The maximum number of seconds to try to restore the file.
*  - The system will not time out the file restoration.
    Example: 7200

  - `verbose` (integer)
    Whether to return additional information from the  log files.
*  - Return additional information.
*  - Do not return additional information.
    Enum: 0, 1

## Request fields (multipart/form-data):

  - `backup` (string)

## Response 200 fields (application/json):

  - `apiversion` (integer)
    The version of the API.
    Example: 3

  - `func` (string)
    The name of the method called.
    Example: "restore_files"

  - `module` (string)
    The name of the module called.
    Example: "Backup"

  - `result` (object)

  - `result.data` (object)

  - `result.data.log_id` (string)
    The log file's restoration identification (ID). The system uses the backup restoration's date to create this ID. The ID is in [ISO-8601 Date Time](https://en.wikipedia.org/wiki/ISO_8601) format with the log's revision number appended.
    Example: "2019-08-13T15:10:07Z.1"

  - `result.data.log_path` (string)
    The filepath to the backup restoration's log file.
    Example: "/home/cptest/.cpanel/logs/restorefiles/2019-08-13T15:10:07Z.1.log"

  - `result.data.messages` (array)
    An array of statements about the database's restoration.
    Example: ["The system successfully restored the directory /home/cpuser/point2 from the backup file backup-cpuser.tld-9-10-2019_1.tar.gz"]

  - `result.errors` (array,null)
    List of errors if the API failed.

  - `result.messages` (array,null)
    List of messages generated by the API.

  - `result.metadata` (object)

  - `result.status` (integer)
    *  - Success
*  - Failed: Check the errors field for more details.
    Enum: 0, 1

  - `result.warnings` (array,null)
    List of warnings generated by the API. Warnings describe non-critical failures or other problematic conditions noted while running a API.