Skip to main content

Create a HotMark on a Recording

Creates a new HotMark on the specified recording. 

Authorizations: Recordings - EDIT

Requests

POST /apis/recordings/:recordingId/hotmarks
{
"timestamp": 2000,
"title": "HotMark1",
"description": "Training Session"
}

Response

Success

{
"data": {
  "timestamp": 2000,
  "title": "HotMark1",
  "description": "Training Session",
  "id": "ed6397d0-e947-4604-84f2-96b9ca68d72a"
  "username":"jsmith",
  "userDisplayName":"John Smith"
}
}

Parameters

Property

JSON Type

Property Type

Description

id

String

Immutable

Identifies the HotMark. Generated by HMP.

timestamp

Number

Required for videos.

Optional (for POST) for active recordings.

Time in milliseconds to which the HotMark is set. Defaults to current timestamp for active recordings.

Note

HotMark timestamps have a one-second resolution.

title

String

Required

Title of the HotMark.

description

String

Optional

Description of the HotMark.

username

String

Immutable

The user's login name, e.g., bsmith

userDisplayName

String

Ignored

The user’s friendly name, e.g., Bob Smith

Error

Code

Payload

 Description

404
{"code":"040001","name":"RecordingNotFound",
"message":"Active recording not found",
"httpStatusCode":404}

Recording with UUID recordingId not found.

400
{"code":"010001", "name":"InputValidation",
"message":<Error message>, "httpStatusCode":400}

Supplied data was insufficient or incorrect.

409
{"code":"060004", "name":"HotmarkAlreadyExists",
"message": "HotMark already exists at this time",
"httpStatusCode": 409}

HotMark already exists at this timestamp.

404
{"code":"010004", "name":"NoRecordingActive",
"message":"'Y' is not an active  recording",
"httpStatusCode": 404}

Active recording not found.

JavaScript errors detected

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

If this problem persists, please contact our support.