# Shared content: Upload file

Information note**LOCKED.**   
  
This API is extremely reliable and will not be broken unless absolutely necessary.

## Method

POST

## Path

/qrs/sharedcontent/{id}/uploadfile?externalpath={externalpath}

## Description

Upload a file to a shared content entity, identified by `{id}`. The file is saved as the name specified by the `externalpath` parameter (for example, `my/file/path/example.png`). Include the `Content-Type` header that corresponds to the type of file you are uploading. If a file with the same `externalpath` already exists it will be automatically overwritten.

When you upload a file to a shared content entity, QRS generates a child `StaticContentReference` entity that contains the mapping between the external path and the physical file in the repository. To retrieve a file from the shared content entity identified by `{id}`, make a request of the following format:

```
GET qrs/sharedcontent/{id}/my/file/path/example.png
```

You must have update access to the shared content entity to upload files to it.

## Body

File contents (as binary).

## Return value

The external path to the uploaded content (for example, `"my/file/path/example.png"`).

## Optional parameters

-