Skip to main content
GET
/
api
/
v1
/
media
/
{id}
Get media file
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://blackbox.dasha.ai/api/v1/media/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "fileName": "<string>",
  "originalFileName": "<string>",
  "fileSizeBytes": 123,
  "contentType": "<string>",
  "createdTime": "2023-11-07T05:31:56Z",
  "description": "<string>"
}

Path Parameters

​
id
string<uuid>
required

Media file identifier

Response

Returns media file metadata successfully

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.

​
id
string<uuid>
required

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.

​
fileName
string
required

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.

Minimum string length: 1
​
originalFileName
string
required

Original filename as provided during upload. Preserved for display purposes and to help identify the file in the user interface.

Minimum string length: 1
​
fileSizeBytes
integer<int64>
required

File size in bytes. Useful for storage management and estimating bandwidth requirements when the file is played during calls.

​
contentType
string
required

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.

Minimum string length: 1
​
createdTime
string<date-time>
required

Timestamp when the media file was originally uploaded to the system.

​
description
string | null

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.