This document is for an older version of Kazoo (version 4.3) that is no longer supported. You should upgrade and read the current documentation.
Call Recordings
About Recordings
Recordings endpoint provides a way to access call recordings.
Fetch recordings
GET /v2/accounts/{ACCOUNT_ID}/recordings GET /v2/accounts/{ACCOUNT_ID}/users/{USER_ID}/recordings
Lists the call recording with pagination and filtering.
curl -v -X GET \
-H "X-Auth-Token: {AUTH_TOKEN}" \
http://{SERVER}:8000/v2/accounts/{ACCOUNT_ID}/recordings
Fetch recording media or document
GET /v2/accounts/{ACCOUNT_ID}/recordings/{RECORDING_ID}
Gets a specific recording document.
curl -v -X GET \
-H "X-Auth-Token: {AUTH_TOKEN}" \
http://{SERVER}:8000/v2/accounts/{ACCOUNT_ID}/recordings/{RECORDING_ID}
Gets a specific recording document attachment if available.
Mind the Accept
header in example below.
For clients that do not support setting the Accept
header, a query string parameter can be included: ?accept=audio/mpeg
.
Optional parameter inline
can be either true
or false
.
curl -v -X GET \
-H "X-Auth-Token: {AUTH_TOKEN}" \
-H "Accept: audio/mpeg" \
http://{SERVER}:8000/v2/accounts/{ACCOUNT_ID}/recordings/{RECORDING_ID}
Remove a recording
DELETE /v2/accounts/{ACCOUNT_ID}/recordings/{RECORDING_ID}
This will delete the metadata document. If the binary data is stored on the metadata document (instead of on a storage provider), it will also be deleted. Recordings stored on storage providers will not be deleted.
curl -v -X DELETE \
-H "X-Auth-Token: {AUTH_TOKEN}" \
http://{SERVER}:8000/v2/accounts/{ACCOUNT_ID}/recordings/{RECORDING_ID}