/genesys-recording | Type: Application | PCID required: Yes
Tools
| Tool | Description |
|---|---|
genesys_recording_delete_conversation_recording_annotation | Delete annotation |
genesys_recording_delete_crossplatform_mediaretentionpolicies | Delete media retention policies |
genesys_recording_delete_crossplatform_mediaretentionpolicy | Delete a media retention policy |
genesys_recording_delete_job | Delete the recording bulk job |
genesys_recording_delete_mediaretentionpolicies | Delete media retention policies |
genesys_recording_delete_mediaretentionpolicy | Delete a media retention policy |
genesys_recording_delete_orphanrecording | Deletes a single orphan recording |
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. |
genesys_recording_get_conversation_recording | Gets a specific recording. |
genesys_recording_get_conversation_recording_annotation | Get annotation |
genesys_recording_get_conversation_recording_annotations | Get annotations for recording |
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. |
genesys_recording_get_conversation_recordingmetadata_recording_id | Get metadata for a specific recording. Does not return playable media. |
genesys_recording_get_conversation_recordings | Get all of a Conversation’s Recordings. |
genesys_recording_get_crossplatform_mediaretentionpolicies | Gets media retention policy list with query options to filter on name and enabled. |
genesys_recording_get_crossplatform_mediaretentionpolicy | Get a media retention policy |
genesys_recording_get_job | Get the status of the job associated with the job id. |
genesys_recording_get_job_failedrecordings | Get IDs of recordings that the bulk job failed for |
genesys_recording_get_jobs | Get the status of all jobs within the user’s organization |
genesys_recording_get_mediaretentionpolicies | Gets media retention policy list with query options to filter on name and enabled. |
genesys_recording_get_mediaretentionpolicy | Get a media retention policy |
genesys_recording_get_orphanrecording | Gets a single orphan recording |
genesys_recording_get_orphanrecording_media | Gets the media of a single orphan recording |
genesys_recording_get_orphanrecordings | Gets all orphan recordings |
genesys_recording_get_recordingkeys | Get encryption key list |
genesys_recording_get_recordingkeys_rotationschedule | Get key rotation schedule |
genesys_recording_get_recordings_retention_query | Query for recording retention data |
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 |
genesys_recording_get_uploads_report | Get the status of a recording upload status report |
genesys_recording_patch_crossplatform_mediaretentionpolicy | Patch a media retention policy |
genesys_recording_patch_mediaretentionpolicy | Patch a media retention policy |
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. |
genesys_recording_post_conversation_recording_annotations | Create annotation |
genesys_recording_post_crossplatform_mediaretentionpolicies | Create media retention policy |
genesys_recording_post_jobs | Create a recording bulk job. |
genesys_recording_post_localkeys | create a local key management recording key |
genesys_recording_post_mediaretentionpolicies | Create media retention policy |
genesys_recording_post_recordingkeys | Create encryption key |
genesys_recording_post_recordings_deletionprotection | Get a list of conversations with protected recordings |
genesys_recording_post_recordings_screensessions_acknowledge | Acknowledge a screen recording. |
genesys_recording_post_recordings_screensessions_metadata | Provide meta-data a screen recording. |
genesys_recording_post_uploads_reports | Creates a recording upload status report |
genesys_recording_put_conversation_recording | Updates the retention records on a recording. |
genesys_recording_put_conversation_recording_annotation | Update annotation |
genesys_recording_put_crossplatform_mediaretentionpolicy | Update a media retention policy |
genesys_recording_put_job | Execute the recording bulk job. |
genesys_recording_put_mediaretentionpolicy | Update a media retention policy |
genesys_recording_put_orphanrecording | Updates an orphan recording to a regular recording with retention values |
genesys_recording_put_recordingkeys_rotationschedule | Update key rotation schedule |
genesys_recording_put_recordings_deletionprotection | Apply or revoke recording protection for conversations |
genesys_recording_put_settings | Update the Recording Settings for the Organization |
genesys_recording_delete_conversation_recording_annotation
Delete annotation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | Conversation ID |
recordingId | string | Yes | — | Recording ID |
annotationId | string | Yes | — | Annotation ID |
genesys_recording_delete_crossplatform_mediaretentionpolicies
Delete media retention policies Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ids | string | Yes | — | ids |
genesys_recording_delete_crossplatform_mediaretentionpolicy
Delete a media retention policy Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
policyId | string | Yes | — | Policy ID |
genesys_recording_delete_job
Delete the recording bulk job Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
jobId | string | Yes | — | jobId |
genesys_recording_delete_mediaretentionpolicies
Delete media retention policies Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ids | string | Yes | — | ids |
genesys_recording_delete_mediaretentionpolicy
Delete a media retention policy Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
policyId | string | Yes | — | Policy ID |
genesys_recording_delete_orphanrecording
Deletes a single orphan recording Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
orphanId | string | Yes | — | Orphan 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
jobId | string | Yes | — | jobId |
genesys_recording_get_conversation_recording
Gets a specific recording. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | Conversation ID |
recordingId | string | Yes | — | Recording ID |
formatId | string | No | — | The desired media format. Valid values:WAV,WEBM,WAV_ULAW,OGG_VORBIS,OGG_OPUS,MP3,NONE |
emailFormatId | string | No | — | The desired media format when downloading an email recording. Valid values:EML,NONE |
chatFormatId | string | No | — | The desired media format when downloading a chat recording. Valid values:ZIP,NONE |
messageFormatId | string | No | — | The desired media format when downloading a message recording. Valid values:ZIP,NONE |
download | boolean | No | — | requesting a download format of the recording. Valid values:true,false |
fileName | string | No | — | the name of the downloaded fileName |
locale | string | No | — | The locale for the requested file when downloading or for redacting sensitive information in requested files, as an ISO 639-1 code |
mediaFormats | any[] | No | — | All 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | Conversation ID |
recordingId | string | Yes | — | Recording ID |
annotationId | string | Yes | — | Annotation ID |
genesys_recording_get_conversation_recording_annotations
Get annotations for recording Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | Conversation ID |
recordingId | string | Yes | — | Recording 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | Conversation ID |
genesys_recording_get_conversation_recordingmetadata_recording_id
Get metadata for a specific recording. Does not return playable media. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | Conversation ID |
recordingId | string | Yes | — | Recording ID |
genesys_recording_get_conversation_recordings
Get all of a Conversation’s Recordings. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | Conversation ID |
maxWaitMs | integer | No | — | The maximum number of milliseconds to wait for the recording to be ready. Must be a positive value. |
formatId | string | No | — | The desired media format. Valid values:WAV,WEBM,WAV_ULAW,OGG_VORBIS,OGG_OPUS,MP3,NONE. |
mediaFormats | any[] | No | — | All acceptable media formats. Overrides formatId. Valid values:WAV,WEBM,WAV_ULAW,OGG_VORBIS,OGG_OPUS,MP3. |
locale | string | No | — | The locale used for redacting sensitive information in requested files, as an ISO 639-1 code |
includePauseAnnotationsForScreenRecordings | boolean | No | — | Include 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageSize | integer | No | — | The total page size requested |
pageNumber | integer | No | — | The page number requested |
sortBy | string | No | — | variable name requested to sort by |
expand | any[] | No | — | variable name requested by expand list |
nextPage | string | No | — | next page token |
previousPage | string | No | — | Previous page token |
name | string | No | — | the policy name - used for filtering results in searches. |
enabled | boolean | No | — | checks to see if policy is enabled - use enabled = true or enabled = false |
summary | boolean | No | — | provides a less verbose response of policy lists. |
hasErrors | boolean | No | — | provides a way to fetch all policies with errors or policies that do not have errors |
deleteDaysThreshold | integer | No | — | provides 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
policyId | string | Yes | — | Policy ID |
genesys_recording_get_job
Get the status of the job associated with the job id. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
jobId | string | Yes | — | jobId |
genesys_recording_get_job_failedrecordings
Get IDs of recordings that the bulk job failed for Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
jobId | string | Yes | — | jobId |
pageSize | integer | No | — | Page size. Maximum is 100. |
pageNumber | integer | No | — | Page number |
includeTotal | boolean | No | — | If false, cursor will be used to locate the page instead of pageNumber. It is recommended to set it to false for improved performance. |
cursor | string | No | — | Indicates 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageSize | integer | No | — | Page size |
pageNumber | integer | No | — | Page number |
sortBy | string | No | — | Sort by |
state | string | No | — | Filter by state |
showOnlyMyJobs | boolean | No | — | Show only my jobs |
jobType | string | No | — | Job Type (Can be left empty for both) |
includeTotal | boolean | No | — | If false, cursor will be used to locate the page instead of pageNumber. It is recommended to set it to false for improved performance. |
cursor | string | No | — | Indicates 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageSize | integer | No | — | The total page size requested |
pageNumber | integer | No | — | The page number requested |
sortBy | string | No | — | variable name requested to sort by |
expand | any[] | No | — | variable name requested by expand list |
nextPage | string | No | — | next page token |
previousPage | string | No | — | Previous page token |
name | string | No | — | the policy name - used for filtering results in searches. |
enabled | boolean | No | — | checks to see if policy is enabled - use enabled = true or enabled = false |
summary | boolean | No | — | provides a less verbose response of policy lists. |
hasErrors | boolean | No | — | provides a way to fetch all policies with errors or policies that do not have errors |
deleteDaysThreshold | integer | No | — | provides 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
policyId | string | Yes | — | Policy ID |
genesys_recording_get_orphanrecording
Gets a single orphan recording Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
orphanId | string | Yes | — | Orphan ID |
genesys_recording_get_orphanrecording_media
Gets the media of a single orphan recording Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
orphanId | string | Yes | — | Orphan ID |
formatId | string | No | — | The desired media format. |
emailFormatId | string | No | — | The desired media format when downloading an email recording. |
chatFormatId | string | No | — | The desired media format when downloading a chat recording. |
messageFormatId | string | No | — | The desired media format when downloading a message recording. |
download | boolean | No | — | requesting a download format of the recording |
fileName | string | No | — | the name of the downloaded fileName |
locale | string | No | — | The locale for the requested file when downloading, as an ISO 639-1 code |
mediaFormats | any[] | No | — | All 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageSize | integer | No | — | The total page size requested |
pageNumber | integer | No | — | The page number requested |
sortBy | string | No | — | variable name requested to sort by |
expand | any[] | No | — | variable name requested by expand list |
nextPage | string | No | — | next page token |
previousPage | string | No | — | Previous page token |
hasConversation | boolean | No | — | Filter resulting orphans by whether the conversation is known. False returns all orphans for the organization. |
media | string | No | — | Filter resulting orphans based on their media type |
genesys_recording_get_recordingkeys
Get encryption key list Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageSize | integer | No | — | Page size |
pageNumber | integer | No | — | Page number |
genesys_recording_get_recordingkeys_rotationschedule
Get key rotation schedulegenesys_recording_get_recordings_retention_query
Query for recording retention data Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
retentionThresholdDays | integer | Yes | — | Fetch retention data for recordings retained for more days than the provided value. |
cursor | string | No | — | Indicates where to resume query results (not required for first page) |
pageSize | integer | No | — | Page size. Maximum is 500. |
genesys_recording_get_recordings_screensessions_details
Retrieves an object containing the total number of concurrent active screen recordingsgenesys_recording_get_settings
Get the Recording Settings for the Organization Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
createDefault | boolean | No | — | If 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
reportId | string | Yes | — | reportId |
genesys_recording_patch_crossplatform_mediaretentionpolicy
Patch a media retention policy Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
policyId | string | Yes | — | Policy ID |
enabled | boolean | No | — | enabled |
genesys_recording_patch_mediaretentionpolicy
Patch a media retention policy Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
policyId | string | Yes | — | Policy ID |
enabled | boolean | No | — | enabled |
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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
batchDownloadRequestList | any[] | Yes | — | List of up to 100 items requested |
genesys_recording_post_conversation_recording_annotations
Create annotation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | Conversation ID |
recordingId | string | Yes | — | Recording ID |
absoluteDurationMs | integer | No | — | Duration of annotation (milliseconds). |
absoluteLocation | integer | No | — | Offset of annotation (milliseconds) from start of recording (after removing the cumulative duration of all pauses). |
annotations | any[] | No | — | List of annotations |
description | string | No | — | Text of annotation. Maximum character limit is 500. |
durationMs | integer | No | — | Duration of annotation in milliseconds. |
id | string | No | — | Annotation 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). |
location | integer | No | — | Offset of annotation in milliseconds. |
name | string | No | — | name |
realtimeLocation | integer | No | — | Offset of annotation (milliseconds) from start of the recording before removing the cumulative duration of all pauses before this annotation |
reason | string | No | — | Reason for a pause annotation. Valid values: Hold,SecurePause,FlowOrQueue,Pause |
recordingDurationMs | integer | No | — | Duration of annotation (milliseconds), adjusted for any recording cuts. |
recordingLocation | integer | No | — | Offset of annotation (milliseconds) from start of recording, adjusted for any recording cuts |
selfUri | string | No | — | The URI for this object |
type | string | No | — | type |
user | object | No | — | user |
genesys_recording_post_crossplatform_mediaretentionpolicies
Create media retention policy Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
actions | object | No | — | actions |
conditions | object | No | — | conditions |
createdDate | string | No | — | Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
description | string | No | — | description |
enabled | boolean | No | — | enabled |
id | string | No | — | The globally unique identifier for the object. |
mediaPolicies | object | No | — | mediaPolicies |
modifiedDate | string | No | — | Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
name | string | Yes | — | The policy name. |
order | integer | No | — | order |
policyErrors | object | No | — | policyErrors |
selfUri | string | No | — | The URI for this object |
genesys_recording_post_jobs
Create a recording bulk job. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
action | string | Yes | — | Operation 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. |
actionAge | integer | No | — | The 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. |
actionDate | string | No | — | The 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 |
agedConversationInterval | string | No | — | As 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 |
clearExport | boolean | No | — | For DELETE action, setting this to true will clear any pending exports for recordings. This field is only used for DELETE action. Default value = false |
conversationQuery | object | No | — | conversationQuery |
includeRecordingsWithSensitiveData | boolean | No | — | Whether to include recordings with PCI DSS and/or PII data, default value = false |
includeScreenRecordings | boolean | No | — | Whether to include Screen recordings for the action, default value = true |
integrationId | string | No | — | IntegrationId to Access AWS S3 bucket for bulk recording exports. This field is required and used only for EXPORT action. |
screenRecordingActionAge | integer | No | — | The 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. |
screenRecordingActionDate | string | No | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
configId | string | Yes | — | The local configuration id that contains metadata on private local service |
keypairId | string | Yes | — | The key pair id from the local service. |
publicKey | string | Yes | — | Base 64 encoded public key, generated by the local service. |
genesys_recording_post_mediaretentionpolicies
Create media retention policy Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
actions | object | No | — | actions |
conditions | object | No | — | conditions |
createdDate | string | No | — | Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
description | string | No | — | description |
enabled | boolean | No | — | enabled |
id | string | No | — | The globally unique identifier for the object. |
mediaPolicies | object | No | — | mediaPolicies |
modifiedDate | string | No | — | Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
name | string | Yes | — | The policy name. |
order | integer | No | — | order |
policyErrors | object | No | — | policyErrors |
selfUri | string | No | — | The URI for this object |
genesys_recording_post_recordingkeys
Create encryption keygenesys_recording_post_recordings_deletionprotection
Get a list of conversations with protected recordings Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationIds | any[] | Yes | — | This is a list of ConversationIds. The list cannot exceed 100 conversationids. |
genesys_recording_post_recordings_screensessions_acknowledge
Acknowledge a screen recording. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | No | — | conversationId |
participantJid | string | No | — | participantJid |
roomId | string | No | — | roomId |
genesys_recording_post_recordings_screensessions_metadata
Provide meta-data a screen recording. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
metaData | any[] | No | — | metaData |
participantJid | string | No | — | participantJid |
roomId | string | No | — | roomId |
genesys_recording_post_uploads_reports
Creates a recording upload status report Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
dateSince | string | Yes | — | Report will include uploads since this date. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
uploadStatus | string | No | — | Report will include uploads with this status |
genesys_recording_put_conversation_recording
Updates the retention records on a recording. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | Conversation ID |
recordingId | string | Yes | — | Recording ID |
clearExport | boolean | No | — | Whether to clear the pending export for the recording |
actualTranscodeTimeMs | integer | No | — | actualTranscodeTimeMs |
annotations | any[] | No | — | Annotations that belong to the recording. |
archiveDate | string | No | — | The date the recording will be archived. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
archiveMedium | string | No | — | The type of archive medium used. Example: CloudArchive |
creationTime | string | No | — | The creation time of the recording. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
deleteDate | string | No | — | The date the recording will be deleted. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
emailTranscript | any[] | No | — | Represents an email transcript |
endTime | string | No | — | The end time of the recording. Null when there is no playable media. |
estimatedTranscodeTimeMs | integer | No | — | estimatedTranscodeTimeMs |
exportDate | string | No | — | The date the recording will be exported. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
exportedDate | string | No | — | The date the recording was exported. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
fileState | string | No | — | Represents the current file state for a recording. Examples: Uploading, Archived, etc |
id | string | No | — | The globally unique identifier for the object. |
maxAllowedRestorationsForOrg | integer | No | — | How many archive restorations the organization is allowed to have. Deprecated - Always returns 10000 since the restoration limit is no longer enforced. |
media | string | No | — | The media type of the recording. This could be audio, chat, messaging, email, or screen. |
mediaSubject | string | No | — | The media subject of the recording. |
mediaSubtype | string | No | — | The media subtype of the recording. |
mediaUris | object | No | — | The different mediaUris for the recording. Null when there is no playable media. |
messagingTranscript | any[] | No | — | Represents a messaging transcript |
name | string | No | — | name |
originalRecordingStartTime | string | No | — | The 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 |
outputDurationMs | integer | No | — | Duration of transcoded media in milliseconds |
outputSizeInBytes | integer | No | — | Size of transcoded media in bytes. 0 if there is no transcoded media. |
path | string | No | — | path |
recordingErrorStatus | string | No | — | Status of a recording that cannot be returned because of an error |
recordingFileRole | string | No | — | Role of the file recording. It can be either customer_experience or adhoc. |
remainingRestorationsAllowedForOrg | integer | No | — | The remaining archive restorations the organization has. Deprecated - Always returns 10000 since the restoration limit is no longer enforced. |
restoreExpirationTime | string | No | — | The 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 |
selfUri | string | No | — | The URI for this object |
sessionId | string | No | — | The session id represents an external resource id, such as email, call, chat, etc |
startTime | string | No | — | The start time of the recording. Null when there is no playable media. |
transcript | any[] | No | — | Represents a chat transcript |
users | any[] | No | — | The users participating in the conversation |
genesys_recording_put_conversation_recording_annotation
Update annotation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | string | Yes | — | Conversation ID |
recordingId | string | Yes | — | Recording ID |
annotationId | string | Yes | — | Annotation ID |
absoluteDurationMs | integer | No | — | Duration of annotation (milliseconds). |
absoluteLocation | integer | No | — | Offset of annotation (milliseconds) from start of recording (after removing the cumulative duration of all pauses). |
annotations | any[] | No | — | List of annotations |
description | string | No | — | Text of annotation. Maximum character limit is 500. |
durationMs | integer | No | — | Duration of annotation in milliseconds. |
id | string | No | — | Annotation 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). |
location | integer | No | — | Offset of annotation in milliseconds. |
name | string | No | — | name |
realtimeLocation | integer | No | — | Offset of annotation (milliseconds) from start of the recording before removing the cumulative duration of all pauses before this annotation |
reason | string | No | — | Reason for a pause annotation. Valid values: Hold,SecurePause,FlowOrQueue,Pause |
recordingDurationMs | integer | No | — | Duration of annotation (milliseconds), adjusted for any recording cuts. |
recordingLocation | integer | No | — | Offset of annotation (milliseconds) from start of recording, adjusted for any recording cuts |
selfUri | string | No | — | The URI for this object |
type | string | No | — | type |
user | object | No | — | user |
genesys_recording_put_crossplatform_mediaretentionpolicy
Update a media retention policy Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
policyId | string | Yes | — | Policy ID |
actions | object | No | — | actions |
conditions | object | No | — | conditions |
createdDate | string | No | — | Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
description | string | No | — | description |
enabled | boolean | No | — | enabled |
id | string | No | — | The globally unique identifier for the object. |
mediaPolicies | object | No | — | mediaPolicies |
modifiedDate | string | No | — | Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
name | string | No | — | name |
order | integer | No | — | order |
policyErrors | object | No | — | policyErrors |
selfUri | string | No | — | The URI for this object |
genesys_recording_put_job
Execute the recording bulk job. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
jobId | string | Yes | — | jobId |
state | string | Yes | — | The desired state for the job to be set to. |
genesys_recording_put_mediaretentionpolicy
Update a media retention policy Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
policyId | string | Yes | — | Policy ID |
actions | object | No | — | actions |
conditions | object | No | — | conditions |
createdDate | string | No | — | Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
description | string | No | — | description |
enabled | boolean | No | — | enabled |
id | string | No | — | The globally unique identifier for the object. |
mediaPolicies | object | No | — | mediaPolicies |
modifiedDate | string | No | — | Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
name | string | No | — | name |
order | integer | No | — | order |
policyErrors | object | No | — | policyErrors |
selfUri | string | No | — | The URI for this object |
genesys_recording_put_orphanrecording
Updates an orphan recording to a regular recording with retention values Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
orphanId | string | Yes | — | Orphan ID |
archiveDate | string | No | — | The 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 |
conversationId | string | No | — | A conversation Id that this orphan’s recording is to be attached to. If not present, the conversationId will be deduced from the recording media. |
deleteDate | string | No | — | The 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 |
exportDate | string | No | — | The 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 |
integrationId | string | No | — | IntegrationId 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | No | — | The globally unique identifier for the object. |
name | string | No | — | name |
period | string | Yes | — | Value to set schedule to |
selfUri | string | No | — | The URI for this object |
genesys_recording_put_recordings_deletionprotection
Apply or revoke recording protection for conversations Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
protect | boolean | No | — | Check for apply, uncheck for revoke (each action requires the respective permission) |
conversationIds | any[] | No | — | This is a list of ConversationIds. The list cannot exceed 100 conversationids. |
genesys_recording_put_settings
Update the Recording Settings for the Organization Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
maxConfigurableScreenRecordingStreams | integer | No | — | Upper limit that maxSimultaneousStreams can be configured |
maxSimultaneousStreams | integer | No | — | Maximum number of simultaneous screen recording streams |
recordingBatchDownloadUrlTtl | integer | No | — | The 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. |
recordingPlaybackUrlTtl | integer | No | — | The 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. |
regionalRecordingStorageEnabled | boolean | No | — | Store call recordings in the region where they are intended to be recorded, otherwise in the organization’s home region |

