The household's settings

GET

/api/settings/household

curl --request GET \
  --url http://localhost:3000/api/settings/household \
  --cookie merran.session_token=<merran.session_token>

• Your Merran

The settings of the household in use, like its own AI keys. Anyone in the household can see them; secrets show only whether they’re set.

Authorizations

• session

Responses

200

The settings.

Media typeapplication/json

No module has household settings yet, so the list is empty.

object

settings

required

Array<object>

object

key

required

string

kind

required

string

Allowed values: text number switch choice list secret json

value

Its value, or null for a secret or a setting that isn’t set.

default

source

required

string

Allowed values: default saved environment

lockedBy

required

The environment variable that sets it, which means it can’t be changed here.

string | null

secret

object

set

required

boolean

hint

required

Its last four characters, when it’s long enough.

string | null

unreadable

required

Sealed with another master key, so it needs entering again.

boolean

choices

Array<string>

Example

{
  "settings": []
}

401

Not signed in.

Media typeapplication/json

object

error

required

object

code

required

string

message

required

string

fields

object

key

additional properties

string

Example

{
  "error": {
    "code": "not_found",
    "message": "There's nothing here.",
    "fields": {
      "name": "Give it a name."
    }
  }
}

403

Not allowed.

Media typeapplication/json

object

error

required

object

code

required

string

message

required

string

fields

object

key

additional properties

string

Example

{
  "error": {
    "code": "not_found",
    "message": "There's nothing here.",
    "fields": {
      "name": "Give it a name."
    }
  }
}