Get a setting

Reads one setting. A setting that is not set is not an error: value is null. A workspace key read without workspace_dir, or for a path that is not registered, also reads as null.

From the CLI: cliq settings get agents.claude-code.model.

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_by_key

cURL

daemon

curl --request POST \ --url http://127.0.0.1:4900/v1/settings/get_by_key \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "workspace_dir": null, "key": "agents.claude-code.model" } '

200

Example

{ "ok": true, "data": { "workspace_dir": null, "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

key · string · required

Setting key

Minimum string length: 1

Response

200

application/json

Success.

ok · boolean · required

data · object · required

Show child attributes