ui_settings

GET

/v1/ui-settings

curl --request GET \
  --url https://example.com/v1/ui-settings

Responses

200

UI policy: undo window, primary action side, HTML network access, remote mode/warning, relay pairing, calling device

Media typeapplication/json

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

object

undo_window_ms

required

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

integer format: int64

primary_side

required

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

string

html_allow_network

required

previews.html.allow_network.

boolean

remote_mode

required

remote.mode: off, tailscale, or direct.

string

remote_warning

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

string | null

pair_relay

required

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

boolean

device

One of:

null

null

object

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

object

id

required

string

name

required

string

scope

required

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

string

enabled

required

boolean

push

required

boolean

created_at

required

integer format: int64

last_seen

integer | null format: int64

Example^generated

{
  "undo_window_ms": 1,
  "primary_side": "example",
  "html_allow_network": true,
  "remote_mode": "example",
  "remote_warning": "example",
  "pair_relay": true,
  "device": {
    "id": "example",
    "name": "example",
    "scope": "example",
    "enabled": true,
    "push": true,
    "created_at": 1,
    "last_seen": 1
  }
}