settings

Update Application Setting

Changed on

Updates the value of a specific application setting. The new value is validated against the setting's constraints and persisted to the application database.

Security Note: Admin session authentication required for system configuration changes.

put/bodhi/v1/settings/{key}

Request

  • Base URL: http://localhost:1135
  • URL: http://localhost:1135/bodhi/v1/settings/{key}
  • Auth: OAuth 2 (authorization code, authorization URL /bodhi/v1/auth/initiate, token URL /bodhi/v1/auth/callback, scopes: resource_admin)

Path parameters

keystring required

Setting key identifier (e.g., BODHI_LOG_LEVEL, BODHI_PORT)

Request body

valueunknown required

Example request

{
  "value": "debug"
}

Response

Setting updated successfully

keystring required
current_valueunknown required
default_valueunknown required
source'system' | 'command_line' | 'environment' | 'database' | 'settings_file' | 'default' required

Changes

  • 11825ee4b44dRevision changes
    • breaking

      removed 'propertyNames' constraint from the / response property for the status

    • breaking

      removed 'propertyNames' constraint from the / response property for the status

    • breaking

      removed 'propertyNames' constraint from the / response property for the status

    • breaking

      removed 'propertyNames' constraint from the / response property for the status

    • breaking

      removed 'propertyNames' constraint from the / response property for the status

    • breaking

      the / response's property type changed from object null to string null for status

    • breaking

      the / response's property type changed from object null to string null for status

    • breaking

      the / response's property type changed from object null to string null for status

    • breaking

      the / response's property type changed from object null to string null for status

    • breaking

      the / response's property type changed from object null to string null for status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status