Skip to content

Command-line client

There is no binary to install. Everything the service does is one HTTP call, so curl is a complete client. Set a token from the console and a zone host:

export VELRAVIO_TOKEN=vrv_your_token
export VELRAVIO_HOST=https://fra.velravio.com

Upload

curl -X PUT -H "Authorization: Bearer $VELRAVIO_TOKEN" \
  -H "Content-Type: application/pdf" \
  --data-binary @report.pdf \
  "$VELRAVIO_HOST/api/v1/files?name=report.pdf"
curl -H "Authorization: Bearer $VELRAVIO_TOKEN" \
  "$VELRAVIO_HOST/api/v1/files?q=report&sort=created&order=desc"

Download and verify

curl -L -H "Authorization: Bearer $VELRAVIO_TOKEN" \
  -o report.pdf "$VELRAVIO_HOST/api/v1/files/FILE_ID/content"
sha256sum report.pdf   # compare with the sha256 from the metadata

Share

curl -X POST -H "Authorization: Bearer $VELRAVIO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"file_id":"FILE_ID","ttl":"7d","access_code":"1234"}' \
  "$VELRAVIO_HOST/api/v1/shares"

Export the whole account

curl -H "Authorization: Bearer $VELRAVIO_TOKEN" \
  -o velravio-export.zip "$VELRAVIO_HOST/api/v1/export"

A small Python client that wraps these is on the roadmap for a 1.0 in December 2026. Until then, the commands above are the whole interface.