Skip to main content
Skip table of contents

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:

CODE
{
  "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.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.