> ## 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. # Update media file > Updates the description of an existing media file. This is a partial update (PATCH) that only modifies the description field. Set description to null or empty string to clear it. ## OpenAPI ````yaml https://blackbox.dasha.ai/swagger/v1/swagger.json patch /api/v1/media/{id} 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}: patch: tags: - Media summary: Update media file description: >- Updates the description of an existing media file. This is a partial update (PATCH) that only modifies the description field. Set description to null or empty string to clear it. parameters: - name: id in: path description: Media file identifier required: true schema: type: string format: uuid requestBody: description: Update request with new description content: application/json: schema: allOf: - $ref: '#/components/schemas/MediaFilePatchRequestDto' description: >- Request to update media file metadata. Currently supports modifying the description field only. The file content itself cannot be changed; to use a different file, upload a new one and update agent configurations accordingly. Setting description to null or empty string clears the existing description. text/json: schema: allOf: - $ref: '#/components/schemas/MediaFilePatchRequestDto' description: >- Request to update media file metadata. Currently supports modifying the description field only. The file content itself cannot be changed; to use a different file, upload a new one and update agent configurations accordingly. Setting description to null or empty string clears the existing description. application/*+json: schema: allOf: - $ref: '#/components/schemas/MediaFilePatchRequestDto' description: >- Request to update media file metadata. Currently supports modifying the description field only. The file content itself cannot be changed; to use a different file, upload a new one and update agent configurations accordingly. Setting description to null or empty string clears the existing description. responses: '200': description: Media file updated successfully content: application/json: schema: $ref: '#/components/schemas/MediaFileResponseDto' '400': description: Invalid request or description too long content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '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: MediaFilePatchRequestDto: type: object properties: description: maxLength: 1000 type: string description: >- Updated description for the media file. Set to null or empty string to remove the existing description. Useful for updating file documentation as usage evolves or correcting information without re-uploading the file. nullable: true additionalProperties: false description: >- Request to update media file metadata. Currently supports modifying the description field only. The file content itself cannot be changed; to use a different file, upload a new one and update agent configurations accordingly. Setting description to null or empty string clears the existing description. MediaFileResponseDto: required: - contentType - createdTime - fileName - fileSizeBytes - id - originalFileName type: object properties: id: type: string description: >- Unique identifier for this media file. Use this ID when configuring agents to reference the file for warm transfers, cold transfers, or ambient noise features. format: uuid fileName: minLength: 1 type: string description: >- Server-assigned filename used for internal storage. This may differ from the original filename and is generated to ensure uniqueness and avoid conflicts in the storage system. originalFileName: minLength: 1 type: string description: >- Original filename as provided during upload. Preserved for display purposes and to help identify the file in the user interface. fileSizeBytes: type: integer description: >- File size in bytes. Useful for storage management and estimating bandwidth requirements when the file is played during calls. format: int64 contentType: minLength: 1 type: string description: >- MIME content type detected from the uploaded file. Common values include "audio/mpeg" for MP3 files, "audio/wav" for WAV files, and "audio/flac" for FLAC files. Used for proper content handling and playback. createdTime: type: string description: Timestamp when the media file was originally uploaded to the system. format: date-time description: type: string description: >- Description of the media file's purpose or content. Helps identify and organize files when managing multiple media files for different use cases. Null when no description has been provided. nullable: true additionalProperties: false description: >- Media file information including metadata, storage details, and usage context. Contains all data needed to reference the file in agent configurations and track its properties and lifecycle. 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: {} 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 ````