---
title: "List immutable audio-environment presets"
method: GET
path: "/v1/audio-environments"
---

# List immutable audio-environment presets

`GET /v1/audio-environments`

## Request

- Base URL: `https://api.skysay.ai`
- URL: `https://api.skysay.ai/v1/audio-environments`
- Auth: none declared

Returns the backend-owned, versioned catalogue used by Voice Library, agent voice configuration, preview auditions and Simulation Lab. The catalogue is a pure local read: it contacts no TTS provider, makes no carrier call, changes no agent setting and returns no audio bytes. `off` is explicit. An agent's outgoing selection always pins preset id, asset version and volume; Simulation Lab's separate caller-input condition pins the same id/version with noise_level. Callers must not invent a frontend catalogue, silently substitute a retired version, or pass output ambience to STT.

## Response `200`

Versioned audio-environment catalogue

- AudioEnvironmentCatalogue
  - `catalogue_version` 'v1', required
  - `presets` object[], required
    - `asset_version` string, required
    - `content_note` string
    - `description` string, required
    - `duration_ms` integer
    - `name` string, required
    - `preset_id` string, required
    - `volume` object, required
      - `default` integer, required
      - `maximum` integer, required
      - `minimum` integer, required
  - `schema` 'skysay.audio_environment_catalog.v1', required

## Other responses

- `503`: Packaged immutable catalogue is unavailable or incomplete

---

[API](https://skmtc.dev/skysay/apis/skysay-api.md) · [All operations](https://skmtc.dev/skysay/apis/skysay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skysay/apis/skysay-api/revisions/148c7e111260?raw)