feat(files): document CLI uploads

Document Bearer-authenticated multipart uploads with curl and Wget2. Return 413 for oversized multipart bodies and report attachment size limits accurately.

internal/api/server.go

@@ -292,7 +292,11 @@ func mapStoreErrorFor(w http.ResponseWriter, err error, resource string) {
 	case errors.Is(err, store.ErrInvalid):
 		writeError(w, http.StatusBadRequest, err.Error())
 	case errors.Is(err, store.ErrTooLarge):
-		writeError(w, http.StatusRequestEntityTooLarge, "conteúdo excede 2 MiB")
+		if resource == "arquivo" {
+			writeError(w, http.StatusRequestEntityTooLarge, "arquivo excede 64 MiB ou a quota total de anexos excede 2 GiB")
+		} else {
+			writeError(w, http.StatusRequestEntityTooLarge, "conteúdo excede 2 MiB")
+		}
 	case errors.Is(err, store.ErrUnchanged):
 		writeError(w, http.StatusConflict, "o conteúdo dessa revisão já está ativo")
 	default: