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

# Gerar download

> Gere um link temporário para baixar um arquivo armazenado.

Gera um link temporário para baixar um arquivo do armazenamento.

O link retornado é assinado, temporário e deve ser usado apenas pelo consumidor autorizado.

<ResponseExample>
  ```json 200 theme={null}
  {
    "code": 200,
    "message": "Link de download gerado.",
    "result": {
      "url": "https://s3.amazonaws.com/exemplo-assinado",
      "file_name": "contrato.pdf",
      "file": {
        "id": "9fcb573b-7f62-4774-978b-07e89dfef5f2",
        "type": "file",
        "name": "contrato.pdf",
        "parent_id": null,
        "extension": "pdf",
        "content_type": "application/pdf",
        "size": 24576,
        "status": "uploaded",
        "uploaded_at": "2026-06-22T12:00:00+00:00",
        "created_at": "2026-06-22T11:59:40+00:00",
        "updated_at": "2026-06-22T12:00:00+00:00"
      }
    }
  }
  ```

  ```json 404 theme={null}
  {
    "code": 404,
    "message": "Arquivo não localizado."
  }
  ```
</ResponseExample>

## Parâmetros

<ParamField path="file_id" type="string" required>
  ID do arquivo.
</ParamField>

## Resposta

| Campo       | Tipo     | Descrição                      |
| ----------- | -------- | ------------------------------ |
| `url`       | `string` | Link temporário para download. |
| `file_name` | `string` | Nome sugerido do arquivo.      |
| `file`      | `object` | Metadados do arquivo.          |

<Warning>
  Não armazene links temporários como referência permanente. Gere um novo link sempre que precisar baixar o arquivo.
</Warning>