# `smallforce calls tools`

Manage the custom tools receptionists can use on calls

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

## Subcommands

- [`smallforce calls tools list`](/docs/cli/commands/calls/tools/list): List tools and keys
- [`smallforce calls tools get`](/docs/cli/commands/calls/tools/get): Get a tool and its definition
- [`smallforce calls tools create`](/docs/cli/commands/calls/tools/create): Create a tool from JSON: { displayName, description, definition: { inputs, request, response, waitMode, ... }, keyId? }
- [`smallforce calls tools update`](/docs/cli/commands/calls/tools/update): Update a tool from JSON (only the fields given change)
- [`smallforce calls tools archive`](/docs/cli/commands/calls/tools/archive): Archive a tool (calls already running keep it)
- [`smallforce calls tools restore`](/docs/cli/commands/calls/tools/restore): Restore an archived tool
- [`smallforce calls tools test`](/docs/cli/commands/calls/tools/test): Send a real request with the given inputs and show what the AI would hear
- [`smallforce calls tools import-curl`](/docs/cli/commands/calls/tools/import-curl): Turn a curl command into a draft tool (nothing is saved)
- [`smallforce calls tools runs`](/docs/cli/commands/calls/tools/runs): Show a tool's recent runs
- [`smallforce calls tools on`](/docs/cli/commands/calls/tools/on): Turn a tool on for a receptionist (from its next call)
- [`smallforce calls tools off`](/docs/cli/commands/calls/tools/off): Turn a tool off for a receptionist (from its next call)
- [`smallforce calls tools for`](/docs/cli/commands/calls/tools/for): List every tool with whether it's on for a receptionist
- [`smallforce calls tools signing-secret`](/docs/cli/commands/calls/tools/signing-secret): Show or rotate the secret every tool request is signed with

## Complete command help

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

Manage the custom tools receptionists can use on calls

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:
  list [options]                        List tools and keys
  get [options] <toolId>                Get a tool and its definition
  create [options]                      Create a tool from JSON: { displayName, description,
                                        definition: { inputs, request, response, waitMode, ... },
                                        keyId? }
  update [options] <toolId>             Update a tool from JSON (only the fields given change)
  archive [options] <toolId>            Archive a tool (calls already running keep it)
  restore [options] <toolId>            Restore an archived tool
  test [options] <toolId>               Send a real request with the given inputs and show what the
                                        AI would hear
  import-curl [options]                 Turn a curl command into a draft tool (nothing is saved)
  runs [options] <toolId>               Show a tool's recent runs
  on [options] <assistantId> <toolId>   Turn a tool on for a receptionist (from its next call)
  off [options] <assistantId> <toolId>  Turn a tool off for a receptionist (from its next call)
  for [options] <assistantId>           List every tool with whether it's on for a receptionist
  signing-secret [options]              Show or rotate the secret every tool request is signed with
  help [command]                        display help for command
```

## Related reference

- [`smallforce calls`](/docs/cli/commands/calls): 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.