Skip to content
Aura Live Documentation

List user live configs

GET
/user-live-configs/

👤 Authentification Utilisateur Requise

Ce point d’accès permet à l’utilisateur actuellement authentifié de récupérer la liste complète de tous ses profils de configuration live sauvegardés.

C’est l’endpoint de base pour obtenir un aperçu de toutes les configurations disponibles avant d’en choisir une pour une session, ou pour en récupérer l’ID en vue de la modifier ou de la supprimer.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
skip
integer

The number of items to skip from the beginning of the result set. This is used for pagination, often referred to as the ‘offset’.

limit
integer

The maximum number of items to return in the response. This is used to control the page size.

Example
100

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful response (inferred from assertions)

object
data
required
Array<object>
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
pagination
required
object
total_items
required

The total number of items available in the entire dataset that match the query, across all pages.

integer
total_pages
required

The total number of pages calculated from total_items and per_page. A client can use this to build page navigation UI.

integer
current_page
required

The page number for the current set of items being returned. This is typically controlled by skip and limit or page and size query parameters.

integer
per_page
required

The maximum number of items configured to be returned on a single page. This is typically controlled by a limit query parameter.

integer
Example
{
  "data": [
    {
      "created_at": "2025-11-13T17:18:46.526980+01:00",
      "updated_at": null,
      "name": "default",
      "vad": false,
      "mode": "partial",
      "min_buffer": 1,
      "max_buffer": 3,
      "buffer_timeout": 3,
      "max_delay": 4,
      "max_chars": 40,
      "max_lines": 2,
      "id": 2
    },
    {
      "created_at": "2025-11-13T17:42:50.503270+01:00",
      "updated_at": null,
      "name": "Quiet Room Setup",
      "vad": false,
      "mode": "partial",
      "min_buffer": 1,
      "max_buffer": 2,
      "buffer_timeout": 3,
      "max_delay": 4,
      "max_chars": 40,
      "max_lines": 2,
      "id": 3
    }
  ],
  "pagination": {
    "total_items": 2,
    "total_pages": 1,
    "current_page": 1,
    "per_page": 100
  }
}