Read the settings

GET

/settings

curl --request GET \
  --url http://127.0.0.1:7700/api/settings \
  --header 'Authorization: Bearer <token>'

• On the box itself (the default listen address)
• From another device, with a paired device token, when BOX_LISTEN allows it

Authorizations

• deviceToken
• accessToken

Responses

200

Every setting.

Media typeapplication/json

object

approvalThresholdCents

A single spend above this, in US cents, always asks for an OK, even inside the task’s budget.

integer

default: 10000

defaultBudgetCents

The budget of a task that names none. 0 means every spend asks.

integer

0

networkDefault

With allowlist, a task that names no hosts gets defaultHosts.

string

default: none

Allowed values: none allowlist

defaultHosts

Array<string>

default: <= 100 items

agentFolders

Personal. Folders agents may be given besides the owner’s home. Never the system or the box’s own state.

Array<string>

default: <= 50 items

quietHours

object

enabled

boolean

from

string

default: 22:00

to

string

default: 07:00

logRetentionDays

integer

default: 365 >= 1 <= 3650

updateChannel

string

default: stable

Allowed values: stable beta

autoUpdate

boolean

default: true

appearance

object

theme

string

default: system

Allowed values: light dark system

accent

A color like #5b8cff, or empty for the default.

string

Example

{
  "approvalThresholdCents": 10000,
  "defaultBudgetCents": 0,
  "networkDefault": "none",
  "defaultHosts": [],
  "agentFolders": [],
  "quietHours": {
    "enabled": false,
    "from": "22:00",
    "to": "07:00"
  },
  "logRetentionDays": 365,
  "updateChannel": "stable",
  "autoUpdate": true,
  "appearance": {
    "theme": "light"
  }
}