> ## 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 builtin media

> Retrieves the list of predefined builtin media files that can be used for agent features
like pre-conversation media playback. These are pre-uploaded to the platform.



## OpenAPI

````yaml https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/misc/builtin-media
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:
  - {}
  - {}
tags:
  - name: ActivityLogs
  - name: Agents
  - name: CallResults
  - name: Calls
  - name: Chats
  - 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/builtin-media:
    get:
      tags:
        - Misc
      summary: List predefined builtin media
      description: >-
        Retrieves the list of predefined builtin media files that can be used
        for agent features

        like pre-conversation media playback. These are pre-uploaded to the
        platform.
      responses:
        '200':
          description: Returns predefined builtin media files successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BuiltinMediaListResponseDto'
components:
  schemas:
    BuiltinMediaListResponseDto:
      required:
        - items
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/BuiltinMediaDto'
          description: >-
            Available predefined builtin media files with their identifiers,
            names, descriptions, URIs, and durations.

            Use the URI values when configuring agent features. Agents can also
            use custom uploaded media files

            in addition to these predefined media.
      additionalProperties: false
      description: >-
        List of predefined builtin media files available for agent
        configuration. These media files

        are pre-uploaded to the platform and can be used for features like
        pre-conversation media playback.
    BuiltinMediaDto:
      required:
        - description
        - durationSeconds
        - id
        - name
        - uri
      type: object
      properties:
        id:
          minLength: 1
          type: string
          description: >-
            Unique identifier for the builtin media file. Use this ID when
            configuring agent features.
        name:
          minLength: 1
          type: string
          description: Human-readable display name of the media file.
        description:
          minLength: 1
          type: string
          description: Description of the media file including its purpose and duration.
        uri:
          minLength: 1
          type: string
          description: >-
            Media URI referencing the builtin audio file. This is a
            system-managed URI that points to the

            predefined media resource. Use this URI value when configuring agent
            features like pre-conversation media.
        durationSeconds:
          type: number
          description: Duration of the audio file in seconds.
          format: double
      additionalProperties: false
      description: >-
        Predefined builtin media file available for agent configuration. Builtin
        media files are

        pre-uploaded to the platform and can be used for features like
        pre-conversation media playback.

````