Skip to content

Sending Files

This page shows the full process for sending files using hxtransfer commands. You may also want to read more about the available commands, or how to configure the CLI. Working with existing transfers and sharing requests using the CLI involves using the ID field, read more about working with IDs.

Getting Started

Before you begin, ensure you have a working CLI installation by testing it with hxtransfer version, and that you have created an API key under your user account.

Authenticating

Ensure your shell environment has the HXTRANSFER_API_KEY variable set to the full API Key, and if you are using a different service from https://transfer.hexiosec.com that you have also set HXTRANSFER_BASE_URL.

Test that you can sign in successfully:

text
$ hxtransfer auth

  ┌───────────────┬─────────────────────────┐
  │               │          Value          │
  ├───────────────┼─────────────────────────┤
  │ Authenticated │ true                    │
  ├───────────────┼─────────────────────────┤
  │ Email         │ [email protected]
  ├───────────────┼─────────────────────────┤
  │ Name          │ Your Name               │
  ├───────────────┼─────────────────────────┤
  │ User ID       │ XvOXgMS5thivsdfVOmyvvA  │
  └───────────────┴─────────────────────────┘

More info: hxtransfer auth

Sending Files

Multiple files can be sent in a single command by providing multiple paths:

$ hxtransfer send files ./Passport_Scan.pdf ./Bank_Statement.pdf

Link:         https://transfer.hexiosec.com/d/B_Bzvub9W6YLurcsdfk_Ig#l8sL8H9UQVCwL5Eha_FTsdfZhf17bh-1OpJ-OViQncY
Sharing code: D0ZR77FQ6ZNDUC2XUPWPYGJ9Z4ABWP2ZGFXA42MSDFY8J2UZHAEZWMPC5ZNXPW7XN7A97WEARJ2EWC

For larger files the upload process will show a progress bar, and the link & code will be available once the upload completes.

Either the Link or Sharing Code can be sent to your recipient. There is no difference in security between the two approaches, the link is more convenient however in some cases email systems have been known to corrupt parts of the link. Sharing Code can be used by pasting it into the home page.

Managing Sent Transfers

All sent files can be viewed in a list, with expiry information shown:

$ hxtransfer send list

  ┌────────────────────────┬─────────────────────────┬────────┬─────────────────────────────────────────────────────────┬─────┬───────┬─────────────────────────────────────────────────────────┐
  │           ID           │       Description       │  Size  │                         Created                         │ Max │ Count │                         Expires                         │
  ├────────────────────────┼─────────────────────────┼────────┼─────────────────────────────────────────────────────────┼─────┼───────┼─────────────────────────────────────────────────────────┤
  │ B_Bzvub9W6YLurcsdfk_Ig │ Secure Files 25/04/2025 │ 252476 │             April 25, 2025 at 8:53 AM GMT+1             │  5  │   0   │              May 2, 2025 at 8:53 AM GMT+1               │
  └────────────────────────┴─────────────────────────┴────────┴─────────────────────────────────────────────────────────┴─────┴───────┴─────────────────────────────────────────────────────────┘