/genesys-gamification | Type: Application | PCID required: Yes
Tools
genesys_gamification_delete_contest
Delete a Contest by Id Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
contestId | string | Yes | — | The ID of the contest |
genesys_gamification_delete_employeeperformance_externalmetrics_definition
Delete an External Metric Definition Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
metricId | string | Yes | — | Specifies the External Metric Definition ID |
genesys_gamification_get_contest
Get a Contest by Id Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
contestId | string | Yes | — | The ID of the contest |
genesys_gamification_get_contest_agents_scores
Get Contest Scores (Admin) Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
contestId | string | Yes | — | The ID of the contest |
pageNumber | integer | No | — | pageNumber |
pageSize | integer | No | — | pageSize |
workday | string | No | — | Target querying workday. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
returnsView | string | No | — | Desired response results |
genesys_gamification_get_contest_agents_scores_me
Get Contest Scores for the requesting Agent/Supervisor Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
contestId | string | Yes | — | The ID of the contest |
pageNumber | integer | No | — | pageNumber |
pageSize | integer | No | — | pageSize |
workday | string | No | — | Target querying workday. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
returnsView | string | No | — | Desired response results (Supervisor Only) |
genesys_gamification_get_contest_agents_scores_trends
Get a Contest Score Trend (Average Trend) Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
contestId | string | Yes | — | The ID of the contest |
genesys_gamification_get_contest_agents_scores_trends_me
Get a Contest Score Trend for the requesting Agent Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
contestId | string | Yes | — | The ID of the contest |
genesys_gamification_get_contest_prizeimage
Get a Contest Prize Image by Id Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
contestId | string | Yes | — | The ID of the contest |
prizeImageId | string | Yes | — | The ID of the prize image |
genesys_gamification_get_contests
Get a List of Contests (Admin) Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageNumber | integer | No | — | pageNumber |
pageSize | integer | No | — | pageSize |
dateStart | string | No | — | Start date for the query. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
dateEnd | string | No | — | End date for the query. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
status | any[] | No | — | status |
sortBy | string | No | — | sortBy |
sortOrder | string | No | — | sortOrder |
genesys_gamification_get_contests_me
Get a List of Contests (Agent/Supervisor) Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageNumber | integer | No | — | pageNumber |
pageSize | integer | No | — | pageSize |
dateStart | string | No | — | Start date for the query. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
dateEnd | string | No | — | End date for the query. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
status | any[] | No | — | status |
sortBy | string | No | — | sortBy |
sortOrder | string | No | — | sortOrder |
view | string | No | — | view |
genesys_gamification_get_employeeperformance_externalmetrics_definition
Get an External Metric Definition Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
metricId | string | Yes | — | Specifies 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageSize | integer | No | — | Page size |
pageNumber | integer | No | — | Page number |
genesys_gamification_get_insights
Get insights summary Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filterType | string | Yes | — | Filter type for the query request. |
filterId | string | Yes | — | ID for the filter type. |
granularity | string | Yes | — | Granularity |
comparativePeriodStartWorkday | string | Yes | — | The start work day of comparative period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
primaryPeriodStartWorkday | string | Yes | — | The start work day of primary period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
pageSize | integer | No | — | Page size |
pageNumber | integer | No | — | Page number |
sortKey | string | No | — | Sort key |
sortMetricId | string | No | — | Sort Metric Id |
sortOrder | string | No | — | Sort order |
userIds | string | No | — | A list of up to 100 comma-separated user Ids |
reportsTo | string | No | — | The reportsTo used by ABAC policies. |
genesys_gamification_get_insights_details
Get insights details for the current user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filterType | string | Yes | — | Filter type for the query request. |
filterId | string | Yes | — | ID for the filter type. |
granularity | string | Yes | — | Granularity |
comparativePeriodStartWorkday | string | Yes | — | The start work day of comparative period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
primaryPeriodStartWorkday | string | Yes | — | The start work day of primary period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
genesys_gamification_get_insights_groups_trends
Get insights overall trend for the current user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filterType | string | Yes | — | Filter type for the query request. |
filterId | string | Yes | — | ID for the filter type. |
granularity | string | Yes | — | Granularity |
comparativePeriodStartWorkday | string | Yes | — | The start work day of comparative period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
comparativePeriodEndWorkday | string | Yes | — | The end work day of comparative period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
primaryPeriodStartWorkday | string | Yes | — | The start work day of primary period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
primaryPeriodEndWorkday | string | Yes | — | The end work day of primary period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
genesys_gamification_get_insights_groups_trends_all
Get insights overall trend Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filterType | string | Yes | — | Filter type for the query request. |
filterId | string | Yes | — | ID for the filter type. |
granularity | string | Yes | — | Granularity |
comparativePeriodStartWorkday | string | Yes | — | The start work day of comparative period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
comparativePeriodEndWorkday | string | Yes | — | The end work day of comparative period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
primaryPeriodStartWorkday | string | Yes | — | The start work day of primary period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
primaryPeriodEndWorkday | string | Yes | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filterType | string | Yes | — | Filter type for the query request. |
filterId | string | Yes | — | ID for the filter type. |
granularity | string | Yes | — | Granularity |
startWorkday | string | Yes | — | The start work day. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
pageSize | integer | No | — | Page size |
pageNumber | integer | No | — | Page number |
genesys_gamification_get_insights_members
Query users in a profile during a period of time Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filterType | string | Yes | — | Filter type for the query request. |
filterId | string | Yes | — | ID for the filter type. |
granularity | string | Yes | — | Granularity |
startWorkday | string | Yes | — | The start work day. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
reportsTo | string | No | — | The reportsTo used by ABAC policies. |
genesys_gamification_get_insights_rankings
Get insights rankings Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filterType | string | Yes | — | Filter type for the query request. |
filterId | string | Yes | — | ID for the filter type. |
granularity | string | Yes | — | Granularity |
comparativePeriodStartWorkday | string | Yes | — | The start work day of comparative period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
primaryPeriodStartWorkday | string | Yes | — | The start work day of primary period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
sortKey | string | Yes | — | Sort key |
sortMetricId | string | No | — | Sort Metric Id |
sectionSize | integer | No | — | The number of top and bottom users to return before ties |
userIds | string | No | — | A list of up to 100 comma-separated user Ids |
reportsTo | string | No | — | The reportsTo used by ABAC policies. |
genesys_gamification_get_insights_trends
Get insights user trend for the current user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filterType | string | Yes | — | Filter type for the query request. |
filterId | string | Yes | — | ID for the filter type. |
granularity | string | Yes | — | Granularity |
comparativePeriodStartWorkday | string | Yes | — | The start work day of comparative period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
comparativePeriodEndWorkday | string | Yes | — | The end work day of comparative period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
primaryPeriodStartWorkday | string | Yes | — | The start work day of primary period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
primaryPeriodEndWorkday | string | Yes | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | The ID of a user. |
filterType | string | Yes | — | Filter type for the query request. |
filterId | string | Yes | — | ID for the filter type. |
granularity | string | Yes | — | Granularity |
comparativePeriodStartWorkday | string | Yes | — | The start work day of comparative period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
primaryPeriodStartWorkday | string | Yes | — | The start work day of primary period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
genesys_gamification_get_insights_user_trends
Get insights user trend for the user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | The ID of a user. |
filterType | string | Yes | — | Filter type for the query request. |
filterId | string | Yes | — | ID for the filter type. |
granularity | string | Yes | — | Granularity |
comparativePeriodStartWorkday | string | Yes | — | The start work day of comparative period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
comparativePeriodEndWorkday | string | Yes | — | The end work day of comparative period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
primaryPeriodStartWorkday | string | Yes | — | The start work day of primary period. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
primaryPeriodEndWorkday | string | Yes | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
startWorkday | string | Yes | — | Start workday to retrieve for the leaderboard. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
endWorkday | string | Yes | — | End workday to retrieve for the leaderboard. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
metricId | string | No | — | Metric 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filterType | string | Yes | — | Filter type for the query request. |
filterId | string | Yes | — | ID for the filter type. For example, division or performance profile Id |
startWorkday | string | Yes | — | Start workday to retrieve for the leaderboard. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
endWorkday | string | Yes | — | End workday to retrieve for the leaderboard. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
metricId | string | No | — | Metric 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filterType | string | Yes | — | Filter type for the query request. |
filterId | string | Yes | — | ID 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 divisiongenesys_gamification_get_metricdefinition
Metric definition by id Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
metricDefinitionId | string | Yes | — | metric definition id |
genesys_gamification_get_metricdefinitions
All metric definitionsgenesys_gamification_get_profile
Performance profile by id Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
profileId | string | Yes | — | performanceProfileId |
genesys_gamification_get_profile_members
Members of a given performance profile Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
profileId | string | Yes | — | Profile Id |
genesys_gamification_get_profile_metric
Performance profile gamified metric by id Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
profileId | string | Yes | — | Performance Profile Id |
metricId | string | Yes | — | Metric Id |
workday | string | No | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
profileId | string | Yes | — | Performance Profile Id |
expand | any[] | No | — | Which fields, if any, to expand. |
workday | string | No | — | The 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 |
metricIds | string | No | — | List 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
profileId | string | Yes | — | Performance Profile Id |
workday | string | No | — | The 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 profilesgenesys_gamification_get_profiles_user
Performance profile of a user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | userId |
workday | string | No | — | Target 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workday | string | No | — | Target 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workday | string | Yes | — | Target querying workday. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
expand | any[] | No | — | Which fields, if any, to expand. |
genesys_gamification_get_scorecards_attendance
Attendance status metrics of the requesting user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
startWorkday | string | Yes | — | Start workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
endWorkday | string | Yes | — | End 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 usergenesys_gamification_get_scorecards_points_alltime
All-time points of the requesting user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
endWorkday | string | Yes | — | End 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workday | string | Yes | — | The target workday. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
genesys_gamification_get_scorecards_points_trends
Points trends of the requesting user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
startWorkday | string | Yes | — | Start workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
endWorkday | string | Yes | — | End workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
dayOfWeek | string | No | — | Optional filter to specify which day of weeks to be included in the response |
genesys_gamification_get_scorecards_profile_metric_user_values_trends
Average performance values trends by metric of a user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
profileId | string | Yes | — | performanceProfileId |
metricId | string | Yes | — | metricId |
userId | string | Yes | — | userId |
startWorkday | string | Yes | — | Start workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
endWorkday | string | Yes | — | End workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
referenceWorkday | string | No | — | Reference 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 |
timeZone | string | No | — | Timezone for the workday. Defaults to UTC |
genesys_gamification_get_scorecards_profile_metric_users_values_trends
Average performance values trends by metric of a division or a performance profile Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
profileId | string | Yes | — | performanceProfileId |
metricId | string | Yes | — | metricId |
filterType | string | Yes | — | Filter type for the query request. |
filterId | string | No | — | ID for the filter type. Only required when filterType is Division. |
startWorkday | string | Yes | — | Start workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
endWorkday | string | Yes | — | End workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
referenceWorkday | string | No | — | Reference 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 |
timeZone | string | No | — | Timezone for the workday. Defaults to UTC |
genesys_gamification_get_scorecards_profile_metric_values_trends
Average performance values trends by metric of the requesting user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
profileId | string | Yes | — | performanceProfileId |
metricId | string | Yes | — | metricId |
filterType | string | No | — | Filter type for the query request. If not set, returns the values trends of the requesting user |
startWorkday | string | Yes | — | Start workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
endWorkday | string | Yes | — | End workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
referenceWorkday | string | No | — | Reference 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 |
timeZone | string | No | — | Timezone for the workday. Defaults to UTC |
genesys_gamification_get_scorecards_user
Workday performance metrics for a user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | userId |
workday | string | Yes | — | Target querying workday. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
expand | any[] | No | — | Which fields, if any, to expand. |
genesys_gamification_get_scorecards_user_attendance
Attendance status metrics for a user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | userId |
startWorkday | string | Yes | — | Start workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
endWorkday | string | Yes | — | End 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | userId |
genesys_gamification_get_scorecards_user_points_alltime
All-time points for a user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | userId |
endWorkday | string | Yes | — | End workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
genesys_gamification_get_scorecards_user_points_trends
Points trend for a user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | userId |
startWorkday | string | Yes | — | Start workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
endWorkday | string | Yes | — | End workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
dayOfWeek | string | No | — | Optional filter to specify which day of weeks to be included in the response |
genesys_gamification_get_scorecards_user_values_trends
Values trends of a user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | userId |
startWorkday | string | Yes | — | Start workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
endWorkday | string | Yes | — | End workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
timeZone | string | No | — | Timezone for the workday. Defaults to UTC |
genesys_gamification_get_scorecards_users_points_average
Workday average points by target group Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filterType | string | Yes | — | Filter type for the query request. |
filterId | string | Yes | — | ID for the filter type. |
workday | string | Yes | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filterType | string | Yes | — | Filter type for the query request. |
filterId | string | Yes | — | ID for the filter type. For example, division Id |
workday | string | Yes | — | The target workday. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
timeZone | string | No | — | Timezone for the workday. Defaults to UTC |
genesys_gamification_get_scorecards_users_values_trends
Values trend by target group Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filterType | string | Yes | — | Filter type for the query request. |
filterId | string | Yes | — | ID for the filter type. |
startWorkday | string | Yes | — | Start workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
endWorkday | string | Yes | — | End workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
timeZone | string | No | — | Timezone for the workday. Defaults to UTC |
genesys_gamification_get_scorecards_values_average
Average values of the requesting user’s division or performance profile Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workday | string | Yes | — | The target workday. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
timeZone | string | No | — | Timezone for the workday. Defaults to UTC |
genesys_gamification_get_scorecards_values_trends
Values trends of the requesting user or group Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filterType | string | No | — | Filter type for the query request. If not set, then the request is for the requesting user. |
referenceWorkday | string | No | — | Reference 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 |
startWorkday | string | Yes | — | Start workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
endWorkday | string | Yes | — | End workday of querying workdays range. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
timeZone | string | No | — | Timezone for the workday. Defaults to UTC |
genesys_gamification_get_status
Gamification activation statusgenesys_gamification_get_template
Objective template by id Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
templateId | string | Yes | — | template id |
genesys_gamification_get_templates
All objective templatesgenesys_gamification_patch_contest
Finalize a Contest by Id Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
contestId | string | Yes | — | The ID of the contest |
disqualifiedAgents | any[] | No | — | The Contest finalization disqualified agents |
status | string | Yes | — | The Contest finalization status |
winners | any[] | No | — | The Contest finalization winners |
genesys_gamification_patch_employeeperformance_externalmetrics_definition
Update External Metric Definition Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
metricId | string | Yes | — | Specifies the metric definition ID |
defaultObjectiveType | string | No | — | The default objective type of the External Metric Definition |
enabled | boolean | No | — | True if the External Metric Definition is enabled |
name | string | No | — | The name of the External Metric Definition |
precision | integer | No | — | The decimal precision of the External Metric Definition. Must be at least 0 and at most 5 |
genesys_gamification_post_contests
Creates a Contest Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
announcementTimezone | string | Yes | — | The 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 |
anonymization | string | Yes | — | The Contest anonymization |
dateAnnounced | string | Yes | — | The Contest’s Announcement Datetime. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
dateEnd | string | Yes | — | End date of the contest. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
dateStart | string | Yes | — | Start date of the contest. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
description | string | Yes | — | The Contest description |
division | object | No | — | division |
id | string | No | — | The globally unique identifier for the object. |
metrics | any[] | Yes | — | The Contest’s Metrics |
participantIds | any[] | Yes | — | The Contest’s participants |
prizes | any[] | Yes | — | The Contest Prizes |
profileId | string | Yes | — | The Contest profile |
selfUri | string | No | — | The URI for this object |
title | string | Yes | — | The Contest title |
winningCriteria | string | Yes | — | The Contest winning criteria |
genesys_gamification_post_contests_uploads_prizeimages
Generates pre-signed URL to upload a prize image for gamification contests Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
contentLength | integer | Yes | — | The size of the file to upload. |
contentMd5 | string | No | — | Content MD5 of the file to upload |
contentType | string | Yes | — | The content type of the file to upload. |
fileName | string | No | — | Name 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: {^}%`]”>[~<#| |
serverSideEncryption | string | No | — | serverSideEncryption |
signedUrlTimeoutSeconds | integer | No | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
items | any[] | No | — | A list of external metric data items. A maximum of 100 items are allowed. |
genesys_gamification_post_employeeperformance_externalmetrics_definitions
Create External Metric Definition Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
defaultObjectiveType | string | No | — | The default objective type of the External Metric Definition |
enabled | boolean | No | — | True if the External Metric Definition is enabled |
name | string | No | — | The name of the External Metric Definition |
precision | integer | No | — | The decimal precision of the External Metric Definition. Must be at least 0 and at most 5 |
unit | string | No | — | The unit of the External Metric Definition |
unitDefinition | string | No | — | The unit definition of the External Metric Definition |
genesys_gamification_post_profile_activate
Activate a performance profile Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
profileId | string | Yes | — | performanceProfileId |
genesys_gamification_post_profile_deactivate
Deactivate a performance profile Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
profileId | string | Yes | — | performanceProfileId |
genesys_gamification_post_profile_members
Assign members to a given performance profile Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
profileId | string | Yes | — | Profile Id |
membersToAssign | any[] | Yes | — | List of user ids to assign to a performance profile |
membersToRemove | any[] | Yes | — | List of user ids to remove from a performance profile |
genesys_gamification_post_profile_members_validate
Validate member assignment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
profileId | string | Yes | — | Profile Id |
membersToAssign | any[] | Yes | — | List of user ids to assign to a performance profile |
genesys_gamification_post_profile_metric_link
Creates a linked metric Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
sourceProfileId | string | Yes | — | Source Performance Profile Id |
sourceMetricId | string | Yes | — | Source Metric Id |
targetPerformanceProfileId | string | Yes | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
profileId | string | Yes | — | Performance Profile Id |
externalMetricDefinitionId | string | No | — | The id of associated external metric definition |
metricDefinitionId | string | No | — | The id of associated metric definition |
name | string | Yes | — | The name of this metric |
objective | object | No | — | objective |
performanceProfileId | string | No | — | Performance profile id of this metric |
precision | integer | No | — | The precision of the metric, must be between 0 and 5 |
timeDisplayUnit | string | No | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
copyMetrics | boolean | No | — | Flag 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. |
active | boolean | Yes | — | The flag for active profiles |
dateCreated | string | No | — | Creation date for this performance profile. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
description | string | Yes | — | A description about this performance profile |
division | object | Yes | — | division |
id | string | No | — | The globally unique identifier for the object. |
maxLeaderboardRankSize | integer | Yes | — | The maximum rank size for the leaderboard. This counts the number of ranks can be retrieved in a leaderboard queries |
memberCount | integer | No | — | The number of members in this performance profile |
metricOrders | any[] | No | — | Order of the associated metrics. The list should contain valid ids for metrics |
name | string | Yes | — | A name for this performance profile |
reportingIntervals | any[] | Yes | — | The reporting interval periods for this performance profile |
selfUri | string | No | — | The URI for this object |
genesys_gamification_post_profiles_user_query
Query performance profiles in date range for a user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | The ID of a user. |
endWorkday | string | Yes | — | End work day in ISO-8601 format used in the date range. |
startWorkday | string | Yes | — | Start 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
endWorkday | string | Yes | — | End work day in ISO-8601 format used in the date range. |
startWorkday | string | Yes | — | Start work day in ISO-8601 format used in the date range. |
genesys_gamification_put_contest
Update a Contest by Id Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
contestId | string | Yes | — | The ID of the contest |
announcementTimezone | string | Yes | — | The 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 |
anonymization | string | Yes | — | The Contest anonymization |
dateAnnounced | string | Yes | — | The Contest’s Announcement Datetime. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
dateEnd | string | Yes | — | End date of the contest. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
dateStart | string | Yes | — | Start date of the contest. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
description | string | Yes | — | The Contest description |
division | object | No | — | division |
id | string | No | — | The globally unique identifier for the object. |
metrics | any[] | Yes | — | The Contest’s Metrics |
participantIds | any[] | Yes | — | The Contest’s participants |
prizes | any[] | Yes | — | The Contest Prizes |
profileId | string | Yes | — | The Contest profile |
selfUri | string | No | — | The URI for this object |
title | string | Yes | — | The Contest title |
winningCriteria | string | Yes | — | The Contest winning criteria |
genesys_gamification_put_profile
Updates a performance profile Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
profileId | string | Yes | — | performanceProfileId |
active | boolean | No | — | The flag for active profiles |
dateCreated | string | No | — | Creation date for this performance profile. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
description | string | No | — | A description about this performance profile |
division | object | No | — | division |
id | string | No | — | The globally unique identifier for the object. |
maxLeaderboardRankSize | integer | No | — | The maximum rank size for the leaderboard. This counts the number of ranks can be retrieved in a leaderboard queries |
memberCount | integer | No | — | The number of members in this performance profile |
metricOrders | any[] | No | — | Order of the associated metrics. The list should contain valid ids for metrics |
name | string | No | — | A name for this performance profile |
reportingIntervals | any[] | No | — | The reporting interval periods for this performance profile |
selfUri | string | No | — | The URI for this object |
genesys_gamification_put_profile_metric
Updates a metric in performance profile Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
profileId | string | Yes | — | Performance Profile Id |
metricId | string | Yes | — | Metric Id |
externalMetricDefinitionId | string | No | — | The id of associated external metric definition |
metricDefinitionId | string | No | — | The id of associated metric definition |
name | string | Yes | — | The name of this metric |
objective | object | No | — | objective |
performanceProfileId | string | No | — | Performance profile id of this metric |
precision | integer | No | — | The precision of the metric, must be between 0 and 5 |
timeDisplayUnit | string | No | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
automaticUserAssignment | boolean | No | — | Automatic assignment of users to the default profile |
dateStart | string | No | — | Gamification start date. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
dateStartPersonalBest | string | No | — | Personal best aggregation starting date. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
isActive | boolean | No | — | Gamification status of the organization. |

