Skip to main content
POST
/
scoring
/
submitRecording
cURL
curl --request POST \
  --url https://api.emberqa.com/api/scoring/submitRecording \
  --header 'Authorization: Bearer <token>' \
  --form 'file=@call-audio.mp3' \
  --form 'agent_name=Jane D' \
  --form 'is_inbound=true' \
  --form 'metadata={"example_property":"example_value","example_property2":"example_value2"}'
{
  "message": "File Accepted"
}

​
Audio Requirements

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

Authorizations

​
Authorization
string
header
required

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

Body

multipart/form-data
​
file
file
required

Audio file upload (MP3 or WAV, max 50MB)

​
agent_name
string

Name of the agent who handled the call

Example:

"Jane D"

​
language
string

Language code for the call audio. Defaults to English ("en") if not provided.

Example:

"en"

​
is_inbound
boolean | null
default:true

Boolean flag indicating whether the call was inbound. Defaults to true when omitted.

Example:

true

​
transcript_url
string<uri>

Optional publicly accessible URL to a plain text transcript file.

​
transcript_text
string

Optional inline plain text transcript.

Example:

"Speaker 0: Thank you for calling EmberQA.\nSpeaker 1: Hi, I need help with my order."

​
metadata
string

Optional stringified JSON metadata object.

Example: {"example_property":"example_value","example_property2":"example_value2"}

Response

File Accepted

​
message
string
Example:

"File Accepted"