Skip to content

Update Divinity Orchestration Settings

PUT
/api/settings/divinity-orchestration

Update Divinity Engine orchestration tunables.

Mutates the live config singleton, persists to user_settings.json, then signals the running executor to rebuild its post-handler layer so the change takes effect for the next dispatch.

OrchestrationSettingsUpdate

Partial update payload — only non-None sub-blocks are applied.

object
utilityScorer
Any of:
UtilityScorerSettingsUpdate

Partial update for utility-scorer weights + severity floor.

object
severity
Any of:
number
<= 2
proximity
Any of:
number
<= 2
visibility
Any of:
number
<= 2
userPreference
Any of:
number
<= 2
memory
Any of:
number
<= 2
override
Any of:
number
<= 2
severityFloor
Any of:
string
Allowed values: info warning error
severityFloorClear
Any of:
boolean
enabled
Any of:
boolean
hawkenBehaviorTree
Any of:
HawkenBehaviorTreeSettingsUpdate

Partial update for Hawken’s post-scan BT thresholds.

object
heavilyDismissedThreshold
Any of:
number
<= 2
stronglyAcceptedThreshold
Any of:
number
<= 2
followUpSameRuleMin
Any of:
integer
>= 2 <= 20
escalationBoostDelta
Any of:
number
>= -0.9 <= 0.9
lorekeeperBehaviorTree
Any of:
LorekeeperBehaviorTreeSettingsUpdate

Partial update for Lorekeeper’s post-scan BT thresholds.

object
repeatedlyDismissedFloor
Any of:
number
<= 2
anomalyClusterFloor
Any of:
integer
>= 2 <= 50
reciprocalFixAcceptRatioFloor
Any of:
number
<= 2
anomalyClusterDampenDelta
Any of:
number
>= -0.9 <= 0.9

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>

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