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

Tools

ToolDescription
genesys_gamification_delete_contestDelete a Contest by Id
genesys_gamification_delete_employeeperformance_externalmetrics_definitionDelete an External Metric Definition
genesys_gamification_get_contestGet a Contest by Id
genesys_gamification_get_contest_agents_scoresGet Contest Scores (Admin)
genesys_gamification_get_contest_agents_scores_meGet Contest Scores for the requesting Agent/Supervisor
genesys_gamification_get_contest_agents_scores_trendsGet a Contest Score Trend (Average Trend)
genesys_gamification_get_contest_agents_scores_trends_meGet a Contest Score Trend for the requesting Agent
genesys_gamification_get_contest_prizeimageGet a Contest Prize Image by Id
genesys_gamification_get_contestsGet a List of Contests (Admin)
genesys_gamification_get_contests_meGet a List of Contests (Agent/Supervisor)
genesys_gamification_get_employeeperformance_externalmetrics_definitionGet an External Metric Definition
genesys_gamification_get_employeeperformance_externalmetrics_definitionsGet a list of External Metric Definitions of an organization, sorted by name in ascending order
genesys_gamification_get_insightsGet insights summary
genesys_gamification_get_insights_detailsGet insights details for the current user
genesys_gamification_get_insights_groups_trendsGet insights overall trend for the current user
genesys_gamification_get_insights_groups_trends_allGet insights overall trend
genesys_gamification_get_insights_managersQuery managers in a profile during a period of time
genesys_gamification_get_insights_membersQuery users in a profile during a period of time
genesys_gamification_get_insights_rankingsGet insights rankings
genesys_gamification_get_insights_trendsGet insights user trend for the current user
genesys_gamification_get_insights_user_detailsGet insights details for the user
genesys_gamification_get_insights_user_trendsGet insights user trend for the user
genesys_gamification_get_leaderboardLeaderboard of the requesting user’s division or performance profile
genesys_gamification_get_leaderboard_allLeaderboard by filter type
genesys_gamification_get_leaderboard_all_bestpointsBest Points by division or performance profile
genesys_gamification_get_leaderboard_bestpointsBest Points of the requesting user’s current performance profile or division
genesys_gamification_get_metricdefinitionMetric definition by id
genesys_gamification_get_metricdefinitionsAll metric definitions
genesys_gamification_get_profilePerformance profile by id
genesys_gamification_get_profile_membersMembers of a given performance profile
genesys_gamification_get_profile_metricPerformance profile gamified metric by id
genesys_gamification_get_profile_metricsAll gamified metrics for a given performance profile
genesys_gamification_get_profile_metrics_objectivedetailsAll metrics for a given performance profile with objective details such as order and maxPoints
genesys_gamification_get_profilesAll performance profiles
genesys_gamification_get_profiles_userPerformance profile of a user
genesys_gamification_get_profiles_users_mePerformance profile of the requesting user
genesys_gamification_get_scorecardsWorkday performance metrics of the requesting user
genesys_gamification_get_scorecards_attendanceAttendance status metrics of the requesting user
genesys_gamification_get_scorecards_bestpointsBest points of the requesting user
genesys_gamification_get_scorecards_points_alltimeAll-time points of the requesting user
genesys_gamification_get_scorecards_points_averageAverage points of the requesting user’s division or performance profile
genesys_gamification_get_scorecards_points_trendsPoints trends of the requesting user
genesys_gamification_get_scorecards_profile_metric_user_values_trendsAverage performance values trends by metric of a user
genesys_gamification_get_scorecards_profile_metric_users_values_trendsAverage performance values trends by metric of a division or a performance profile
genesys_gamification_get_scorecards_profile_metric_values_trendsAverage performance values trends by metric of the requesting user
genesys_gamification_get_scorecards_userWorkday performance metrics for a user
genesys_gamification_get_scorecards_user_attendanceAttendance status metrics for a user
genesys_gamification_get_scorecards_user_bestpointsBest points of a user
genesys_gamification_get_scorecards_user_points_alltimeAll-time points for a user
genesys_gamification_get_scorecards_user_points_trendsPoints trend for a user
genesys_gamification_get_scorecards_user_values_trendsValues trends of a user
genesys_gamification_get_scorecards_users_points_averageWorkday average points by target group
genesys_gamification_get_scorecards_users_values_averageWorkday average values by target group
genesys_gamification_get_scorecards_users_values_trendsValues trend by target group
genesys_gamification_get_scorecards_values_averageAverage values of the requesting user’s division or performance profile
genesys_gamification_get_scorecards_values_trendsValues trends of the requesting user or group
genesys_gamification_get_statusGamification activation status
genesys_gamification_get_templateObjective template by id
genesys_gamification_get_templatesAll objective templates
genesys_gamification_patch_contestFinalize a Contest by Id
genesys_gamification_patch_employeeperformance_externalmetrics_definitionUpdate External Metric Definition
genesys_gamification_post_contestsCreates a Contest
genesys_gamification_post_contests_uploads_prizeimagesGenerates pre-signed URL to upload a prize image for gamification contests
genesys_gamification_post_employeeperformance_externalmetrics_dataWrite External Metric Data
genesys_gamification_post_employeeperformance_externalmetrics_definitionsCreate External Metric Definition
genesys_gamification_post_profile_activateActivate a performance profile
genesys_gamification_post_profile_deactivateDeactivate a performance profile
genesys_gamification_post_profile_membersAssign members to a given performance profile
genesys_gamification_post_profile_members_validateValidate member assignment
genesys_gamification_post_profile_metric_linkCreates a linked metric
genesys_gamification_post_profile_metricsCreates a gamified metric with a given metric definition and metric objective under in a performance profile
genesys_gamification_post_profilesCreate a new custom performance profile
genesys_gamification_post_profiles_user_queryQuery performance profiles in date range for a user
genesys_gamification_post_profiles_users_me_queryQuery performance profiles in date range for the current user
genesys_gamification_put_contestUpdate a Contest by Id
genesys_gamification_put_profileUpdates a performance profile
genesys_gamification_put_profile_metricUpdates a metric in performance profile
genesys_gamification_put_statusUpdate gamification activation status

genesys_gamification_delete_contest

Delete a Contest by Id Parameters:
ParameterTypeRequiredDefaultDescription
contestIdstringYesThe ID of the contest

genesys_gamification_delete_employeeperformance_externalmetrics_definition

Delete an External Metric Definition Parameters:
ParameterTypeRequiredDefaultDescription
metricIdstringYesSpecifies the External Metric Definition ID

genesys_gamification_get_contest

Get a Contest by Id Parameters:
ParameterTypeRequiredDefaultDescription
contestIdstringYesThe ID of the contest

genesys_gamification_get_contest_agents_scores

Get Contest Scores (Admin) Parameters:
ParameterTypeRequiredDefaultDescription
contestIdstringYesThe ID of the contest
pageNumberintegerNopageNumber
pageSizeintegerNopageSize
workdaystringNoTarget querying workday. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
returnsViewstringNoDesired response results

genesys_gamification_get_contest_agents_scores_me

Get Contest Scores for the requesting Agent/Supervisor Parameters:
ParameterTypeRequiredDefaultDescription
contestIdstringYesThe ID of the contest
pageNumberintegerNopageNumber
pageSizeintegerNopageSize
workdaystringNoTarget querying workday. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
returnsViewstringNoDesired response results (Supervisor Only)

Get a Contest Score Trend (Average Trend) Parameters:
ParameterTypeRequiredDefaultDescription
contestIdstringYesThe ID of the contest

Get a Contest Score Trend for the requesting Agent Parameters:
ParameterTypeRequiredDefaultDescription
contestIdstringYesThe ID of the contest

genesys_gamification_get_contest_prizeimage

Get a Contest Prize Image by Id Parameters:
ParameterTypeRequiredDefaultDescription
contestIdstringYesThe ID of the contest
prizeImageIdstringYesThe ID of the prize image

genesys_gamification_get_contests

Get a List of Contests (Admin) Parameters:
ParameterTypeRequiredDefaultDescription
pageNumberintegerNopageNumber
pageSizeintegerNopageSize
dateStartstringNoStart date for the query. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
dateEndstringNoEnd date for the query. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
statusany[]Nostatus
sortBystringNosortBy
sortOrderstringNosortOrder

genesys_gamification_get_contests_me

Get a List of Contests (Agent/Supervisor) Parameters:
ParameterTypeRequiredDefaultDescription
pageNumberintegerNopageNumber
pageSizeintegerNopageSize
dateStartstringNoStart date for the query. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
dateEndstringNoEnd date for the query. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
statusany[]Nostatus
sortBystringNosortBy
sortOrderstringNosortOrder
viewstringNoview

genesys_gamification_get_employeeperformance_externalmetrics_definition

Get an External Metric Definition Parameters:
ParameterTypeRequiredDefaultDescription
metricIdstringYesSpecifies the External Metric Definition ID

genesys_gamification_get_employeeperformance_externalmetrics_definitions

Get a list of External Metric Definitions of an organization, sorted by name in ascending order Parameters:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNoPage size
pageNumberintegerNoPage number

genesys_gamification_get_insights

Get insights summary Parameters:
ParameterTypeRequiredDefaultDescription
filterTypestringYesFilter type for the query request.
filterIdstringYesID for the filter type.
granularitystringYesGranularity
comparativePeriodStartWorkdaystringYesThe start work day of comparative period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
primaryPeriodStartWorkdaystringYesThe start work day of primary period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
pageSizeintegerNoPage size
pageNumberintegerNoPage number
sortKeystringNoSort key
sortMetricIdstringNoSort Metric Id
sortOrderstringNoSort order
userIdsstringNoA list of up to 100 comma-separated user Ids
reportsTostringNoThe reportsTo used by ABAC policies.

genesys_gamification_get_insights_details

Get insights details for the current user Parameters:
ParameterTypeRequiredDefaultDescription
filterTypestringYesFilter type for the query request.
filterIdstringYesID for the filter type.
granularitystringYesGranularity
comparativePeriodStartWorkdaystringYesThe start work day of comparative period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
primaryPeriodStartWorkdaystringYesThe start work day of primary period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd

Get insights overall trend for the current user Parameters:
ParameterTypeRequiredDefaultDescription
filterTypestringYesFilter type for the query request.
filterIdstringYesID for the filter type.
granularitystringYesGranularity
comparativePeriodStartWorkdaystringYesThe start work day of comparative period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
comparativePeriodEndWorkdaystringYesThe end work day of comparative period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
primaryPeriodStartWorkdaystringYesThe start work day of primary period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
primaryPeriodEndWorkdaystringYesThe end work day of primary period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd

Get insights overall trend Parameters:
ParameterTypeRequiredDefaultDescription
filterTypestringYesFilter type for the query request.
filterIdstringYesID for the filter type.
granularitystringYesGranularity
comparativePeriodStartWorkdaystringYesThe start work day of comparative period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
comparativePeriodEndWorkdaystringYesThe end work day of comparative period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
primaryPeriodStartWorkdaystringYesThe start work day of primary period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
primaryPeriodEndWorkdaystringYesThe end work day of primary period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd

genesys_gamification_get_insights_managers

Query managers in a profile during a period of time Parameters:
ParameterTypeRequiredDefaultDescription
filterTypestringYesFilter type for the query request.
filterIdstringYesID for the filter type.
granularitystringYesGranularity
startWorkdaystringYesThe start work day. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
pageSizeintegerNoPage size
pageNumberintegerNoPage number

genesys_gamification_get_insights_members

Query users in a profile during a period of time Parameters:
ParameterTypeRequiredDefaultDescription
filterTypestringYesFilter type for the query request.
filterIdstringYesID for the filter type.
granularitystringYesGranularity
startWorkdaystringYesThe start work day. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
reportsTostringNoThe reportsTo used by ABAC policies.

genesys_gamification_get_insights_rankings

Get insights rankings Parameters:
ParameterTypeRequiredDefaultDescription
filterTypestringYesFilter type for the query request.
filterIdstringYesID for the filter type.
granularitystringYesGranularity
comparativePeriodStartWorkdaystringYesThe start work day of comparative period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
primaryPeriodStartWorkdaystringYesThe start work day of primary period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
sortKeystringYesSort key
sortMetricIdstringNoSort Metric Id
sectionSizeintegerNoThe number of top and bottom users to return before ties
userIdsstringNoA list of up to 100 comma-separated user Ids
reportsTostringNoThe reportsTo used by ABAC policies.

Get insights user trend for the current user Parameters:
ParameterTypeRequiredDefaultDescription
filterTypestringYesFilter type for the query request.
filterIdstringYesID for the filter type.
granularitystringYesGranularity
comparativePeriodStartWorkdaystringYesThe start work day of comparative period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
comparativePeriodEndWorkdaystringYesThe end work day of comparative period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
primaryPeriodStartWorkdaystringYesThe start work day of primary period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
primaryPeriodEndWorkdaystringYesThe end work day of primary period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd

genesys_gamification_get_insights_user_details

Get insights details for the user Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesThe ID of a user.
filterTypestringYesFilter type for the query request.
filterIdstringYesID for the filter type.
granularitystringYesGranularity
comparativePeriodStartWorkdaystringYesThe start work day of comparative period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
primaryPeriodStartWorkdaystringYesThe start work day of primary period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd

Get insights user trend for the user Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesThe ID of a user.
filterTypestringYesFilter type for the query request.
filterIdstringYesID for the filter type.
granularitystringYesGranularity
comparativePeriodStartWorkdaystringYesThe start work day of comparative period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
comparativePeriodEndWorkdaystringYesThe end work day of comparative period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
primaryPeriodStartWorkdaystringYesThe start work day of primary period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
primaryPeriodEndWorkdaystringYesThe end work day of primary period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd

genesys_gamification_get_leaderboard

Leaderboard of the requesting user’s division or performance profile Parameters:
ParameterTypeRequiredDefaultDescription
startWorkdaystringYesStart workday to retrieve for the leaderboard. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
endWorkdaystringYesEnd workday to retrieve for the leaderboard. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
metricIdstringNoMetric Id for which the leaderboard is to be generated. The total points is used if nothing is given.

genesys_gamification_get_leaderboard_all

Leaderboard by filter type Parameters:
ParameterTypeRequiredDefaultDescription
filterTypestringYesFilter type for the query request.
filterIdstringYesID for the filter type. For example, division or performance profile Id
startWorkdaystringYesStart workday to retrieve for the leaderboard. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
endWorkdaystringYesEnd workday to retrieve for the leaderboard. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
metricIdstringNoMetric Id for which the leaderboard is to be generated. The total points is used if nothing is given.

genesys_gamification_get_leaderboard_all_bestpoints

Best Points by division or performance profile Parameters:
ParameterTypeRequiredDefaultDescription
filterTypestringYesFilter type for the query request.
filterIdstringYesID for the filter type. For example, division or performance profile Id

genesys_gamification_get_leaderboard_bestpoints

Best Points of the requesting user’s current performance profile or division

genesys_gamification_get_metricdefinition

Metric definition by id Parameters:
ParameterTypeRequiredDefaultDescription
metricDefinitionIdstringYesmetric definition id

genesys_gamification_get_metricdefinitions

All metric definitions

genesys_gamification_get_profile

Performance profile by id Parameters:
ParameterTypeRequiredDefaultDescription
profileIdstringYesperformanceProfileId

genesys_gamification_get_profile_members

Members of a given performance profile Parameters:
ParameterTypeRequiredDefaultDescription
profileIdstringYesProfile Id

genesys_gamification_get_profile_metric

Performance profile gamified metric by id Parameters:
ParameterTypeRequiredDefaultDescription
profileIdstringYesPerformance Profile Id
metricIdstringYesMetric Id
workdaystringNoThe objective query workday. If not specified, then it retrieves the current objective. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd

genesys_gamification_get_profile_metrics

All gamified metrics for a given performance profile Parameters:
ParameterTypeRequiredDefaultDescription
profileIdstringYesPerformance Profile Id
expandany[]NoWhich fields, if any, to expand.
workdaystringNoThe objective query workday. If not specified, then it retrieves the current objective. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
metricIdsstringNoList of metric ids to filter the response (Optional, comma-separated).

genesys_gamification_get_profile_metrics_objectivedetails

All metrics for a given performance profile with objective details such as order and maxPoints Parameters:
ParameterTypeRequiredDefaultDescription
profileIdstringYesPerformance Profile Id
workdaystringNoThe objective query workday. If not specified, then it retrieves the current objective. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd

genesys_gamification_get_profiles

All performance profiles

genesys_gamification_get_profiles_user

Performance profile of a user Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesuserId
workdaystringNoTarget querying workday. If not provided, then queries the current performance profile. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd

genesys_gamification_get_profiles_users_me

Performance profile of the requesting user Parameters:
ParameterTypeRequiredDefaultDescription
workdaystringNoTarget querying workday. If not provided, then queries the current performance profile. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd

genesys_gamification_get_scorecards

Workday performance metrics of the requesting user Parameters:
ParameterTypeRequiredDefaultDescription
workdaystringYesTarget querying workday. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
expandany[]NoWhich fields, if any, to expand.

genesys_gamification_get_scorecards_attendance

Attendance status metrics of the requesting user Parameters:
ParameterTypeRequiredDefaultDescription
startWorkdaystringYesStart workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
endWorkdaystringYesEnd workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd

genesys_gamification_get_scorecards_bestpoints

Best points of the requesting user

genesys_gamification_get_scorecards_points_alltime

All-time points of the requesting user Parameters:
ParameterTypeRequiredDefaultDescription
endWorkdaystringYesEnd workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd

genesys_gamification_get_scorecards_points_average

Average points of the requesting user’s division or performance profile Parameters:
ParameterTypeRequiredDefaultDescription
workdaystringYesThe target workday. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd

Points trends of the requesting user Parameters:
ParameterTypeRequiredDefaultDescription
startWorkdaystringYesStart workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
endWorkdaystringYesEnd workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
dayOfWeekstringNoOptional filter to specify which day of weeks to be included in the response

Average performance values trends by metric of a user Parameters:
ParameterTypeRequiredDefaultDescription
profileIdstringYesperformanceProfileId
metricIdstringYesmetricId
userIdstringYesuserId
startWorkdaystringYesStart workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
endWorkdaystringYesEnd workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
referenceWorkdaystringNoReference workday for the trend. Used to determine the associated metric definition. If not set, then the value of endWorkday is used. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
timeZonestringNoTimezone for the workday. Defaults to UTC

Average performance values trends by metric of a division or a performance profile Parameters:
ParameterTypeRequiredDefaultDescription
profileIdstringYesperformanceProfileId
metricIdstringYesmetricId
filterTypestringYesFilter type for the query request.
filterIdstringNoID for the filter type. Only required when filterType is Division.
startWorkdaystringYesStart workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
endWorkdaystringYesEnd workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
referenceWorkdaystringNoReference workday for the trend. Used to determine the associated metric definition. If not set, then the value of endWorkday is used. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
timeZonestringNoTimezone for the workday. Defaults to UTC

Average performance values trends by metric of the requesting user Parameters:
ParameterTypeRequiredDefaultDescription
profileIdstringYesperformanceProfileId
metricIdstringYesmetricId
filterTypestringNoFilter type for the query request. If not set, returns the values trends of the requesting user
startWorkdaystringYesStart workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
endWorkdaystringYesEnd workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
referenceWorkdaystringNoReference workday for the trend. Used to determine the associated metric definition. If not set, then the value of endWorkday is used. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
timeZonestringNoTimezone for the workday. Defaults to UTC

genesys_gamification_get_scorecards_user

Workday performance metrics for a user Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesuserId
workdaystringYesTarget querying workday. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
expandany[]NoWhich fields, if any, to expand.

genesys_gamification_get_scorecards_user_attendance

Attendance status metrics for a user Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesuserId
startWorkdaystringYesStart workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
endWorkdaystringYesEnd workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd

genesys_gamification_get_scorecards_user_bestpoints

Best points of a user Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesuserId

genesys_gamification_get_scorecards_user_points_alltime

All-time points for a user Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesuserId
endWorkdaystringYesEnd workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd

Points trend for a user Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesuserId
startWorkdaystringYesStart workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
endWorkdaystringYesEnd workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
dayOfWeekstringNoOptional filter to specify which day of weeks to be included in the response

Values trends of a user Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesuserId
startWorkdaystringYesStart workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
endWorkdaystringYesEnd workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
timeZonestringNoTimezone for the workday. Defaults to UTC

genesys_gamification_get_scorecards_users_points_average

Workday average points by target group Parameters:
ParameterTypeRequiredDefaultDescription
filterTypestringYesFilter type for the query request.
filterIdstringYesID for the filter type.
workdaystringYesThe target workday. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd

genesys_gamification_get_scorecards_users_values_average

Workday average values by target group Parameters:
ParameterTypeRequiredDefaultDescription
filterTypestringYesFilter type for the query request.
filterIdstringYesID for the filter type. For example, division Id
workdaystringYesThe target workday. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
timeZonestringNoTimezone for the workday. Defaults to UTC

Values trend by target group Parameters:
ParameterTypeRequiredDefaultDescription
filterTypestringYesFilter type for the query request.
filterIdstringYesID for the filter type.
startWorkdaystringYesStart workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
endWorkdaystringYesEnd workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
timeZonestringNoTimezone for the workday. Defaults to UTC

genesys_gamification_get_scorecards_values_average

Average values of the requesting user’s division or performance profile Parameters:
ParameterTypeRequiredDefaultDescription
workdaystringYesThe target workday. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
timeZonestringNoTimezone for the workday. Defaults to UTC

Values trends of the requesting user or group Parameters:
ParameterTypeRequiredDefaultDescription
filterTypestringNoFilter type for the query request. If not set, then the request is for the requesting user.
referenceWorkdaystringNoReference workday for the trend. Used to determine the profile of the user as of this date. If not set, then the user’s current profile will be used. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
startWorkdaystringYesStart workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
endWorkdaystringYesEnd workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
timeZonestringNoTimezone for the workday. Defaults to UTC

genesys_gamification_get_status

Gamification activation status

genesys_gamification_get_template

Objective template by id Parameters:
ParameterTypeRequiredDefaultDescription
templateIdstringYestemplate id

genesys_gamification_get_templates

All objective templates

genesys_gamification_patch_contest

Finalize a Contest by Id Parameters:
ParameterTypeRequiredDefaultDescription
contestIdstringYesThe ID of the contest
disqualifiedAgentsany[]NoThe Contest finalization disqualified agents
statusstringYesThe Contest finalization status
winnersany[]NoThe Contest finalization winners

genesys_gamification_patch_employeeperformance_externalmetrics_definition

Update External Metric Definition Parameters:
ParameterTypeRequiredDefaultDescription
metricIdstringYesSpecifies the metric definition ID
defaultObjectiveTypestringNoThe default objective type of the External Metric Definition
enabledbooleanNoTrue if the External Metric Definition is enabled
namestringNoThe name of the External Metric Definition
precisionintegerNoThe decimal precision of the External Metric Definition. Must be at least 0 and at most 5

genesys_gamification_post_contests

Creates a Contest Parameters:
ParameterTypeRequiredDefaultDescription
announcementTimezonestringYesThe Contest’s Announcement Timezone. Valid values are strings of the zone name as found in the IANA time zone database. For example: UTC, Etc/UTC, or Europe/London
anonymizationstringYesThe Contest anonymization
dateAnnouncedstringYesThe Contest’s Announcement Datetime. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
dateEndstringYesEnd date of the contest. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
dateStartstringYesStart date of the contest. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
descriptionstringYesThe Contest description
divisionobjectNodivision
idstringNoThe globally unique identifier for the object.
metricsany[]YesThe Contest’s Metrics
participantIdsany[]YesThe Contest’s participants
prizesany[]YesThe Contest Prizes
profileIdstringYesThe Contest profile
selfUristringNoThe URI for this object
titlestringYesThe Contest title
winningCriteriastringYesThe Contest winning criteria

genesys_gamification_post_contests_uploads_prizeimages

Generates pre-signed URL to upload a prize image for gamification contests Parameters:
ParameterTypeRequiredDefaultDescription
contentLengthintegerYesThe size of the file to upload.
contentMd5stringNoContent MD5 of the file to upload
contentTypestringYesThe content type of the file to upload.
fileNamestringNoName of the file to upload. It must not start with a dot and not end with a forward slash. Whitespace and the following characters are not allowed: &#123;^}%`]”>[~<#|
serverSideEncryptionstringNoserverSideEncryption
signedUrlTimeoutSecondsintegerNoThe number of seconds the presigned URL is valid for (from 1 to 604800 seconds). If none provided, defaults to 600 seconds

genesys_gamification_post_employeeperformance_externalmetrics_data

Write External Metric Data Parameters:
ParameterTypeRequiredDefaultDescription
itemsany[]NoA list of external metric data items. A maximum of 100 items are allowed.

genesys_gamification_post_employeeperformance_externalmetrics_definitions

Create External Metric Definition Parameters:
ParameterTypeRequiredDefaultDescription
defaultObjectiveTypestringNoThe default objective type of the External Metric Definition
enabledbooleanNoTrue if the External Metric Definition is enabled
namestringNoThe name of the External Metric Definition
precisionintegerNoThe decimal precision of the External Metric Definition. Must be at least 0 and at most 5
unitstringNoThe unit of the External Metric Definition
unitDefinitionstringNoThe unit definition of the External Metric Definition

genesys_gamification_post_profile_activate

Activate a performance profile Parameters:
ParameterTypeRequiredDefaultDescription
profileIdstringYesperformanceProfileId

genesys_gamification_post_profile_deactivate

Deactivate a performance profile Parameters:
ParameterTypeRequiredDefaultDescription
profileIdstringYesperformanceProfileId

genesys_gamification_post_profile_members

Assign members to a given performance profile Parameters:
ParameterTypeRequiredDefaultDescription
profileIdstringYesProfile Id
membersToAssignany[]YesList of user ids to assign to a performance profile
membersToRemoveany[]YesList of user ids to remove from a performance profile

genesys_gamification_post_profile_members_validate

Validate member assignment Parameters:
ParameterTypeRequiredDefaultDescription
profileIdstringYesProfile Id
membersToAssignany[]YesList of user ids to assign to a performance profile

genesys_gamification_post_profile_metric_link

Creates a linked metric Parameters:
ParameterTypeRequiredDefaultDescription
sourceProfileIdstringYesSource Performance Profile Id
sourceMetricIdstringYesSource Metric Id
targetPerformanceProfileIdstringYesThe target destination performanceProfileId for the linked metric.

genesys_gamification_post_profile_metrics

Creates a gamified metric with a given metric definition and metric objective under in a performance profile Parameters:
ParameterTypeRequiredDefaultDescription
profileIdstringYesPerformance Profile Id
externalMetricDefinitionIdstringNoThe id of associated external metric definition
metricDefinitionIdstringNoThe id of associated metric definition
namestringYesThe name of this metric
objectiveobjectNoobjective
performanceProfileIdstringNoPerformance profile id of this metric
precisionintegerNoThe precision of the metric, must be between 0 and 5
timeDisplayUnitstringNoThe time unit in which the metric should be displayed — this parameter is ignored when displaying non-time values

genesys_gamification_post_profiles

Create a new custom performance profile Parameters:
ParameterTypeRequiredDefaultDescription
copyMetricsbooleanNoFlag to copy metrics. If set to false, there will be no metrics associated with the new profile. If set to true or is absent (the default behavior), all metrics from the default profile will be copied over into the new profile.
activebooleanYesThe flag for active profiles
dateCreatedstringNoCreation date for this performance profile. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
descriptionstringYesA description about this performance profile
divisionobjectYesdivision
idstringNoThe globally unique identifier for the object.
maxLeaderboardRankSizeintegerYesThe maximum rank size for the leaderboard. This counts the number of ranks can be retrieved in a leaderboard queries
memberCountintegerNoThe number of members in this performance profile
metricOrdersany[]NoOrder of the associated metrics. The list should contain valid ids for metrics
namestringYesA name for this performance profile
reportingIntervalsany[]YesThe reporting interval periods for this performance profile
selfUristringNoThe URI for this object

genesys_gamification_post_profiles_user_query

Query performance profiles in date range for a user Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesThe ID of a user.
endWorkdaystringYesEnd work day in ISO-8601 format used in the date range.
startWorkdaystringYesStart work day in ISO-8601 format used in the date range.

genesys_gamification_post_profiles_users_me_query

Query performance profiles in date range for the current user Parameters:
ParameterTypeRequiredDefaultDescription
endWorkdaystringYesEnd work day in ISO-8601 format used in the date range.
startWorkdaystringYesStart work day in ISO-8601 format used in the date range.

genesys_gamification_put_contest

Update a Contest by Id Parameters:
ParameterTypeRequiredDefaultDescription
contestIdstringYesThe ID of the contest
announcementTimezonestringYesThe Contest’s Announcement Timezone. Valid values are strings of the zone name as found in the IANA time zone database. For example: UTC, Etc/UTC, or Europe/London
anonymizationstringYesThe Contest anonymization
dateAnnouncedstringYesThe Contest’s Announcement Datetime. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
dateEndstringYesEnd date of the contest. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
dateStartstringYesStart date of the contest. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
descriptionstringYesThe Contest description
divisionobjectNodivision
idstringNoThe globally unique identifier for the object.
metricsany[]YesThe Contest’s Metrics
participantIdsany[]YesThe Contest’s participants
prizesany[]YesThe Contest Prizes
profileIdstringYesThe Contest profile
selfUristringNoThe URI for this object
titlestringYesThe Contest title
winningCriteriastringYesThe Contest winning criteria

genesys_gamification_put_profile

Updates a performance profile Parameters:
ParameterTypeRequiredDefaultDescription
profileIdstringYesperformanceProfileId
activebooleanNoThe flag for active profiles
dateCreatedstringNoCreation date for this performance profile. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
descriptionstringNoA description about this performance profile
divisionobjectNodivision
idstringNoThe globally unique identifier for the object.
maxLeaderboardRankSizeintegerNoThe maximum rank size for the leaderboard. This counts the number of ranks can be retrieved in a leaderboard queries
memberCountintegerNoThe number of members in this performance profile
metricOrdersany[]NoOrder of the associated metrics. The list should contain valid ids for metrics
namestringNoA name for this performance profile
reportingIntervalsany[]NoThe reporting interval periods for this performance profile
selfUristringNoThe URI for this object

genesys_gamification_put_profile_metric

Updates a metric in performance profile Parameters:
ParameterTypeRequiredDefaultDescription
profileIdstringYesPerformance Profile Id
metricIdstringYesMetric Id
externalMetricDefinitionIdstringNoThe id of associated external metric definition
metricDefinitionIdstringNoThe id of associated metric definition
namestringYesThe name of this metric
objectiveobjectNoobjective
performanceProfileIdstringNoPerformance profile id of this metric
precisionintegerNoThe precision of the metric, must be between 0 and 5
timeDisplayUnitstringNoThe time unit in which the metric should be displayed — this parameter is ignored when displaying non-time values

genesys_gamification_put_status

Update gamification activation status Parameters:
ParameterTypeRequiredDefaultDescription
automaticUserAssignmentbooleanNoAutomatic assignment of users to the default profile
dateStartstringNoGamification start date. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
dateStartPersonalBeststringNoPersonal best aggregation starting date. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd
isActivebooleanNoGamification status of the organization.