# Agilize Docs para IA - Página atual

Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize.
Use esta versão quando a pergunta do usuário estiver restrita ao documento atual.

Última geração: 2026-05-27T06:57:02.556Z

## Página

- Título: Documento - Resolver URL final de download
- URL humana: https://agilize.app/docs/desenvolvedores/api/file-upload/url/get-file-upload-url
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Documento - Resolver URL final de download

## Seções

- Método e URL
- Autenticação
- Parâmetros
- Corpo da requisição

## Contexto técnico

- OpenAPI JSON atual: https://agilize.app/api/docs/openapi/agilize
- Referência interativa da API: https://agilize.app/docs/desenvolvedores/referencia-api
- Autenticação principal: header x-api-key
- Versão da API: 0.0.12

## Conteúdo da página

Retorna a URL final de download para um documento do serviço `file/upload`. Quando o arquivo está em storage externo, a resposta já devolve a URL assinada. Quando o arquivo ainda está local, a resposta devolve a rota autenticada `/file/upload/download`.

## Método e URL

```http
GET https://api.agilize.app/file/upload/url
```

## Autenticação

Envie a chave de API no cabeçalho da requisição.

```http
Accept: application/json
x-api-key: SUA_CHAVE_API
```

## Parâmetros

| Nome | Origem | Obrigatório | Tipo | Descrição |
| --- | --- | --- | --- | --- |
| x-api-key | header | Sim | string | Chave da API de integração gerada em seu painel gerencial. |
| id | query | Sim | string | Identificador do documento em `file/upload`. |
| view | query | Não | boolean | Quando `true`, tenta entregar o arquivo em modo inline. |

## Corpo da requisição

Este método não declara corpo de requisição no OpenAPI local.

## Respostas

| Status | Descrição | Conteúdo |
| --- | --- | --- |
| 200 | URL resolvida com sucesso. | application/json |
| 400 | Parâmetros inválidos. |  |
| 401 | API key ausente ou inválida. |  |
| 404 | Arquivo não encontrado ou sem acesso. |  |

## Testar requisição

Preencha os parâmetros, informe a chave no cabeçalho `x-api-key` e envie a requisição diretamente pelo navegador.