# `smallforce calls knowledge list`

List an assistant's knowledge and training status

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

## Complete command help

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

List an assistant's knowledge and training status

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>     Voice assistant ID
  --include-deleted       Include deleted knowledge
  --limit <number>        Maximum results (1-500)
  --status <statuses...>  Filter training statuses (choices: "DRAFT", "PENDING", "IN_PROGRESS",
                          "EXTRACTED", "TRAINED", "FAILED", "DELETED", "DELETION_ERROR")
  --type <types...>       Filter knowledge types (choices: "TEXT", "URL", "PDF")
  -h, --help              display help for command
```

## Related reference

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