Skip to main content
Server path: /genesys-recording | Type: Application | PCID required: Yes

Tools

ToolDescription
genesys_recording_delete_conversation_recording_annotationDelete annotation
genesys_recording_delete_crossplatform_mediaretentionpoliciesDelete media retention policies
genesys_recording_delete_crossplatform_mediaretentionpolicyDelete a media retention policy
genesys_recording_delete_jobDelete the recording bulk job
genesys_recording_delete_mediaretentionpoliciesDelete media retention policies
genesys_recording_delete_mediaretentionpolicyDelete a media retention policy
genesys_recording_delete_orphanrecordingDeletes a single orphan recording
genesys_recording_get_batchrequestGet the status and results for a batch request job, only the user that submitted the job may retrieve results. Each result may contain either a URL to a recording or an error; additionally, a recording could be associated with multiple results.
genesys_recording_get_conversation_recordingGets a specific recording.
genesys_recording_get_conversation_recording_annotationGet annotation
genesys_recording_get_conversation_recording_annotationsGet annotations for recording
genesys_recording_get_conversation_recordingmetadataGet recording metadata for a conversation. Does not return playable media nor system annotations. Bookmark annotations will be excluded if either recording:recording:view or recording:annotation:view permission is missing.
genesys_recording_get_conversation_recordingmetadata_recording_idGet metadata for a specific recording. Does not return playable media.
genesys_recording_get_conversation_recordingsGet all of a Conversation’s Recordings.
genesys_recording_get_crossplatform_mediaretentionpoliciesGets media retention policy list with query options to filter on name and enabled.
genesys_recording_get_crossplatform_mediaretentionpolicyGet a media retention policy
genesys_recording_get_jobGet the status of the job associated with the job id.
genesys_recording_get_job_failedrecordingsGet IDs of recordings that the bulk job failed for
genesys_recording_get_jobsGet the status of all jobs within the user’s organization
genesys_recording_get_mediaretentionpoliciesGets media retention policy list with query options to filter on name and enabled.
genesys_recording_get_mediaretentionpolicyGet a media retention policy
genesys_recording_get_orphanrecordingGets a single orphan recording
genesys_recording_get_orphanrecording_mediaGets the media of a single orphan recording
genesys_recording_get_orphanrecordingsGets all orphan recordings
genesys_recording_get_recordingkeysGet encryption key list
genesys_recording_get_recordingkeys_rotationscheduleGet key rotation schedule
genesys_recording_get_recordings_retention_queryQuery for recording retention data
genesys_recording_get_recordings_screensessions_detailsRetrieves an object containing the total number of concurrent active screen recordings
genesys_recording_get_settingsGet the Recording Settings for the Organization
genesys_recording_get_uploads_reportGet the status of a recording upload status report
genesys_recording_patch_crossplatform_mediaretentionpolicyPatch a media retention policy
genesys_recording_patch_mediaretentionpolicyPatch a media retention policy
genesys_recording_post_batchrequestsSubmit a batch download request for recordings. Recordings in response will be in their original format/codec - configured in the Trunk configuration.
genesys_recording_post_conversation_recording_annotationsCreate annotation
genesys_recording_post_crossplatform_mediaretentionpoliciesCreate media retention policy
genesys_recording_post_jobsCreate a recording bulk job.
genesys_recording_post_localkeyscreate a local key management recording key
genesys_recording_post_mediaretentionpoliciesCreate media retention policy
genesys_recording_post_recordingkeysCreate encryption key
genesys_recording_post_recordings_deletionprotectionGet a list of conversations with protected recordings
genesys_recording_post_recordings_screensessions_acknowledgeAcknowledge a screen recording.
genesys_recording_post_recordings_screensessions_metadataProvide meta-data a screen recording.
genesys_recording_post_uploads_reportsCreates a recording upload status report
genesys_recording_put_conversation_recordingUpdates the retention records on a recording.
genesys_recording_put_conversation_recording_annotationUpdate annotation
genesys_recording_put_crossplatform_mediaretentionpolicyUpdate a media retention policy
genesys_recording_put_jobExecute the recording bulk job.
genesys_recording_put_mediaretentionpolicyUpdate a media retention policy
genesys_recording_put_orphanrecordingUpdates an orphan recording to a regular recording with retention values
genesys_recording_put_recordingkeys_rotationscheduleUpdate key rotation schedule
genesys_recording_put_recordings_deletionprotectionApply or revoke recording protection for conversations
genesys_recording_put_settingsUpdate the Recording Settings for the Organization

genesys_recording_delete_conversation_recording_annotation

Delete annotation Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesConversation ID
recordingIdstringYesRecording ID
annotationIdstringYesAnnotation ID

genesys_recording_delete_crossplatform_mediaretentionpolicies

Delete media retention policies Parameters:
ParameterTypeRequiredDefaultDescription
idsstringYesids

genesys_recording_delete_crossplatform_mediaretentionpolicy

Delete a media retention policy Parameters:
ParameterTypeRequiredDefaultDescription
policyIdstringYesPolicy ID

genesys_recording_delete_job

Delete the recording bulk job Parameters:
ParameterTypeRequiredDefaultDescription
jobIdstringYesjobId

genesys_recording_delete_mediaretentionpolicies

Delete media retention policies Parameters:
ParameterTypeRequiredDefaultDescription
idsstringYesids

genesys_recording_delete_mediaretentionpolicy

Delete a media retention policy Parameters:
ParameterTypeRequiredDefaultDescription
policyIdstringYesPolicy ID

genesys_recording_delete_orphanrecording

Deletes a single orphan recording Parameters:
ParameterTypeRequiredDefaultDescription
orphanIdstringYesOrphan ID

genesys_recording_get_batchrequest

Get the status and results for a batch request job, only the user that submitted the job may retrieve results. Each result may contain either a URL to a recording or an error; additionally, a recording could be associated with multiple results. Parameters:
ParameterTypeRequiredDefaultDescription
jobIdstringYesjobId

genesys_recording_get_conversation_recording

Gets a specific recording. Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesConversation ID
recordingIdstringYesRecording ID
formatIdstringNoThe desired media format. Valid values:WAV,WEBM,WAV_ULAW,OGG_VORBIS,OGG_OPUS,MP3,NONE
emailFormatIdstringNoThe desired media format when downloading an email recording. Valid values:EML,NONE
chatFormatIdstringNoThe desired media format when downloading a chat recording. Valid values:ZIP,NONE
messageFormatIdstringNoThe desired media format when downloading a message recording. Valid values:ZIP,NONE
downloadbooleanNorequesting a download format of the recording. Valid values:true,false
fileNamestringNothe name of the downloaded fileName
localestringNoThe locale for the requested file when downloading or for redacting sensitive information in requested files, as an ISO 639-1 code
mediaFormatsany[]NoAll acceptable media formats. Overrides formatId. Valid values:WAV,WEBM,WAV_ULAW,OGG_VORBIS,OGG_OPUS,MP3

genesys_recording_get_conversation_recording_annotation

Get annotation Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesConversation ID
recordingIdstringYesRecording ID
annotationIdstringYesAnnotation ID

genesys_recording_get_conversation_recording_annotations

Get annotations for recording Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesConversation ID
recordingIdstringYesRecording ID

genesys_recording_get_conversation_recordingmetadata

Get recording metadata for a conversation. Does not return playable media nor system annotations. Bookmark annotations will be excluded if either recording:recording:view or recording:annotation:view permission is missing. Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesConversation ID

genesys_recording_get_conversation_recordingmetadata_recording_id

Get metadata for a specific recording. Does not return playable media. Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesConversation ID
recordingIdstringYesRecording ID

genesys_recording_get_conversation_recordings

Get all of a Conversation’s Recordings. Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesConversation ID
maxWaitMsintegerNoThe maximum number of milliseconds to wait for the recording to be ready. Must be a positive value.
formatIdstringNoThe desired media format. Valid values:WAV,WEBM,WAV_ULAW,OGG_VORBIS,OGG_OPUS,MP3,NONE.
mediaFormatsany[]NoAll acceptable media formats. Overrides formatId. Valid values:WAV,WEBM,WAV_ULAW,OGG_VORBIS,OGG_OPUS,MP3.
localestringNoThe locale used for redacting sensitive information in requested files, as an ISO 639-1 code
includePauseAnnotationsForScreenRecordingsbooleanNoInclude applicable Secure Pause annotations from all audio recordings to all screen recordings

genesys_recording_get_crossplatform_mediaretentionpolicies

Gets media retention policy list with query options to filter on name and enabled. Parameters:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNoThe total page size requested
pageNumberintegerNoThe page number requested
sortBystringNovariable name requested to sort by
expandany[]Novariable name requested by expand list
nextPagestringNonext page token
previousPagestringNoPrevious page token
namestringNothe policy name - used for filtering results in searches.
enabledbooleanNochecks to see if policy is enabled - use enabled = true or enabled = false
summarybooleanNoprovides a less verbose response of policy lists.
hasErrorsbooleanNoprovides a way to fetch all policies with errors or policies that do not have errors
deleteDaysThresholdintegerNoprovides a way to fetch all policies with any actions having deleteDays exceeding the provided value

genesys_recording_get_crossplatform_mediaretentionpolicy

Get a media retention policy Parameters:
ParameterTypeRequiredDefaultDescription
policyIdstringYesPolicy ID

genesys_recording_get_job

Get the status of the job associated with the job id. Parameters:
ParameterTypeRequiredDefaultDescription
jobIdstringYesjobId

genesys_recording_get_job_failedrecordings

Get IDs of recordings that the bulk job failed for Parameters:
ParameterTypeRequiredDefaultDescription
jobIdstringYesjobId
pageSizeintegerNoPage size. Maximum is 100.
pageNumberintegerNoPage number
includeTotalbooleanNoIf false, cursor will be used to locate the page instead of pageNumber. It is recommended to set it to false for improved performance.
cursorstringNoIndicates where to resume query results (not required for first page)

genesys_recording_get_jobs

Get the status of all jobs within the user’s organization Parameters:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNoPage size
pageNumberintegerNoPage number
sortBystringNoSort by
statestringNoFilter by state
showOnlyMyJobsbooleanNoShow only my jobs
jobTypestringNoJob Type (Can be left empty for both)
includeTotalbooleanNoIf false, cursor will be used to locate the page instead of pageNumber. It is recommended to set it to false for improved performance.
cursorstringNoIndicates where to resume query results (not required for first page)

genesys_recording_get_mediaretentionpolicies

Gets media retention policy list with query options to filter on name and enabled. Parameters:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNoThe total page size requested
pageNumberintegerNoThe page number requested
sortBystringNovariable name requested to sort by
expandany[]Novariable name requested by expand list
nextPagestringNonext page token
previousPagestringNoPrevious page token
namestringNothe policy name - used for filtering results in searches.
enabledbooleanNochecks to see if policy is enabled - use enabled = true or enabled = false
summarybooleanNoprovides a less verbose response of policy lists.
hasErrorsbooleanNoprovides a way to fetch all policies with errors or policies that do not have errors
deleteDaysThresholdintegerNoprovides a way to fetch all policies with any actions having deleteDays exceeding the provided value

genesys_recording_get_mediaretentionpolicy

Get a media retention policy Parameters:
ParameterTypeRequiredDefaultDescription
policyIdstringYesPolicy ID

genesys_recording_get_orphanrecording

Gets a single orphan recording Parameters:
ParameterTypeRequiredDefaultDescription
orphanIdstringYesOrphan ID

genesys_recording_get_orphanrecording_media

Gets the media of a single orphan recording Parameters:
ParameterTypeRequiredDefaultDescription
orphanIdstringYesOrphan ID
formatIdstringNoThe desired media format.
emailFormatIdstringNoThe desired media format when downloading an email recording.
chatFormatIdstringNoThe desired media format when downloading a chat recording.
messageFormatIdstringNoThe desired media format when downloading a message recording.
downloadbooleanNorequesting a download format of the recording
fileNamestringNothe name of the downloaded fileName
localestringNoThe locale for the requested file when downloading, as an ISO 639-1 code
mediaFormatsany[]NoAll acceptable media formats. Overrides formatId. Valid values:WAV,WEBM,WAV_ULAW,OGG_VORBIS,OGG_OPUS,MP3

genesys_recording_get_orphanrecordings

Gets all orphan recordings Parameters:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNoThe total page size requested
pageNumberintegerNoThe page number requested
sortBystringNovariable name requested to sort by
expandany[]Novariable name requested by expand list
nextPagestringNonext page token
previousPagestringNoPrevious page token
hasConversationbooleanNoFilter resulting orphans by whether the conversation is known. False returns all orphans for the organization.
mediastringNoFilter resulting orphans based on their media type

genesys_recording_get_recordingkeys

Get encryption key list Parameters:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNoPage size
pageNumberintegerNoPage number

genesys_recording_get_recordingkeys_rotationschedule

Get key rotation schedule

genesys_recording_get_recordings_retention_query

Query for recording retention data Parameters:
ParameterTypeRequiredDefaultDescription
retentionThresholdDaysintegerYesFetch retention data for recordings retained for more days than the provided value.
cursorstringNoIndicates where to resume query results (not required for first page)
pageSizeintegerNoPage size. Maximum is 500.

genesys_recording_get_recordings_screensessions_details

Retrieves an object containing the total number of concurrent active screen recordings

genesys_recording_get_settings

Get the Recording Settings for the Organization Parameters:
ParameterTypeRequiredDefaultDescription
createDefaultbooleanNoIf no settings are found, a new one is created with default values

genesys_recording_get_uploads_report

Get the status of a recording upload status report Parameters:
ParameterTypeRequiredDefaultDescription
reportIdstringYesreportId

genesys_recording_patch_crossplatform_mediaretentionpolicy

Patch a media retention policy Parameters:
ParameterTypeRequiredDefaultDescription
policyIdstringYesPolicy ID
enabledbooleanNoenabled

genesys_recording_patch_mediaretentionpolicy

Patch a media retention policy Parameters:
ParameterTypeRequiredDefaultDescription
policyIdstringYesPolicy ID
enabledbooleanNoenabled

genesys_recording_post_batchrequests

Submit a batch download request for recordings. Recordings in response will be in their original format/codec - configured in the Trunk configuration. Parameters:
ParameterTypeRequiredDefaultDescription
batchDownloadRequestListany[]YesList of up to 100 items requested

genesys_recording_post_conversation_recording_annotations

Create annotation Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesConversation ID
recordingIdstringYesRecording ID
absoluteDurationMsintegerNoDuration of annotation (milliseconds).
absoluteLocationintegerNoOffset of annotation (milliseconds) from start of recording (after removing the cumulative duration of all pauses).
annotationsany[]NoList of annotations
descriptionstringNoText of annotation. Maximum character limit is 500.
durationMsintegerNoDuration of annotation in milliseconds.
idstringNoAnnotation id. All pause annotations on a recording will share an ID value, bookmark annotations will have unique IDs, and hold annotations will have randomly generated UUIDs (i.e. the ID will change at each request).
locationintegerNoOffset of annotation in milliseconds.
namestringNoname
realtimeLocationintegerNoOffset of annotation (milliseconds) from start of the recording before removing the cumulative duration of all pauses before this annotation
reasonstringNoReason for a pause annotation. Valid values: Hold,SecurePause,FlowOrQueue,Pause
recordingDurationMsintegerNoDuration of annotation (milliseconds), adjusted for any recording cuts.
recordingLocationintegerNoOffset of annotation (milliseconds) from start of recording, adjusted for any recording cuts
selfUristringNoThe URI for this object
typestringNotype
userobjectNouser

genesys_recording_post_crossplatform_mediaretentionpolicies

Create media retention policy Parameters:
ParameterTypeRequiredDefaultDescription
actionsobjectNoactions
conditionsobjectNoconditions
createdDatestringNoDate time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
descriptionstringNodescription
enabledbooleanNoenabled
idstringNoThe globally unique identifier for the object.
mediaPoliciesobjectNomediaPolicies
modifiedDatestringNoDate time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
namestringYesThe policy name.
orderintegerNoorder
policyErrorsobjectNopolicyErrors
selfUristringNoThe URI for this object

genesys_recording_post_jobs

Create a recording bulk job. Parameters:
ParameterTypeRequiredDefaultDescription
actionstringYesOperation to perform bulk task. If the operation will cause the delete date of a recording to be older than the export date, the export date will be adjusted to the delete date.
actionAgeintegerNoThe number of days after each recording’s creation date when the action will be performed. If screenRecordingActionAge is also provided, this value is only used for non-screen recordings. Otherwise this value is used for all recordings.
actionDatestringNoThe date when the action will be performed. If screenRecordingActionDate is also provided, this value is only used for non-screen recordings. Otherwise this value is used for all recordings. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
agedConversationIntervalstringNoAs an alternative to conversationQuery, specify the date and time range of conversations that are older than 5 years to query.Results will include all conversations that had activity during the interval. This is supported only when querying for conversations older than 5 years;conversationQuery must not be provided when this is provided. Intervals are represented as an ISO-8601 string. For example: YYYY-MM-DDThh:mm:ss/YYYY-MM-DDThh:mm:ss.Interval duration must not exceed 6 months. Intervals are represented as an ISO-8601 string. For example: YYYY-MM-DDThh:mm:ss/YYYY-MM-DDThh:mm:ss
clearExportbooleanNoFor DELETE action, setting this to true will clear any pending exports for recordings. This field is only used for DELETE action. Default value = false
conversationQueryobjectNoconversationQuery
includeRecordingsWithSensitiveDatabooleanNoWhether to include recordings with PCI DSS and/or PII data, default value = false
includeScreenRecordingsbooleanNoWhether to include Screen recordings for the action, default value = true
integrationIdstringNoIntegrationId to Access AWS S3 bucket for bulk recording exports. This field is required and used only for EXPORT action.
screenRecordingActionAgeintegerNoThe number of days after each screen recording’s creation date when the action will be performed. If this is provided then includeScreenRecordings must be true.
screenRecordingActionDatestringNoThe date when the action will be performed for screen recordings. If this is provided then includeScreenRecordings must be true. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z

genesys_recording_post_localkeys

create a local key management recording key Parameters:
ParameterTypeRequiredDefaultDescription
configIdstringYesThe local configuration id that contains metadata on private local service
keypairIdstringYesThe key pair id from the local service.
publicKeystringYesBase 64 encoded public key, generated by the local service.

genesys_recording_post_mediaretentionpolicies

Create media retention policy Parameters:
ParameterTypeRequiredDefaultDescription
actionsobjectNoactions
conditionsobjectNoconditions
createdDatestringNoDate time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
descriptionstringNodescription
enabledbooleanNoenabled
idstringNoThe globally unique identifier for the object.
mediaPoliciesobjectNomediaPolicies
modifiedDatestringNoDate time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
namestringYesThe policy name.
orderintegerNoorder
policyErrorsobjectNopolicyErrors
selfUristringNoThe URI for this object

genesys_recording_post_recordingkeys

Create encryption key

genesys_recording_post_recordings_deletionprotection

Get a list of conversations with protected recordings Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdsany[]YesThis is a list of ConversationIds. The list cannot exceed 100 conversationids.

genesys_recording_post_recordings_screensessions_acknowledge

Acknowledge a screen recording. Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringNoconversationId
participantJidstringNoparticipantJid
roomIdstringNoroomId

genesys_recording_post_recordings_screensessions_metadata

Provide meta-data a screen recording. Parameters:
ParameterTypeRequiredDefaultDescription
metaDataany[]NometaData
participantJidstringNoparticipantJid
roomIdstringNoroomId

genesys_recording_post_uploads_reports

Creates a recording upload status report Parameters:
ParameterTypeRequiredDefaultDescription
dateSincestringYesReport will include uploads since this date. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
uploadStatusstringNoReport will include uploads with this status

genesys_recording_put_conversation_recording

Updates the retention records on a recording. Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesConversation ID
recordingIdstringYesRecording ID
clearExportbooleanNoWhether to clear the pending export for the recording
actualTranscodeTimeMsintegerNoactualTranscodeTimeMs
annotationsany[]NoAnnotations that belong to the recording.
archiveDatestringNoThe date the recording will be archived. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
archiveMediumstringNoThe type of archive medium used. Example: CloudArchive
creationTimestringNoThe creation time of the recording. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
deleteDatestringNoThe date the recording will be deleted. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
emailTranscriptany[]NoRepresents an email transcript
endTimestringNoThe end time of the recording. Null when there is no playable media.
estimatedTranscodeTimeMsintegerNoestimatedTranscodeTimeMs
exportDatestringNoThe date the recording will be exported. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
exportedDatestringNoThe date the recording was exported. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
fileStatestringNoRepresents the current file state for a recording. Examples: Uploading, Archived, etc
idstringNoThe globally unique identifier for the object.
maxAllowedRestorationsForOrgintegerNoHow many archive restorations the organization is allowed to have. Deprecated - Always returns 10000 since the restoration limit is no longer enforced.
mediastringNoThe media type of the recording. This could be audio, chat, messaging, email, or screen.
mediaSubjectstringNoThe media subject of the recording.
mediaSubtypestringNoThe media subtype of the recording.
mediaUrisobjectNoThe different mediaUris for the recording. Null when there is no playable media.
messagingTranscriptany[]NoRepresents a messaging transcript
namestringNoname
originalRecordingStartTimestringNoThe start time of the full recording, before any segment access restrictions are applied. Null when there is no playable media. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
outputDurationMsintegerNoDuration of transcoded media in milliseconds
outputSizeInBytesintegerNoSize of transcoded media in bytes. 0 if there is no transcoded media.
pathstringNopath
recordingErrorStatusstringNoStatus of a recording that cannot be returned because of an error
recordingFileRolestringNoRole of the file recording. It can be either customer_experience or adhoc.
remainingRestorationsAllowedForOrgintegerNoThe remaining archive restorations the organization has. Deprecated - Always returns 10000 since the restoration limit is no longer enforced.
restoreExpirationTimestringNoThe amount of time a restored recording will remain restored before being archived again. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
selfUristringNoThe URI for this object
sessionIdstringNoThe session id represents an external resource id, such as email, call, chat, etc
startTimestringNoThe start time of the recording. Null when there is no playable media.
transcriptany[]NoRepresents a chat transcript
usersany[]NoThe users participating in the conversation

genesys_recording_put_conversation_recording_annotation

Update annotation Parameters:
ParameterTypeRequiredDefaultDescription
conversationIdstringYesConversation ID
recordingIdstringYesRecording ID
annotationIdstringYesAnnotation ID
absoluteDurationMsintegerNoDuration of annotation (milliseconds).
absoluteLocationintegerNoOffset of annotation (milliseconds) from start of recording (after removing the cumulative duration of all pauses).
annotationsany[]NoList of annotations
descriptionstringNoText of annotation. Maximum character limit is 500.
durationMsintegerNoDuration of annotation in milliseconds.
idstringNoAnnotation id. All pause annotations on a recording will share an ID value, bookmark annotations will have unique IDs, and hold annotations will have randomly generated UUIDs (i.e. the ID will change at each request).
locationintegerNoOffset of annotation in milliseconds.
namestringNoname
realtimeLocationintegerNoOffset of annotation (milliseconds) from start of the recording before removing the cumulative duration of all pauses before this annotation
reasonstringNoReason for a pause annotation. Valid values: Hold,SecurePause,FlowOrQueue,Pause
recordingDurationMsintegerNoDuration of annotation (milliseconds), adjusted for any recording cuts.
recordingLocationintegerNoOffset of annotation (milliseconds) from start of recording, adjusted for any recording cuts
selfUristringNoThe URI for this object
typestringNotype
userobjectNouser

genesys_recording_put_crossplatform_mediaretentionpolicy

Update a media retention policy Parameters:
ParameterTypeRequiredDefaultDescription
policyIdstringYesPolicy ID
actionsobjectNoactions
conditionsobjectNoconditions
createdDatestringNoDate time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
descriptionstringNodescription
enabledbooleanNoenabled
idstringNoThe globally unique identifier for the object.
mediaPoliciesobjectNomediaPolicies
modifiedDatestringNoDate time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
namestringNoname
orderintegerNoorder
policyErrorsobjectNopolicyErrors
selfUristringNoThe URI for this object

genesys_recording_put_job

Execute the recording bulk job. Parameters:
ParameterTypeRequiredDefaultDescription
jobIdstringYesjobId
statestringYesThe desired state for the job to be set to.

genesys_recording_put_mediaretentionpolicy

Update a media retention policy Parameters:
ParameterTypeRequiredDefaultDescription
policyIdstringYesPolicy ID
actionsobjectNoactions
conditionsobjectNoconditions
createdDatestringNoDate time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
descriptionstringNodescription
enabledbooleanNoenabled
idstringNoThe globally unique identifier for the object.
mediaPoliciesobjectNomediaPolicies
modifiedDatestringNoDate time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
namestringNoname
orderintegerNoorder
policyErrorsobjectNopolicyErrors
selfUristringNoThe URI for this object

genesys_recording_put_orphanrecording

Updates an orphan recording to a regular recording with retention values Parameters:
ParameterTypeRequiredDefaultDescription
orphanIdstringYesOrphan ID
archiveDatestringNoThe orphan recording’s archive date. Must be greater than 1 day from now if set. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
conversationIdstringNoA conversation Id that this orphan’s recording is to be attached to. If not present, the conversationId will be deduced from the recording media.
deleteDatestringNoThe orphan recording’s delete date. Must be greater than archiveDate and exportDate if set, otherwise one day from now. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
exportDatestringNoThe orphan recording’s export date. Must be greater than 1 day from now if set. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
integrationIdstringNoIntegrationId to access AWS S3 bucket for export. This field is required if exportDate is set.

genesys_recording_put_recordingkeys_rotationschedule

Update key rotation schedule Parameters:
ParameterTypeRequiredDefaultDescription
idstringNoThe globally unique identifier for the object.
namestringNoname
periodstringYesValue to set schedule to
selfUristringNoThe URI for this object

genesys_recording_put_recordings_deletionprotection

Apply or revoke recording protection for conversations Parameters:
ParameterTypeRequiredDefaultDescription
protectbooleanNoCheck for apply, uncheck for revoke (each action requires the respective permission)
conversationIdsany[]NoThis is a list of ConversationIds. The list cannot exceed 100 conversationids.

genesys_recording_put_settings

Update the Recording Settings for the Organization Parameters:
ParameterTypeRequiredDefaultDescription
maxConfigurableScreenRecordingStreamsintegerNoUpper limit that maxSimultaneousStreams can be configured
maxSimultaneousStreamsintegerNoMaximum number of simultaneous screen recording streams
recordingBatchDownloadUrlTtlintegerNoThe duration in minutes for which the generated URL for recording batch download remains valid.The default duration is set to 60 minutes, with a minimum allowable duration of 2 minutes and a maximum of 60 minutes.
recordingPlaybackUrlTtlintegerNoThe duration in minutes for which the generated URL for recording playback remains valid.The default duration is set to 60 minutes, with a minimum allowable duration of 2 minutes and a maximum of 60 minutes.
regionalRecordingStorageEnabledbooleanNoStore call recordings in the region where they are intended to be recorded, otherwise in the organization’s home region