# File and Credential Endpoints

Endpoints for files, stored keys and live voice.

| Method | Path | Description |
|---|---|---|
| `GET` `PUT` | `/v1/file` | **local** — read / write a file |
| `GET` | `/v1/file/open` | **local** — open a file or URL with the OS default handler |
| `GET` | `/v1/file/locate` | **local** — find candidate paths for a bare file name (`name`, plus optional `dir=1`, `child`, `size`, `mtime` filters) |
| `GET` | `/v1/workdir` | **local** — resolve and validate a work directory (`?path=`), returning the absolute path |
| `DELETE` | `/v1/key` | **local** — delete a single credential in the keychain. The `GET` that returned a stored value was removed in v1.0.23 |
| `GET` `POST` | `/v1/keys` | **local** — list / set credentials |
| `GET` | `/v1/voice/live` | **local** — added in v1.1.1. WebSocket upgrade that relays the dashboard's voice mode to Gemini Live (`gemini-3.8-live`) with `GEMINI_API_KEY` from the keychain. The daemon sends the setup itself — voice system prompt in the configured reply language, the `send_to_chat` / `read_history` / `read_task` function declarations, input and output transcription — then passes frames both ways. Closes with code `4401` when the key is missing and `1011` when the upstream dial or setup fails |