# `smallforce calls links list`

List link summaries and related calls; private context and bearer URLs are omitted

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

## Complete command help

```text
Usage: smallforce calls links list [options]

List link summaries and related calls; private context and bearer URLs are omitted

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
  --assistant-id <id>               Filter assistant
  --customer-reference <reference>  Filter exact customer reference
  --status <status>                 Expiry/revocation state; unexpired links may already have a
                                    conversation (choices: "unexpired", "expired", "revoked")
  --limit <number>                  Page size (1-100)
  --cursor <cursor>                 Opaque nextCursor from the previous page
  -h, --help                        display help for command
```

## Related reference

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