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

fetch('https://blackbox.dasha.ai/api/v1/media', 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>"
  }
]

Query Parameters

​
page
integer<int32>
default:1

Page number (1-based)

​
pageSize
integer<int32>
default:50

Items per page

Response

Returns media files successfully

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