Skip to content
MoreVoiceDevelopers

CLI: MoreVoice from your terminal

morevoice is the API from your terminal, built on the Node.js SDK. Use it to try a call in seconds while you build, to script small jobs, and to send your webhook endpoint a test event without waiting for a real call.

Install

Section titled “Install”

It finds the API key the way the SDKs do: --api-key, then the MOREVOICE_API_KEY environment variable, then a saved profile. morevoice login checks a key against the API and saves it as a profile (test or live, by the key’s mode), so you switch between test and live without copying keys around. Every command takes --json for scripts and --help for its options.

Commands

Section titled “Commands”

Everything below is the CLI’s own help, from morevoice 0.1.0.

morevoice 0.1.0 — the MoreVoice command line


Usage:
  morevoice login [--key mv_test_sk_…] [--profile name] [--api-base url]
  morevoice logout [--profile name | --all]
  morevoice whoami
  morevoice profiles [list] | profiles use <name> | profiles remove <name>
  morevoice keys [--all]
  morevoice calls create --to +9725… (--assistant asst_… | --flow flow_…) --purpose service [--var k=v]… [--metadata k=v]… [--from-number pn_…] [--idempotency-key key]
  morevoice calls list [--limit 20] [--status in_progress|ended] [--direction inbound|outbound|browser] [--assistant asst_…] [--starting-after cursor]
  morevoice calls get <call_…> [--expand assistant]
  morevoice trigger <event.type> [--endpoint we_…]
  morevoice listen [--forward-to http://localhost:3000/webhooks] [--forward-tools http://localhost:3000/tools] [--events call.*,campaign.completed] [--live]


Options (every command):
  --json              machine-readable output
  --profile <name>    use a saved profile (default: the default profile, or MOREVOICE_PROFILE)
  --api-key <key>     use this key (or MOREVOICE_API_KEY)
  --api-base <url>    another API server, e.g. staging (or MOREVOICE_API_BASE)
  -h, --help          this help · -v, --version


Keys are saved in ~/.config/morevoice/config.json (mode 600).
Command Usage
morevoice login morevoice login [--key mv_test_sk_…] [--profile name] [--api-base url]
morevoice logout morevoice logout [--profile name | --all]
morevoice whoami morevoice whoami
morevoice profiles morevoice profiles [list] | profiles use <name> | profiles remove <name>
morevoice keys morevoice keys [--all]
morevoice calls create morevoice calls create --to +9725… (--assistant asst_… | --flow flow_…) --purpose service [--var k=v]… [--metadata k=v]… [--from-number pn_…] [--idempotency-key key]
morevoice calls list morevoice calls list [--limit 20] [--status in_progress|ended] [--direction inbound|outbound|browser] [--assistant asst_…] [--starting-after cursor]
morevoice calls get morevoice calls get <call_…> [--expand assistant]
morevoice trigger morevoice trigger <event.type> [--endpoint we_…]
morevoice listen morevoice listen [--forward-to http://localhost:3000/webhooks] [--forward-tools http://localhost:3000/tools] [--events call.*,campaign.completed] [--live]