Skip to Content
Call IngestionUpload Recording

Upload Recording

POST/api/v1/webhooks/calls/{callId}/audio
Uploads the recording of a call previously sent with Send Call as a file and queues the call for analysis.

If you cannot provide a publicly accessible URL for your recording (or the recording becomes available only after the call), first send the call with Send Call, then upload the audio file with this endpoint.

Path Parameters

FieldTypeRequiredDescription
callIdstringYesThe id value you sent in the Send Call request (the call ID in your system). This is not the ID generated by ThinkVoice.

Headers

FieldTypeRequiredDescription
X-Api-Keystring (GUID)YesAPI key provided by our team for your integration.
X-Api-Secretstring (GUID)YesAPI secret specific to your company.
Content-TypestringYesType of the audio file. Allowed values: audio/wav, audio/wave, audio/x-wav, audio/mpeg, audio/webm, application/octet-stream.

Request Body

The body is the raw (binary) content of the audio file; it is not JSON or form data.

Example cURL

curl --request POST 'https://public-api.thinkvoice.ai/api/v1/webhooks/calls/20260410-143512-00042/audio' \
--header 'X-Api-Key: <API_KEY>' \
--header 'X-Api-Secret: <API_SECRET>' \
--header 'Content-Type: audio/wav' \
--data-binary '@recording.wav'

Responses

200Success
{ "success": true, "message": "Audio processed successfully." }
404Call not found
{ "success": false, "message": "Call not found." }
MessageHTTPDescription
Audio body is empty.400The body is empty.
Unregistered Tenant.401X-Api-Key / X-Api-Secret is missing, invalid or disabled.
Call not found.404No call matches the callId. First make sure the Send Call request completed successfully.
Unsupported media type: ...415Content-Type is not one of the allowed types. The allowed types are listed in the message.
Failed to process audio file. ...500Unexpected error. Check the headers and body, then try again.

If you send application/octet-stream as the Content-Type, the file format is detected automatically from its content.

If the upload request is made before the call record exists, 404 is returned. Upload only after receiving a successful response from the Send Call request.

Last updated: