---
title: "Get a short-lived signed download URL for a finished render"
method: GET
path: "/renders/{render}/download"
tags: ["Renders"]
---

# Get a short-lived signed download URL for a finished render

`GET /renders/{render}/download`

## Request

- Base URL: `https://api.getfacade.ai/api/v1`
- URL: `https://api.getfacade.ai/api/v1/renders/{render}/download`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.getfacade.ai/oauth/authorize`, token URL `https://api.getfacade.ai/oauth/token`, scopes: `agent`)

For saving the file, not for sharing it: the URL is signed, carries a filename and
expires in minutes. The link to give a person is the render's own `file_url`, which is
public and permanent.

## Path parameters

- `render` string, required

## Response `200`

A JSON:API document

- object
  - `data` Resource: JSON:API resource. `id` is a top-level field, never inside `attributes`.
    - `type` string, required
    - `id` string, required
    - `attributes` object
    - `relationships` object

## Other responses

- `429`: Rate limited on this key's own bucket, separate from the human sessions of the same account. Refusal is deliberately cheap: back off, do not retry in a tight loop.

---

[API](https://skmtc.dev/getfacade/apis/getfacade-agent-api.md) · [All operations](https://skmtc.dev/getfacade/apis/getfacade-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getfacade/apis/getfacade-agent-api/revisions/2b52eda7362c?raw)