# Anexos

Fonte: https://wire.ia.br/documentation/api/anexos

> Enviar imagens e arquivos que fazem parte das notas.



```http
POST /vaults/{cofre}/files?name={arquivo.ext}
Content-Type: image/png
(corpo: os bytes do arquivo)
```

O arquivo vai para a pasta **Anexos** do cofre, no Google Drive da pessoa. A resposta traz o Markdown pronto para pôr numa página:

```json
{ "ref": "a3f9c21b7e-grafico.png", "markdown": "![grafico.png](Anexos/a3f9c21b7e-grafico.png)" }
```

Imagens voltam como `![nome](Anexos/ref)`. Outros arquivos voltam como link `[📎 nome](Anexos/ref)`.

## Exemplo [#exemplo]

```bash
curl -X POST "https://wire.ia.br/api/v1/vaults/principal/files?name=grafico.png" \
  -H "Authorization: Bearer $PAPER_TOKEN" \
  -H "X-Paper-Account: $PAPER_CONTA" \
  -H "Content-Type: image/png" \
  --data-binary @grafico.png
```

Depois, acrescente o Markdown numa página:

```bash
curl -X PATCH "https://wire.ia.br/api/v1/vaults/principal/pages/pa1k2m3n4o5p" \
  -H "Authorization: Bearer $PAPER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"append": "![grafico.png](Anexos/a3f9c21b7e-grafico.png)"}'
```

## Regras [#regras]

| Regra          | Valor                                                          |
| -------------- | -------------------------------------------------------------- |
| Permissão      | Token normal com "Enviar arquivos" e **Ler e editar** no cofre |
| Tamanho máximo | 10 MB por arquivo                                              |
| Quantidade     | 30 envios por dia, por token                                   |
| Cópias para IA | Não recebem arquivos                                           |

## Para que serve, e para que não serve [#para-que-serve-e-para-que-não-serve]

Anexos existem para as notas da pessoa: a foto do quadro da reunião, o PDF que a página comenta, o gráfico que um script gerou para um relatório.

Não use o Paper para hospedar imagens ou arquivos que outros sites, apps ou pessoas vão baixar. Isso inclui usar links publicados como CDN. Abuso de hospedagem leva a banimento permanente. Veja [Uso justo](/termos/uso-justo).

Hospedagem de imagens na nuvem para o plano pago é um recurso futuro e ainda não existe.
