> ## Documentation Index
> Fetch the complete documentation index at: https://docs.viggle.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Download Render

> Download the finished video of a ready Render.

`GET /v1/renders/{render_id}/download` redirects to the finished output. The Render must be `ready`.

## Request parameters

| Parameter   | Type   | Required | Description                                    |
| ----------- | ------ | :------: | ---------------------------------------------- |
| `render_id` | string |    Yes   | Full ready Render ID beginning with `render_`. |

## Response parameters

Returns `302 Found` with a `Location` header pointing to the video. Follow redirects to receive the video bytes.

| Field      | Type   | Always present | Description                           |
| ---------- | ------ | :------------: | ------------------------------------- |
| `Location` | string | Yes on success | Redirect URL for the completed video. |

## Examples

<CodeGroup>
  ```go Go theme={null}
  req,_:=http.NewRequest("GET","https://apis.viggle.ai/v1/renders/render_789ghi/download",nil); req.Header.Set("Authorization","Bearer "+os.Getenv("VIGGLE_API_KEY")); resp,err:=http.DefaultClient.Do(req); if err!=nil { panic(err) }; defer resp.Body.Close(); output,_:=os.Create("output.mp4"); defer output.Close(); io.Copy(output,resp.Body)
  ```

  ```javascript JavaScript theme={null}
  const response=await fetch("https://apis.viggle.ai/v1/renders/render_789ghi/download",{headers:{Authorization:`Bearer ${process.env.VIGGLE_API_KEY}`}}); const video=await response.blob();
  ```

  ```python Python theme={null}
  import os, requests
  response=requests.get("https://apis.viggle.ai/v1/renders/render_789ghi/download",headers={"Authorization":f"Bearer {os.environ['VIGGLE_API_KEY']}"}); response.raise_for_status(); open("output.mp4","wb").write(response.content)
  ```

  ```bash cURL theme={null}
  curl -L "https://apis.viggle.ai/v1/renders/render_789ghi/download" -H "Authorization: Bearer $VIGGLE_API_KEY" -o output.mp4
  ```
</CodeGroup>


## OpenAPI

````yaml GET /v1/renders/{render_id}/download
openapi: 3.0.3
info:
  title: Viggle API
  description: Generate AI-powered character animation videos
  version: 2.0.0
  contact:
    name: Viggle Support
    url: https://viggle.ai
servers:
  - url: https://apis.viggle.ai
    description: Production server
security: []
paths:
  /v1/renders/{render_id}/download:
    get:
      summary: Download Render
      operationId: v1DownloadRender
      responses:
        '302':
          description: Redirect

````