> For the complete documentation index, see [llms.txt](https://shopifyinternship.gitbook.io/imagerepository/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://shopifyinternship.gitbook.io/imagerepository/images/uploading-images.md).

# Uploading Images

## Upload an image

<mark style="color:green;">`POST`</mark> `{{BASE_URL}}/v1/images/upload?`

The endpoint allows you upload an image. All public images are viewable by all users and are stored with `shopify_icon` watermarks, which are automatically removed when purchasing the image.

#### Query Parameters

| Name        | Type    | Description                                                                |
| ----------- | ------- | -------------------------------------------------------------------------- |
| permission  | string  | enums: \[`private`, `public`]                                              |
| price       | number  | selling price for an image                                                 |
| discount    | number  | <p>discount percentage for your image.<br><code>default 0</code></p>       |
| name        | string  | a unique name for your image                                               |
| metadata    | string  | separated with commas. `eg: car,yellow,etc`                                |
| description | string  | description about the image                                                |
| watermark   | boolean | <p>required when permission is private. <br>default <code>false</code></p> |

#### Headers

| Name          | Type   | Description               |
| ------------- | ------ | ------------------------- |
| Authorization | string | Bearer `{{ACCESS_TOKEN}}` |

{% tabs %}
{% tab title="201 " %}

```
{
    "success": true,
    "data": [
        {
            "price": 10000,
            "discount": 10,
            "permission": "private",
            "metadata": [
                "water",
                "tree",
                "falls"
            ],
            "_id": "600442eaff8b7<image_id>",
            "name": "testimage",
            "description": "imagemake",
            "imageStore": {
                "imageURL": "https://s3-bucket.us-east-2.amazonaws.com/s3.peg",
                "imageVersion": "McvljgpYI11",
                "eTag": "\"78a5427f3d828"\"
            },
            "createdAt": "2021-01-17T14:00:10.640Z",
            "updatedAt": "2021-01-17T14:00:10.640Z",
            "__v": 0
        }
    ]
}
```

{% endtab %}
{% endtabs %}