Redirect to the Recording File

📘
Supported Regions and Base URLs

👍
Access and Registration
Authentication

Scope

recordings:read

Body Response - Schema

200 (a HAL link for the recording file, when the requested content type is application/hal+json. You can specify the request content by providing the value in the ‘Accept’ header)

Parameter Type Description Required

_links

object

Parameter	Type	Description	Required
_links	object	"_links" subdivides into: 1 - "self" (object), which subdivides into: 1.1 - "href" (string) - default: `http://api-docs.talkdesk.org/recordings/:id/media` 2 - "file" (object), which subdivides into: 2.1 - "href" (string) - default:`http://api-docs.talkdesk.org/interactions/:interaction_id/recordings/:recording_id/content?token=some.token.signed`	yes (name and description)

"_links" subdivides into:

1 - "self" (object), which subdivides into:
1.1 - "href" (string) - default:
http://api-docs.talkdesk.org/recordings/:id/media

2 - "file" (object), which subdivides into:
2.1 - "href" (string) - default:http://api-docs.talkdesk.org/interactions/:interaction_id/recordings/:recording_id/content?token=some.token.signed

yes (name and description)

300 (redirect to the recording file)

Headers

Location (string) - recording location. Default: http://api-docs.talkdesk.org/interactions/:interaction_id/recordings/:recording_id/content?token=some.token.signed

401 (unauthorized), 403 (forbidden access), 404 (recording not found), 410 (recording's media file deleted)

Parameter	Type	Description	Required
code	string	n/a	yes
message	string	n/a	yes
description	string	n/a	no
fields	array[object]	"fields" subdivides into: "name" (string) "description" (string)	yes (name and description)

❗️
API Limitation
Screen Recording is not included.

🚧
Troubleshooting
If you have any questions regarding the usage of this API, or if you’re having any technical issues, please open a ticket using this form.