# Upscale Download Webhook

## Explanation

If you've already generated an image and want to obtain a higher-resolution version, you can request an upscaled image through this endpoint. After your request is processed, the upscaled image will be sent to your specified webhook URL. The upscaled image link will be included in the response under the field **"upscaled\_image\_src"**.

The process consists of two steps:

1. **Initiate the request** to upscale the image.
2. **Retrieve the image** via the webhook notification.

## Initiate the Request

***

<mark style="color:green;">**`POST`**</mark>**`https://api.aihomedesign.com`/v1/order/image/**<mark style="color:red;">**{generated\_image\_id}**</mark>**/download/upscale**

{% hint style="info" %}
**Where can I get the generated\_image\_id?**

The generated images for an order can be accessed via the [**Get Order Details**](https://doc.aihomedesign.com/api-endpoints/get-order-details) endpoint.
{% endhint %}

## Request Body

The request body is **not required** for this endpoint and should be left **empty**.

## Headers

<table><thead><tr><th>Key</th><th>Value</th><th data-hidden></th></tr></thead><tbody><tr><td>x-api-key<mark style="color:red;">*</mark></td><td>{your_api_key_here}</td><td></td></tr></tbody></table>

## Response

{% tabs %}
{% tab title="200: OK" %}

```json
{ 
    status : "processing" 
}
```

{% endtab %}
{% endtabs %}

***

## Get Image via Webhook&#x20;

After submitting the request, our system will process the image and send you a **webhook notification** to the URL you’ve specified in your dashboard. This notification will let you know when the upscaled image is ready and provide a link to download it, also you can identify the webhook request by the field named `generated_image_id,`which is the id of the image you've requested upscale for.

## Request Body

```json
{
   "generated_image_id": "SAMPLE-UUID",
   "upscaled_image_src" : "SAMPLE-DOWNLOAD-LINK",
   "user_id":"SAMPLE-UUID"
}
```