# Copy a file

This function copies a file or directory to a new location and preserves the source permissions and modification time. If the destination is an existing directory, the source is copied into it. The function returns an error if the destination already exists.

Important:

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

Endpoint: GET /Fileman/copy_file
Version: 11.138.0.19
Security: BasicAuth

## Query parameters:

  - `destination` (string, required)
    The path to copy the source to.
    Example: "public_html/backup/file.txt"

  - `source` (string, required)
    The path to the file or directory to copy.
    Example: "public_html/file.txt"

## Response 200 fields (application/json):

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

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

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

  - `result` (object)

  - `result.data` (object)

  - `result.data.src` (string)
    The resolved source path.

  - `result.data.dest` (string)
    The resolved destination path.

  - `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.