/api/v1/config

Updates the service configuration in memory. The config_json_string field contains, serialized as a JSON string, the parameters to modify; those not included keep their value.

Not all the parameters returned by GET /api/v1/config can be modified with this endpoint. The following table shows the access level of each one:

Parameter	Access
metrics_saturation_queue_p95_ms	Read and write
metrics_saturation_min_inflight_ratio	Read and write
metrics_error_rate_warning	Read and write
metrics_idle_rps_threshold	Read and write
metrics_quality_alert_window_seconds	Read and write
port	Read only
number_of_threads	Read only
connection_timeout	Read only
keep_alive_request_number	Read only
client_max_body_size	Read only
logger_path	Read only
logger_file_prefix	Read only
logger_level	Read only
logger_rotation	Read only
logger_max_files	Read only
metrics_enabled	Read only

• Read-write parameters are applied without restarting the service. If the equivalent environment variable is defined (for example, FACEPHI_VOICE_REST_METRICS_ERROR_RATE_WARNING), its value takes precedence over the one sent.

• The metrics_* parameters are the thresholds GET /api/v1/metrics uses to classify the service status.

• Read-only parameters are only configured at startup, through config.json or the FACEPHI_VOICE_REST_* environment variables. If they are sent to this endpoint, the request returns 200 and GET returns the value sent, but the service keeps using the value it started with.

• GET returns the values defined in config.json and those sent to this endpoint; it does not reflect values set through environment variables.

• Changes are not saved to config.json and are lost when the service restarts.

• JWT authentication settings (auth_*) are startup-only: GET does not return them and this endpoint rejects with 400 any request that includes them.

post

Autorizações

AuthorizationstringObrigatório

Bearer authentication header of the form Bearer <token>.

Corpo

Config request body. This endpoint does not accept JWT authentication settings.

config_json_stringstringObrigatório

JSON string with the configuration parameters to modify. Only the read-write parameters listed in POST /api/v1/config are applied.

Example: {"metrics_error_rate_warning":0.1,"metrics_quality_alert_window_seconds":600}

Respostas

200

Message with the result of the operation.

application/json

messagestringOpcionalExample: Configuration updated successfully

400

The request contains incorrect parameters.

application/json

500

An error occurred while calling the Voice-SDK backend.

application/json

post/api/v1/config

POST /api/v1/config HTTP/1.1
Host: 127.0.0.1:6982/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 106

{
  "config_json_string": "{\"metrics_error_rate_warning\":0.1,\"metrics_quality_alert_window_seconds\":600}"
}

{
  "message": "Configuration updated successfully"
}