---
sidebar_position: 1
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# Upload file
 Upload single file to Neocities



`Function UploadFile(Val Token, Val Path, Val Data) Export`

  | Parameter | CLI option | Type | Required | Description |
  |-|-|-|-|-|
  | Token | --token | String | ✔ | Auth token |
  | Path | --path | String | ✔ | File path on Neocities |
  | Data | --file | String, BinaryData | ✔ | URL, path or file data |

  
  Returns:  Map Of KeyAndValue - serialized JSON response from Neocities

<br/>

:::tip
Neocities API docs: [neocities.org/api](https://neocities.org/api)

Parameters with Binary data type can also accept file paths on disk and URLs
:::
<br/>



```bsl title="1C:Enterprise/OneScript code example"
    Token = "7419cd51de4037f7...";
    Data  = "https://api.athenaeum.digital/test_data/picture.jpg"; // URL, Path or Binary Data
    Path  = "testfolder/test_pic.png";

    Result = OPI_Neocities.UploadFile(Token, Path, Data);
```
 

 <Tabs>
  
    <TabItem value="bash" label="Bash" default>
        ```bash
            oint neocities UploadFile \
             --token "***" \
             --path "testfolder/test_pic.png" \
             --file "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/picture.jpg"
        ```
    </TabItem>
  
    <TabItem value="bat" label="CMD/Bat" default>
        ```batch
            oint neocities UploadFile ^
             --token "***" ^
             --path "testfolder/test_pic.png" ^
             --file "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/picture.jpg"
        ```
    </TabItem>
</Tabs>


```json title="Result"
{
 "result": "success",
 "message": "your file(s) have been successfully uploaded"
}
```