Docs
Open SmallForce

CLI

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

Complete command help

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