Skip to main content
POST
/
api
/
v1
/
voc
/
tenants
/
{tenantId}
/
recording
Upload a recording for VOC processing
curl --request POST \
  --url https://platform.crescendo.ai/api/v1/voc/tenants/{tenantId}/recording \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'metadata=<string>' \
  --form audio='@example-file' \
  --form file='@example-file'
{
  "id": "job-voc-001"
}
Upload a recording and metadata to start asynchronous VOC processing.

​
Requirements

  • Audio must be mp3 or wav
  • Max size: 25 MB
  • metadata.id must contain only letters, numbers, dots, dashes, or underscores

​
Example: upload with curl

export CRESCENDO_TENANT_ID="tenant-alpha"
export CRESCENDO_API_KEY="YOUR_API_KEY"

curl -sS -X POST \
  -H "Authorization: Bearer $CRESCENDO_API_KEY" \
  -F "audio=@./call.mp3;type=audio/mpeg" \
  -F 'metadata={"id":"call-123","kind":"phonecall","source":"your-system"}' \
  "https://platform.crescendo.ai/api/v1/voc/tenants/$CRESCENDO_TENANT_ID/recording"
The response is 202 Accepted and returns a job ID: 
{ "id": "job-voc-001" }

​
Next: poll for status

Use the returned job ID with VOC recording status.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
tenantId
string
required

Tenant identifier.

Body

multipart/form-data
​
metadata
string
required

JSON string containing recording metadata. Must include id.

​
audio
file

Audio file (mp3 or wav).

​
file
file

Alternative field name for the audio file (mp3 or wav).

Response

Accepted

​
id
string
required