> ## Documentation Index
> Fetch the complete documentation index at: https://smithers.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# listAccounts

> Gateway RPC for listing registered Smithers agent accounts.

* Method: `listAccounts`
* Scope: `account:read`
* Transports: HTTP RPC, WebSocket RPC
* Request: `{}`
* Response: `Account[]`

Each account is a row in the user-level `~/.smithers/accounts.json` registry, managed by the `bunx smithers-orchestrator agents` CLI (via `@smithers-orchestrator/accounts`, honoring `SMITHERS_HOME`/`HOME`) and carrying `{ label, provider, configDir?, hasConfigDir, hasApiKey, model?, addedAt? }`. `provider` is one of `claude-code`, `antigravity`, `codex`, `gemini`, `kimi`, `anthropic-api`, `openai-api`, `gemini-api`.

The raw API key is **never** returned: a subscription account exposes `configDir`/`hasConfigDir`, an API-key account exposes only `hasApiKey` (whether a non-empty key is set), letting a client render auth posture without seeing the plaintext secret. A missing registry file yields an empty list.

Errors are versioned as `v1` and include `InvalidRequest`, `Unauthorized`, `Forbidden`, and `Internal`.