> ## Documentation Index
> Fetch the complete documentation index at: https://blackbox.dasha.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List predefined background sounds

> Retrieves the list of predefined background sounds that can be configured for agents to play during calls.
Background sounds help create a more natural call environment by adding ambient audio.



## OpenAPI

````yaml https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc/background-sounds
openapi: 3.0.4
info:
  title: Dasha BlackBox Agent API
  description: API for managing AI agents and calls
  contact:
    name: DashaAI Team
    email: support@dasha.ai
  version: v1
servers:
  - url: https://blackbox.dasha.ai
    description: Dasha BlackBox Agent API
security:
  - ApiKey: []
  - OAuth: []
tags:
  - name: ActivityLogs
  - name: Agents
  - name: AgentTestCases
  - name: CallResults
  - name: Calls
  - name: Chats
  - name: Copilot
  - name: CustomerData
  - name: Mcp
  - name: Media
  - name: Misc
  - name: PronunciationDictionaries
  - name: Providers
  - name: SipAliases
  - name: SipCredentials
  - name: SipPhoneNumbers
  - name: TextChat
  - name: TwilioProvider
  - name: Voice
  - name: WebhookTest
  - name: WebIntegrations
  - name: WebSocket
    description: WebSocket endpoints for real-time communication
paths:
  /api/v1/misc/background-sounds:
    get:
      tags:
        - Misc
      summary: List predefined background sounds
      description: >-
        Retrieves the list of predefined background sounds that can be
        configured for agents to play during calls.

        Background sounds help create a more natural call environment by adding
        ambient audio.
      responses:
        '200':
          description: Returns predefined background sounds successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BackgroundSoundsListResponseDto'
components:
  schemas:
    BackgroundSoundsListResponseDto:
      required:
        - items
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/BackgroundSoundDto'
          description: >-
            Available predefined background sounds with their identifiers,
            names, descriptions, and URIs. Use the URI values when configuring
            the ambient noise feature for agents. Agents can also use custom
            uploaded media files in addition to these predefined sounds.
      additionalProperties: false
      description: >-
        List of predefined background sounds available for creating ambient
        atmosphere during agent calls. These sounds can be configured in the
        agent's ambient noise feature to make conversations sound more natural
        by adding environmental audio.
    BackgroundSoundDto:
      required:
        - description
        - id
        - name
        - uri
      type: object
      properties:
        id:
          minLength: 1
          type: string
          description: >-
            Unique identifier for the background sound. Use this ID when
            configuring the ambient noise feature for agents.
        name:
          minLength: 1
          type: string
          description: >-
            Human-readable display name of the background sound. Used for
            presenting the sound option in user interfaces and configuration
            screens.
        description:
          minLength: 1
          type: string
          description: >-
            Description of the ambient atmosphere this sound creates. Helps
            users understand what kind of environment the background sound
            simulates.
        uri:
          minLength: 1
          type: string
          description: >-
            Media URI referencing the background sound audio file. This is a
            system-managed URI that points to the predefined sound resource.
            When configuring agents, use this URI value for the ambient noise
            background sound setting.
      additionalProperties: false
      description: >-
        Predefined background sound that can be played during agent calls to
        create ambient atmosphere. Background sounds help create a more natural
        call environment by adding ambient audio like café noise, office sounds,
        or outdoor ambiance during conversations.
  securitySchemes:
    ApiKey:
      type: http
      description: API Key Authentication (Bearer {key})
      scheme: Bearer
    OAuth:
      type: oauth2
      flows:
        implicit:
          authorizationUrl: https://auth.dasha.ai/connect/authorize
          scopes:
            platform_api: Platform API

````