> ## Documentation Index
> Fetch the complete documentation index at: https://docs.specterops.io/llms.txt
> Use this file to discover all available pages before exploring further.

# upload

> Upload a file to the target machine by selecting a file from your computer.

## Summary

Upload a file to the target machine by selecting a file from your computer.

* Needs Admin: False
* Version: 1
* Author: @its\_a\_feature\_

### Arguments

#### file

* Description: file to upload
* Required Value: True
* Default Value: None

#### remote\_path

* Description: /remote/path/on/victim.txt
* Required Value: True
* Default Value: None

## Usage

```
upload
```

## MITRE ATT\&CK Mapping

* T1132
* T1030
* T1105

## Detailed Summary

This function uses API calls to chunk and transfer a file down from Mythic to the agent, then uses API calls to write the file out to disk:

```javascript theme={null}
if(typeof data == "string"){
    data = convert_to_nsdata(data);
}
if (data.writeToFileAtomically($(file_path), true)){
    return "file written";
}
```

After successfully writing the file to disk, the agent will report back the final full path so that it can be tracked within the UI.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.