List settings

Lists the daemon-wide settings, optionally only keys starting with prefix. With workspace_dir, that workspace’s secrets are listed after them (none when the path is not a registered workspace). workspace_dir is required in the body; send null for daemon-wide only.

From the CLI: cliq settings.

No credential is needed from this machine. From another host, send Authorization: Bearer with a dispatch token CliqHub signed for this daemon or a cliq_tok_… personal token of a user in the daemon’s realm; this only works once the daemon is connected to CliqHub. See Authentication.

POST /v1/settings/get

cURL

all

curl --request POST \ --url http://127.0.0.1:4900/v1/settings/get \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "workspace_dir": null } '

200

Example

{ "ok": true, "data": { "workspace_dir": null, "entries": [ { "key": "agents.claude-code.api_key", "value": "•••• (secret, hidden)" }, { "key": "agents.claude-code.model", "value": "claude-sonnet-4-5" } ] } }

Authorizations

Authorization · string · header · required

Not needed from the same machine. From another host: a dispatch JWT CliqHub signed for this daemon, or a cliq_tok_… personal token whose user is in the daemon's realm.

Body

application/json

workspace_dir · string | null · required

Workspace path, or null for daemon-global settings

Minimum string length: 1

prefix · string

Only keys starting with this prefix

Minimum string length: 1

Response

200

application/json

Success.

ok · boolean · required

data · object · required

Show child attributes