Skip to content
Ishvana Ishvana Docs

Update Lorekeeper Settings

PUT
/api/data/settings/lorekeeper

Update Lorekeeper agent settings.

Applies any non-null field from the request to the live config, persists the result to user_settings.json under the lorekeeper key, and reloads the running Lorekeeper agent so the new values take effect immediately without a restart. On persistence failure, the in-memory config is rolled back to its prior state.

Request Body required

Section titled “Request Body required ”
LorekeeperSettingsUpdate

Partial update payload for Lorekeeper settings. Only non-null fields are applied.

object
consistencyLevel
Any of:
string
Allowed values: minor moderate strict deep
defaultModel
Any of:
string
maxContextTokens
Any of:
integer
>= 512 <= 200000
maxTokens
Any of:
integer
>= 128 <= 32000
temperature
Any of:
number
<= 2
enrichmentConcurrency
Any of:
integer
>= 1 <= 64
saveCheckTimeoutSeconds
Any of:
number
>= 1 <= 300
activityLogTimeoutSeconds
Any of:
number
>= 1 <= 120
anomalyScoreThreshold
Any of:
number
<= 1
messageListenerMaxErrors
Any of:
integer
>= 1 <= 1000
messageListenerIdleIntervalSeconds
Any of:
number
>= 0.1 <= 60
messageListenerErrorBackoffSeconds
Any of:
number
>= 0.1 <= 300
consultationSearchLimit
Any of:
integer
>= 1 <= 50
consultationSemanticWeight
Any of:
number
<= 1
consultationSnippetLength
Any of:
integer
>= 50 <= 5000
relationshipsPerEntityLimit
Any of:
integer
>= 1 <= 500

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

SettingsUpdateResponse

Shared response envelope for every settings update endpoint.

status is "success" when at least one field changed, "noop" when the request carried no updatable fields. updated_fields lists the snake_case keys that were actually persisted so the caller can display exactly what changed.

object
status
required
Status
string
message
required
Message
string
updatedFields
required
Updatedfields
Array<string>

422

Section titled “422 ”

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object