# Restore file or directory

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.

Endpoint: GET /Restore/restore_file
Version: 11.134.0.5
Security: BasicAuth

## Query parameters:

  - `backupID` (any, required)
    The backup's identification.

*  — Restore a daily backup from the specified backup date.
*  — Restore a daily incremental backup.
*  — Restore a weekly backup from the specified backup date.
*  — Restore a monthly backup from the specified backup date.
*  — Restore a weekly incremental backup.
*  — Restore a monthly incremental backup.
    Example: "weekly/2017-07-03"

  - `overwrite` (integer, required)
    Whether to overwrite the file or directory on the disc with its backup replacement.

*  — Overwrite the file or directory.
*  — Do  overwrite the file or directory.
    Enum: 1, 0

  - `path` (string, required)
    The absolute file or directory's path, within a backup, that you wish to restore.



* The value of this parameter  begin with a forward slash (/).
* You  parse filenames properly to prevent a cross-site scripting (XSS) attack.
    Example: "/public_html/index.php"

## Response 200 fields (application/json):

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

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

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

  - `result` (object)

  - `result.data` (object)
    An object containing the status of the operation.

  - `result.data.success` (integer)
    Whether the  parameter succeeded.

*  — Success.
*  — Failure.
    Enum: 1, 0

  - `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)
    - 1 - Success
- 0 - 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.