tessera

Lists every setting, with its value and where that value came from.

GET
/api/v1/admin/settings

Why the ones that cannot be changed are here too

Leaving them out prompts the question of where the port setting went. They come back marked editable: false with a reason: a screen that explains itself instead of one with a hole in it.

Errors

401 when nothing was signed in, 403 when the caller may not read settings or used a bearer token, 404 when this instance has no administration.

session
cookietessera_session<token>

Set by POST /auth/login. A browser sends it automatically; it is HttpOnly, so page scripts cannot read or set it.

Response Body

Every setting

application/json
  1. response

Everything this instance can be configured with.

settings*array<>

Every setting, editable or not.

curl -X GET 'https://example.com/api/v1/admin/settings'
{  "settings": [    {      "editable": true,      "fallback": {},      "key": "string",      "refusal": "string",      "secret": true,      "source": "default",      "value": {}    }  ]}