Upload a Screen recording
POST /v1/recordings/{recordingId}/screen
Summary:
Upload and associate a screen recording (video) to an existing audio recording.
Security:
OAuth2 Client Credentials with scope
"voice-analytics/recordings.write"
.
Path Parameter:
recordingId
: The identifier of the existing audio recording.
Request Body:
JSON object including:
user: Object with required property
email
.fileName: (string) Name of the file (must include the
.webm
extension).fileSize: (integer) Size in bytes (max: 4 GB).
contentMd5: (string) Base64-encoded MD5 hash.
Example:
{
"user": { "email": "username@domain.com" },
"fileName": "file_Name.webm",
"fileSize": 45812,
"contentMd5": "Dz0RIM96f80wkhfXyg=="
}
Response:
200 OK:
Returns a JSON object with:
presignedUrl
: S3 presigned URL for PUT operation.400, 401, 403, 404, 409, 500: Various error codes with their descriptions.
File Upload Note:
The subsequent PUT request to the presigned URL must include the header content-md5
with the file’s base64-encoded MD5 hash.