> ## 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.

# Put Runtime

> Persist new runtime settings. Values only take effect after restart.



## OpenAPI

````yaml /openapi.json put /api/v1/settings/runtime
openapi: 3.1.0
info:
  description: >-
    Okto Pulse REST API schema generated from okto-pulse-core 0.2.0 source for
    docs.oktolabs.ai.
  title: Okto Pulse
  version: 0.2.0
servers: []
security: []
paths:
  /api/v1/settings/runtime:
    put:
      tags:
        - settings
      summary: Put Runtime
      description: Persist new runtime settings. Values only take effect after restart.
      operationId: put_runtime_api_v1_settings_runtime_put
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RuntimeSettingsPayload'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RuntimeSettingsResponse'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
        - HTTPBearer: []
components:
  schemas:
    RuntimeSettingsPayload:
      description: |-
        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.
      properties:
        kg_connection_pool_size:
          anyOf:
            - maximum: 32
              minimum: 1
              type: integer
            - type: 'null'
          title: Kg Connection Pool Size
        kg_decay_tick_interval_minutes:
          anyOf:
            - maximum: 10080
              minimum: 5
              type: integer
            - type: 'null'
          title: Kg Decay Tick Interval Minutes
        kg_decay_tick_max_age_days:
          anyOf:
            - maximum: 365
              minimum: 0
              type: integer
            - type: 'null'
          title: Kg Decay Tick Max Age Days
        kg_decay_tick_staleness_days:
          anyOf:
            - maximum: 365
              minimum: 1
              type: integer
            - type: 'null'
          title: Kg Decay Tick Staleness Days
        kg_kuzu_buffer_pool_mb:
          anyOf:
            - maximum: 512
              minimum: 16
              type: integer
            - type: 'null'
          title: Kg Kuzu Buffer Pool Mb
        kg_kuzu_max_db_size_gb:
          anyOf:
            - maximum: 64
              minimum: 1
              type: integer
            - type: 'null'
          title: Kg Kuzu Max Db Size Gb
        kg_queue_alert_threshold:
          anyOf:
            - maximum: 100000
              minimum: 100
              type: integer
            - type: 'null'
          title: Kg Queue Alert Threshold
        kg_queue_claim_timeout_s:
          anyOf:
            - maximum: 3600
              minimum: 60
              type: integer
            - type: 'null'
          title: Kg Queue Claim Timeout S
        kg_queue_max_attempts:
          anyOf:
            - maximum: 10
              minimum: 1
              type: integer
            - type: 'null'
          title: Kg Queue Max Attempts
        kg_queue_max_concurrent_workers:
          anyOf:
            - maximum: 16
              minimum: 1
              type: integer
            - type: 'null'
          title: Kg Queue Max Concurrent Workers
        kg_queue_min_interval_ms:
          anyOf:
            - maximum: 1000
              minimum: 0
              type: integer
            - type: 'null'
          title: Kg Queue Min Interval Ms
      title: RuntimeSettingsPayload
      type: object
    RuntimeSettingsResponse:
      description: >-
        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.
      properties:
        kg_connection_pool_size:
          title: Kg Connection Pool Size
          type: integer
        kg_decay_tick_interval_minutes:
          title: Kg Decay Tick Interval Minutes
          type: integer
        kg_decay_tick_max_age_days:
          title: Kg Decay Tick Max Age Days
          type: integer
        kg_decay_tick_staleness_days:
          title: Kg Decay Tick Staleness Days
          type: integer
        kg_kuzu_buffer_pool_mb:
          title: Kg Kuzu Buffer Pool Mb
          type: integer
        kg_kuzu_max_db_size_gb:
          title: Kg Kuzu Max Db Size Gb
          type: integer
        kg_queue_alert_threshold:
          title: Kg Queue Alert Threshold
          type: integer
        kg_queue_claim_timeout_s:
          title: Kg Queue Claim Timeout S
          type: integer
        kg_queue_max_attempts:
          title: Kg Queue Max Attempts
          type: integer
        kg_queue_max_concurrent_workers:
          title: Kg Queue Max Concurrent Workers
          type: integer
        kg_queue_min_interval_ms:
          title: Kg Queue Min Interval Ms
          type: integer
        restart_required:
          title: Restart Required
          type: boolean
      required:
        - kg_kuzu_buffer_pool_mb
        - kg_kuzu_max_db_size_gb
        - kg_connection_pool_size
        - kg_queue_max_concurrent_workers
        - kg_queue_min_interval_ms
        - kg_queue_claim_timeout_s
        - kg_queue_max_attempts
        - kg_queue_alert_threshold
        - kg_decay_tick_interval_minutes
        - kg_decay_tick_staleness_days
        - kg_decay_tick_max_age_days
        - restart_required
      title: RuntimeSettingsResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    ValidationError:
      properties:
        ctx:
          title: Context
          type: object
        input:
          title: Input
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
  securitySchemes:
    HTTPBearer:
      scheme: bearer
      type: http

````