> ## 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.

# Get agents using media

> Returns a list of agents that use the specified media file in their configuration.
Each agent entry includes the usage context (warmTransfer, coldTransfer, or ambientNoise)
indicating where the media is used.



## OpenAPI

````yaml https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/media/{id}/affected-agents
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/media/{id}/affected-agents:
    get:
      tags:
        - Media
      summary: Get agents using media
      description: >-
        Returns a list of agents that use the specified media file in their
        configuration.

        Each agent entry includes the usage context (warmTransfer, coldTransfer,
        or ambientNoise)

        indicating where the media is used.
      parameters:
        - name: id
          in: path
          description: Media file identifier
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Returns agents using media successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaAffectedAgentsResponseDto'
        '401':
          description: Authentication failed or API key is missing
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '404':
          description: Media file with specified ID does not exist
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '502':
          description: Upstream service error
        '503':
          description: Service temporarily unavailable
        '504':
          description: Request timeout
components:
  schemas:
    MediaAffectedAgentsResponseDto:
      required:
        - agents
      type: object
      properties:
        agents:
          type: array
          items:
            $ref: '#/components/schemas/MediaAffectedAgentDto'
          description: >-
            Agents configured to use this media file. When the media file is
            modified or deleted, these agents' transfer and ambient noise
            features will be affected. Review this list before making changes to
            understand the impact.
      additionalProperties: false
      description: >-
        List of agents using a specific media file, including context about how
        each agent uses the file. Useful for understanding the impact of
        modifying or deleting a media file, as changes will affect all listed
        agents' call handling behavior.
    ProblemDetails:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
      additionalProperties: {}
    MediaAffectedAgentDto:
      required:
        - id
        - name
        - usageContext
      type: object
      properties:
        id:
          minLength: 1
          type: string
          description: Unique identifier of the agent using the media file.
        name:
          minLength: 1
          type: string
          description: Display name of the agent using the media file.
        usageContext:
          minLength: 1
          type: string
          description: >-
            Feature context indicating how the agent uses this media file.
            Supported values: "warmTransfer" (hold music during warm transfers),
            "coldTransfer" (audio prompt during cold transfers), "ambientNoise"
            (background sound during conversations).
      additionalProperties: false
      description: >-
        Agent information showing which agents are using a media file and how
        they use it. Contains identifying information and usage context to help
        you understand the impact of media file changes on specific agent
        features.
  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

````