Skip to main content
PUT
/
api
/
v1
/
settings
/
runtime
Put Runtime
curl --request PUT \
  --url https://api.example.com/api/v1/settings/runtime \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "kg_connection_pool_size": 16,
  "kg_decay_tick_interval_minutes": 5042,
  "kg_decay_tick_max_age_days": 182,
  "kg_decay_tick_staleness_days": 183,
  "kg_kuzu_buffer_pool_mb": 264,
  "kg_kuzu_max_db_size_gb": 32,
  "kg_queue_alert_threshold": 50050,
  "kg_queue_claim_timeout_s": 1830,
  "kg_queue_max_attempts": 5,
  "kg_queue_max_concurrent_workers": 8,
  "kg_queue_min_interval_ms": 500
}
'
{
  "kg_connection_pool_size": 123,
  "kg_decay_tick_interval_minutes": 123,
  "kg_decay_tick_max_age_days": 123,
  "kg_decay_tick_staleness_days": 123,
  "kg_kuzu_buffer_pool_mb": 123,
  "kg_kuzu_max_db_size_gb": 123,
  "kg_queue_alert_threshold": 123,
  "kg_queue_claim_timeout_s": 123,
  "kg_queue_max_attempts": 123,
  "kg_queue_max_concurrent_workers": 123,
  "kg_queue_min_interval_ms": 123,
  "restart_required": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.oktolabs.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

PUT body — every field optional; partial updates are allowed.

Ranges mirror :class:CoreSettings Field validators. Pydantic emits 422 (FastAPI maps to 400 in the error envelope) with a clear greater than or equal to / less than or equal to message for violations.

​
kg_connection_pool_size
integer | null
Required range: 1 <= x <= 32
​
kg_decay_tick_interval_minutes
integer | null
Required range: 5 <= x <= 10080
​
kg_decay_tick_max_age_days
integer | null
Required range: 0 <= x <= 365
​
kg_decay_tick_staleness_days
integer | null
Required range: 1 <= x <= 365
​
kg_kuzu_buffer_pool_mb
integer | null
Required range: 16 <= x <= 512
​
kg_kuzu_max_db_size_gb
integer | null
Required range: 1 <= x <= 64
​
kg_queue_alert_threshold
integer | null
Required range: 100 <= x <= 100000
​
kg_queue_claim_timeout_s
integer | null
Required range: 60 <= x <= 3600
​
kg_queue_max_attempts
integer | null
Required range: 1 <= x <= 10
​
kg_queue_max_concurrent_workers
integer | null
Required range: 1 <= x <= 16
​
kg_queue_min_interval_ms
integer | null
Required range: 0 <= x <= 1000

Response

Successful Response

GET/PUT response shape — Graph DB keys + Event Queue keys (spec bdcda842).

restart_required is true only when a Graph DB key (Kùzu constructor-time) diverges from the boot snapshot. Event Queue keys hot-reload via the worker pool's 5s settings cache.

​
kg_connection_pool_size
integer
required
​
kg_decay_tick_interval_minutes
integer
required
​
kg_decay_tick_max_age_days
integer
required
​
kg_decay_tick_staleness_days
integer
required
​
kg_kuzu_buffer_pool_mb
integer
required
​
kg_kuzu_max_db_size_gb
integer
required
​
kg_queue_alert_threshold
integer
required
​
kg_queue_claim_timeout_s
integer
required
​
kg_queue_max_attempts
integer
required
​
kg_queue_max_concurrent_workers
integer
required
​
kg_queue_min_interval_ms
integer
required
​
restart_required
boolean
required
Last modified on May 8, 2026