Upload Prompt

POST

https://platform-api.convirza.com/v3/media-prompts

Media Prompts

Last modified:2026-07-24 13:10:44

Uploads an audio file for call flow recording and stores metadata in the database.

Supported recording types:

prompt: IVR prompts and menu options.

whisper: Agent whisper messages.

voicemail: Voicemail greetings.

survey: Call survey questions.

File requirements:

Maximum file size: 50MB.

Allowed formats: wav, mp3, mp4, ogg, webm, m4a, aac, flac.

File is stored with unique filename to prevent collisions.

Request validation:

name must be unique within the organization unit.

org_unit_id must reference an existing organization.

message_type must be one of the supported types.

Response:

Returns recording ID, file path, and upload confirmation.

Includes metadata for immediate use in call flows.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params multipart/form-dataRequired

Responses

🟢201

application/json

File uploaded successfully

Bodyapplication/json

🟠400

🟠401

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://platform-api.convirza.com/v3/media-prompts' \
--header 'Authorization: Bearer <token>' \
--form 'name="Welcome Message"' \
--form 'file=@""' \
--form 'message_type="prompt"' \
--form 'recording_file_type="uploaded"' \
--form 'recording_created_by="456"'

Response Example

201 - Example 1

{
    "code": 200,
    "message": "Success",
    "data": {
        "media_prompt_id": 12345,
        "url": "/uploads/call-flow-recordings/welcome-message.wav",
        "filename": "Welcome Message",
        "recording_name": "file-1774815772438-335827217"
    },
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-01-20T12:34:56.789Z"
}

Modified at 2026-07-24 13:10:44

Get Prompt by ID

Delete Prompt