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.

Last updated: February 26, 2025