> For AI agents: the documentation index is at https://docs.gethandup.dev/llms.txt. Append .md to any page URL (without the trailing slash) for Markdown, for example https://docs.gethandup.dev/cli.md.

# ui_settings

`GET /v1/ui-settings`

## Responses

### 200

UI policy: undo window, primary action side, HTML network access, remote mode/warning, relay pairing, calling device, pending config restart and config error. Refetch on `config.changed`.

Media type: `application/json`

`object`

Read-only UI policy derived from daemon config; never includes secrets.

- **undo_window_ms** (required): `integer` format: int64, >= 0

  `decisions.undo_window` in milliseconds (0 = approvals send instantly).

- **primary_side** (required): `string`

  `decisions.primary_side`: right or left, the edge of decision footers
  that holds the primary (approve) action. Apps may override it per device.

- **html_allow_network** (required): `boolean`

  `previews.html.allow_network`.

- **keys** (required): `object`

  `keys:` keyboard shortcut overrides (action id → key, e.g. `shift+a`,
  `mod+enter`); absent actions use their defaults. Changes arrive live
  as `keys.changed` events.

  - *additional properties*: `string`

- **remote_mode** (required): `string`

  `remote.mode`: off, tailscale, or direct.

- **remote_warning**: `string | null`

  Direct-mode risk warning; UIs show it as a persistent banner when set.

- **pair_relay** (required): `boolean`

  `remote.relay.url` is set, so local callers can pair through the relay
  (`POST /v1/pair {relay: true}`). Always false for paired devices.

- **device**: `object | null`

  The calling paired device on the remote listener; null for local callers.

  - **id** (required): `string`
  - **name** (required): `string`
  - **scope** (required): `string`

    `view` (read-only) or `decide` (adds decision, cancel and test requests).

  - **enabled** (required): `boolean`
  - **push** (required): `boolean`
  - **created_at** (required): `integer` format: int64, >= 0
  - **last_seen**: `integer | null` format: int64, >= 0

- **config_restart_required** (required): `Array<string>`

  Config keys saved since the daemon started that apply only after a
  restart (`config.changed` `restart_required`); empty when none.

- **config_error**: `string | null`

  The config file's parse/validation error (`path:line: message`) while
  the daemon keeps the previous config; null when the file is valid.

