# Create

Launch stage: GA

`PUT /api/2.0/fs/files{file_path}`

Uploads a file of up to 5 GiB. The file contents should be sent as the request body as
 raw bytes (an octet stream); do not encode or otherwise modify the bytes before sending.
 The contents of the resulting file will be exactly the bytes sent in the request body.
 If the request is successful, there is no response body.

API scopes: files

## Path parameters

- `file_path` (string, optional)
  The absolute path of the file.

## Query parameters

- `overwrite` (boolean, optional)
  If true or unspecified, an existing file will be overwritten. If false, an error will be returned if the path points to an existing file.

## Request body

- `contents` (string, optional)

## Response

```json
{}
```