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

# Upload e download

> Envie conteúdo direto e confirme sua disponibilidade.

**1. Reserve o envio**

Envie `POST /v1/assets/files` com título e nome do arquivo, ou `POST /v1/assets/videos` com título. A resposta já contém o asset e sua variante, além de `upload.url`, `upload.method` e `upload.expires_at`.

**2. Envie os bytes**

Faça o upload diretamente para `upload.url`, usando o método informado. Essa URL é uma credencial temporária: não a publique nem registre em logs. `expires_at` pode ser `null` quando não houver um prazo informado.

**3. Confirme**

Chame `POST /v1/assets/{id}/confirm` com `{}`. A Hubfy verifica o envio. Arquivos prontos podem ser baixados; vídeos podem continuar em processamento.

**4. Acompanhe**

Consulte `GET /v1/assets/{id}` ou receba `asset.updated`. Os estados são `uploading`, `processing`, `ready` e `failed`. Um item excluído deixa de aparecer nas consultas normais.

## Download de arquivo privado

Use `GET /v1/assets/{id}/download` para um arquivo pronto. A resposta contém uma URL assinada com validade de uma hora. Solicite outra URL quando precisar renovar o acesso.

## Excluir conteúdo

`DELETE /v1/assets/{id}` registra a remoção e sua limpeza externa. A Hubfy repete a limpeza quando houver uma falha temporária.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.