Skip to content
Aura Live Documentation

Update user live config

PUT
/user-live-configs/{id}

👤 Authentification Utilisateur Requise

Ce point d’accès permet de mettre à jour les propriétés d’un profil de configuration existant en utilisant son identifiant unique.

Il s’agit d’une mise à jour partielle : vous n’avez besoin d’envoyer que les champs que vous souhaitez modifier. Tous les champs du corps de la requête sont optionnels.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
id
required
string
Example
3

Request Body

Section titled “Request Body ”
object
name
required

A unique, human-readable name for the preset (e.g., ‘default’, ‘low-latency’, ‘high-accuracy’).

string
vad

Enable or disable Voice Activity Detection (VAD). If true, the engine will only process audio segments that contain speech, which can reduce processing load and improve accuracy by filtering out silence or noise.

boolean
Example
true
mode

The transcription mode, controlling how results are sent. Typically ‘partial’ for faster, intermediate results or ‘final’ for more accurate, completed segments.

string
Allowed values: partial final
Example
partial
min_buffer

The minimum amount of audio (in seconds) to buffer before sending it to the ASR model. Higher values can improve accuracy on short phrases but increase initial latency.

number format: float
Example
2
max_buffer

The maximum amount of audio (in seconds) to buffer before forcing a transcription. This acts as an upper bound on latency.

number format: float
Example
4
buffer_timeout

The maximum duration of silence (in seconds) to wait before considering a phrase complete and finalizing the transcription for the current buffer.

number format: float
Example
4
max_delay

The maximum allowed delay (in seconds) between the incoming audio and the returned transcription. The system may adjust buffer sizes to stay within this limit.

number format: float
Example
4
max_chars

The maximum number of characters to include in a single line of the returned transcription. Used for formatting the output for display.

integer
Example
40
max_lines

The maximum number of lines to display in the transcription output. When this limit is reached, older lines may be removed.

integer
Example
2
punctuate

Enable or disable punctuation. If true, the engine will add punctuation.

boolean
Example
true
Example
{
  "vad": true
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful response (inferred from assertions)

object
data
required
object
id
required

The unique numeric identifier for this configuration preset.

integer
Example
1
name
required

A unique, human-readable name for the preset (e.g., ‘default’, ‘low-latency’, ‘high-accuracy’).

string
Example
default
vad

Enable or disable Voice Activity Detection (VAD). If true, the engine will only process audio segments that contain speech, which can reduce processing load and improve accuracy by filtering out silence or noise.

boolean
Example
true
mode

The transcription mode, controlling how results are sent. Typically ‘partial’ for faster, intermediate results or ‘final’ for more accurate, completed segments.

string
Allowed values: partial final
Example
partial
min_buffer

The minimum amount of audio (in seconds) to buffer before sending it to the ASR model. Higher values can improve accuracy on short phrases but increase initial latency.

number format: float
Example
2
max_buffer

The maximum amount of audio (in seconds) to buffer before forcing a transcription. This acts as an upper bound on latency.

number format: float
Example
4
buffer_timeout

The maximum duration of silence (in seconds) to wait before considering a phrase complete and finalizing the transcription for the current buffer.

number format: float
Example
4
max_delay

The maximum allowed delay (in seconds) between the incoming audio and the returned transcription. The system may adjust buffer sizes to stay within this limit.

number format: float
Example
4
max_chars

The maximum number of characters to include in a single line of the returned transcription. Used for formatting the output for display.

integer
Example
40
max_lines

The maximum number of lines to display in the transcription output. When this limit is reached, older lines may be removed.

integer
Example
2
punctuate

Enable or disable punctuation. If true, the engine will add punctuation.

boolean
Example
true
Example
{
  "data": {
    "created_at": "2025-11-13T17:42:50.503270+01:00",
    "updated_at": "2025-11-13T17:52:37.681413+01:00",
    "name": "Quiet Room Setup",
    "vad": true,
    "mode": "partial",
    "min_buffer": 1,
    "max_buffer": 2,
    "buffer_timeout": 3,
    "max_delay": 4,
    "max_chars": 40,
    "max_lines": 2,
    "id": 3
  }
}