Configuration Endpoints
Endpoints for global settings.
| Method | Path | Description |
|---|---|---|
GET POST |
/v1/config/startup |
local — launch-on-login. GET returns enabled (the recorded setting) and installed (whether the launchd agent or systemd user unit exists). POST {enable} (required) writes or removes the launchd agent (macOS) or systemd user unit (Linux) and returns {ok, enabled, installed, detail}; it never starts or stops the running daemon, and takes effect at the next login |
GET POST |
/v1/config/system |
local — reply language. GET returns reply_lang (auto by default) and languages ({code, label} options, auto first). POST {reply_lang} (required) canonicalizes the code, rejects values over 64 bytes or containing a line break, and writes reply_lang to config.json |
GET |
/v1/config/reply_lang |
local — added in v1.0.11, read-only (a POST to this target returns 404). Returns the configured reply_lang, its resolved name, and the directive sentence injected into the system prompt — empty for auto, where the reply follows each message's own language |
GET POST |
/v1/config/output_dir |
local — output directory. GET returns output_dir (the raw setting) and resolved (the directory in use; ~/Downloads when unset and that folder exists). POST {output_dir} (required) expands ~, creates the directory, and writes it to config.json; "" restores the default |
Any other :target returns 404.