# `smallforce calls`

Manage assistants, publishing, personal audio/video links, numbers and call history

This page is generated from the same Commander definition shipped in SmallForce CLI 0.1.13. Run `smallforce calls --help` locally to view the same reference for your installed version.

## Subcommands

- [`smallforce calls credits`](/docs/cli/commands/calls/credits): Show the existing SmallForce credit balance
- [`smallforce calls list`](/docs/cli/commands/calls/list): List call history, newest first
- [`smallforce calls get`](/docs/cli/commands/calls/get): Get a call with events, transcripts, recording and follow-up (hand-off and website forms)
- [`smallforce calls events`](/docs/cli/commands/calls/events): Read the call's lifecycle events
- [`smallforce calls transcripts`](/docs/cli/commands/calls/transcripts): Read call transcripts
- [`smallforce calls recording`](/docs/cli/commands/calls/recording): Get the existing recording's temporary playback URL, when available
- [`smallforce calls handoff`](/docs/cli/commands/calls/handoff): Read a call's hand-off: who was rung, who declined or joined
- [`smallforce calls stats`](/docs/cli/commands/calls/stats): Count calls per hour today, or per day over 7 or 30 days
- [`smallforce calls needs-you`](/docs/cli/commands/calls/needs-you): List calls that need someone: missed, failed and unanswered
- [`smallforce calls voices`](/docs/cli/commands/calls/voices): Discover the voice service's TTS voice catalog
- [`smallforce calls publish`](/docs/cli/commands/calls/publish): Configure regular assistants' public pages and website embeds
- [`smallforce calls links`](/docs/cli/commands/calls/links): Manage personalized audio/video call invitations for regular assistants
- [`smallforce calls answers`](/docs/cli/commands/calls/answers): Read collected answers, field definitions and missing required fields
- [`smallforce calls video`](/docs/cli/commands/calls/video): Discover available video avatars and voices
- [`smallforce calls assistants`](/docs/cli/commands/calls/assistants): Manage voice assistant configuration
- [`smallforce calls phone-numbers`](/docs/cli/commands/calls/phone-numbers): Search, purchase and manage inbound phone numbers
- [`smallforce calls knowledge`](/docs/cli/commands/calls/knowledge): Manage the existing voice knowledge and training jobs
- [`smallforce calls callers`](/docs/cli/commands/calls/callers): What the AI receptionist remembers about phone callers (standalone receptionists)
- [`smallforce calls memory`](/docs/cli/commands/calls/memory): Add, edit or delete one caller memory (locked: the post-call job never changes it)
- [`smallforce calls tools`](/docs/cli/commands/calls/tools): Manage the custom tools receptionists can use on calls
- [`smallforce calls tool-keys`](/docs/cli/commands/calls/tool-keys): Manage the keys custom tools send (each only to its own website)

## Complete command help

```text
Usage: smallforce calls [options] [command]

Manage assistants, publishing, personal audio/video links, numbers and call history

Options:
  --api-key <key>                 SmallForce API key, or set SMALLFORCE_API_KEY
  --backend-url <url>             SmallForce backend URL, or set SMALLFORCE_BACKEND_URL
  --json                          Print stable machine-readable JSON
  --text                          Print human-readable text
  --format <format>               Output format: text or json
  -h, --help                      display help for command

Commands:
  credits [options]               Show the existing SmallForce credit balance
  list [options]                  List call history, newest first
  get [options] <callId>          Get a call with events, transcripts, recording and follow-up
                                  (hand-off and website forms)
  events [options] <callId>       Read the call's lifecycle events
  transcripts [options] <callId>  Read call transcripts
  recording [options] <callId>    Get the existing recording's temporary playback URL, when
                                  available
  handoff [options] <callId>      Read a call's hand-off: who was rung, who declined or joined
  stats [options]                 Count calls per hour today, or per day over 7 or 30 days
  needs-you [options]             List calls that need someone: missed, failed and unanswered
  voices [options]                Discover the voice service's TTS voice catalog
  publish [options]               Configure regular assistants' public pages and website embeds
  links [options]                 Manage personalized audio/video call invitations for regular
                                  assistants
  answers [options] <callId>      Read collected answers, field definitions and missing required
                                  fields
  video [options]                 Discover available video avatars and voices
  assistants [options]            Manage voice assistant configuration
  phone-numbers [options]         Search, purchase and manage inbound phone numbers
  knowledge [options]             Manage the existing voice knowledge and training jobs
  callers [options]               What the AI receptionist remembers about phone callers (standalone
                                  receptionists)
  memory [options]                Add, edit or delete one caller memory (locked: the post-call job
                                  never changes it)
  tools [options]                 Manage the custom tools receptionists can use on calls
  tool-keys [options]             Manage the keys custom tools send (each only to its own website)
  help [command]                  display help for command
```

## Related reference

- [`smallforce`](/docs/cli/commands): Parent command and related operations.
- [CLI installation and authentication](/docs/cli/getting-started): Install the CLI and configure an API key.
- [CLI JSON output](/docs/cli/json-output): Use stable machine-readable output in scripts and agents.