Skip to main content
POST
/
scoring
/
submitRecording
Submit Call Recording
curl --request POST \
  --url https://api.emberqa.com/api/scoring/submitRecording \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "agent_name": "John D",
  "media_url": "https://example.com/call-audio.mp3",
  "metadata": {
    "key1": "value1",
    "key2": "value2"
  },
  "language": "en",
  "supporting_docs": [
    "https://example.com/crm-information.pdf",
    "https://example.com/customer-notes.txt"
  ]
}'
{
  "message": "File Accepted"
}

​
Audio Requirements

Before submitting recordings, ensure they meet these requirements:
  • Supported formats: MP3, WAV
  • Maximum file size: 20MB
  • Audio quality: Minimum 8kHz sample rate recommended

Authorizations

​
Authorization
string
header
required

API key obtained from the EmberQA dashboard under the "Integrations" tab

Body

application/json
​
media_url
string<uri>
required

Publicly accessible URL to the audio file (MP3 or WAV, max 20MB)

Example:

"https://example.com/call-audio.mp3"

​
agent_name
string

Name of the agent who handled the call

Example:

"John D"

​
metadata
object

Key-value pairs for additional call metadata

Example:
{
  "customer_id": "12345",
  "call_type": "support",
  "department": "technical"
}
​
language
string
default:en

Language code for the call audio. Defaults to English ("en") if not provided. Use ISO 639-1 language codes, except for Mandarin which uses ISO 639-3 code "cmn". See supported languages list in documentation.

Example:

"en"

​
supporting_docs
string<uri>[]

Array of publicly accessible URLs to supporting documents. Supported file types: PDF (.pdf), Text (.txt), Images (.jpg)

Example:
[
  "https://example.com/crm-information.pdf",
  "https://example.com/customer-notes.txt",
  "https://example.com/screenshot.jpg"
]

Response

File Accepted

​
message
string
Example:

"File Accepted"