From c02489f56cda3b30759a7db52d2af739dca686de Mon Sep 17 00:00:00 2001
From: lgcosta <me@luizgustavo.pro.br>
Date: Fri, 6 Nov 2026 08:40:24 -0300
Subject: [PATCH] docs(files): add curl stdin upload example

---
 UPLOAD-CLI.md | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/UPLOAD-CLI.md b/UPLOAD-CLI.md
index 580afb5..0f8a267 100644
--- a/UPLOAD-CLI.md
+++ b/UPLOAD-CLI.md
@@ -22,7 +22,17 @@ Não inclua `/api` em `NOTAS_URL`.
 
 ## `curl` — caminho recomendado
 
-O `curl` monta o multipart e envia o arquivo sem precisar construir o corpo à mão:
+Upload em uma linha, lendo o arquivo pelo `stdin`:
+
+```sh
+cat arquivo.tar.gz | curl --fail-with-body --show-error --silent -X POST "https://notas.labexposed.com/api/files/upload" -H "Authorization: Bearer $NOTES_TOKEN" -F "file=@-;filename=arquivo.tar.gz"
+```
+
+`@-` diz ao `curl` para ler o conteúdo de `stdin`; `filename=...` define o nome
+armazenado pelo gerenciador. Defina `NOTES_TOKEN` com o token do servidor. O
+`curl -F` monta o multipart exigido pelo endpoint.
+
+Também é possível apontar o arquivo diretamente, sem pipe:
 
 ```sh
 curl --fail-with-body --show-error --silent \