Automation

CLI

Install @dlvr/cli to upload files from your terminal with repeatable email flags, duration or fixed expiry dates, optional passwords, download limits, and JSON output.

Install

The command-line client ships as the public npm package @dlvr/cli and installs the dlvr executable.

Install globally

npm install -g @dlvr/cli
dlvr --help

Usage

Use flags for CI and scripted uploads. The CLI supports file path, repeatable or comma-separated notification emails, duration or fixed expiry date, password protection, max downloads, base URL override, and JSON output.

Fixed expiry dates must include an explicit timezone such as Z or +02:00.

Service-side upload policy

The current public service caps notification emails at 3 recipients, blocks audio uploads, and rejects anonymous video uploads at or above 700 MB.

Basic upload

dlvr \
  --file ./artifact.zip \
  --email team@example.com \
  --duration 24h

Fixed expiry date with multiple recipients

dlvr --file ./artifact.zip \
  --email team@example.com \
  --email ops@example.com \
  --expires-at 2026-04-25T18:00:00.000Z

JSON output for automation

dlvr --file ./artifact.zip --duration 24h --json

Interactive mode

Run dlvr with no arguments to open the full terminal form. The form shows all currently active fields at once, lets you move with the arrow keys, switch between duration and fixed-date expiry modes inline, and submit without leaving the terminal UI.

The active fields, default duration, and validation rules are fetched from GET /api/cli/config, so the service can enable or require options without shipping a new CLI first.

That config also carries the current recipient cap and expiry rules, so the terminal UI stays aligned with the live API.

CI mode

Use --yes in CI or scripted environments to disable prompts. Missing required values fail fast instead of blocking on stdin.

Large files

Smaller files go through POST /api/upload. Larger files automatically switch to the direct upload flow based on file size or the inline API response.

Continue to the REST API docs for the underlying endpoint reference used by the CLI.