Upload Audio File

This endpoint uploads a WAV audio file to cloud storage, with the option to include a configuration file (e.g., .txt or .json). The endpoint validates the file types and size, checks required request headers, and ensures that the upload date is not in the future. If a configuration file is provided, it is validated; if invalid, the default configuration is used instead. The uploaded file and configuration (if valid) are sent to cloud storage (Azure or Google, based on configuration).

Permissions

Permission Type	Permissions
Delegated/Authenticated Account	A valid Bearer token

HTTP Request

Use Beluga Box Upload API base URL

POST /api/blob/upload

Request Headers

Header	Value
Authorization	Bearer {token}
Content-Type	multipart/form-data
UserName	Required. Operator username for the uploaded file.
UploaderUserName	Required. Uploader username for the uploaded file.
CustomerId	Optional. Customer ID metadata for the uploaded file.
CustomerName	Optional. Customer Name metadata for the uploaded file.
KeyValue	Optional. Key Value metadata for the uploaded file.
Source	Optional. Source for the uploaded file (UPLOAD).
IsReplaceDefaultConfig	Optional. Option for replace default config file from uploaded configFile.
URL	Optional. URL for SSO

Request Body

Parameter	Data Type	Description
file	file	Required. The WAV audio file to upload.
configFile	file	Optional. The JSON file to upload's configuration file..

Response

On a successful request, the API returns an HTTP 202 Accepted status with a JSON object containing a submission response.

HTTP/1.1 202 Accepted
Content-Type: application/json

{
    "status": "success",
    "reason": "",
    "message": "",
    "submissionObject": "",
    "token": ""
}