/genesys-workforce | Type: Application | PCID required: Yes
Tools
genesys_workforce_delete_managementunit
Delete management unit Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
genesys_workforce_delete_managementunit_timeofflimit
Deletes a time off limit object Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit. |
timeOffLimitId | string | Yes | — | The ID of the time off limit object to delete |
genesys_workforce_delete_managementunit_timeoffplan
Deletes a time off plan Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit |
timeOffPlanId | string | Yes | — | The ID of the time off plan to delete |
genesys_workforce_delete_managementunit_workplan
Delete a work plan Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
workPlanId | string | Yes | — | The ID of the work plan to delete |
genesys_workforce_delete_managementunit_workplanrotation
Delete a work plan rotation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
workPlanRotationId | string | Yes | — | The ID of the work plan rotation to be deleted |
genesys_workforce_get_adherence
Get a list of UserScheduleAdherence records for the requested users Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | any[] | Yes | — | User Id(s) for which to fetch current schedule adherence information. Min 1, Max of 100 userIds per request |
genesys_workforce_get_adherence_explanation
Get an adherence explanation for the current user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
explanationId | string | Yes | — | The ID of the explanation to update |
genesys_workforce_get_adherence_explanations_job
Query the status of an adherence explanation operation. Only the user who started the operation can query the status Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
jobId | string | Yes | — | The ID of the job |
genesys_workforce_get_adherence_historical_job
Query the status of a historical adherence request operation. Only the user who started the operation can query the status Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
jobId | string | Yes | — | jobId |
genesys_workforce_get_agent_adherence_explanation
Get an adherence explanation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
agentId | string | Yes | — | The ID of the agent to query |
explanationId | string | Yes | — | The ID of the explanation to update |
genesys_workforce_get_agent_managementunit
Get the management unit to which the agent belongs Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
agentId | string | Yes | — | The ID of the agent to look up |
genesys_workforce_get_agents_me_adherence_historical_job
Request to fetch the status of the agent adherence job. Only the user who started the operation can query the status Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
jobId | string | Yes | — | ID of the job to get |
genesys_workforce_get_agents_me_managementunit
Get the management unit to which the currently logged in agent belongsgenesys_workforce_get_managementunit
Get management unit Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
expand | any[] | No | — | expand |
genesys_workforce_get_managementunit_adherence
Get a list of user schedule adherence records for the requested management unit Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit |
forceDownloadService | boolean | No | — | Force the result of this operation to be sent via download service. For testing/app development purposes |
genesys_workforce_get_managementunit_agent
Get data for agent in the management unit Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
agentId | string | Yes | — | The agent id |
excludeCapabilities | boolean | No | — | Excludes all capabilities of the agent such as queues, languages, and skills |
expand | any[] | No | — | expand |
genesys_workforce_get_managementunit_agent_shifttrades
Gets all the shift trades for a given agent Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
agentId | string | Yes | — | The agent id |
genesys_workforce_get_managementunit_shifttrades_matched
Gets a summary of all shift trades in the matched state Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
genesys_workforce_get_managementunit_shifttrades_users
Gets list of users available for whom you can send direct shift trade requests Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
genesys_workforce_get_managementunit_timeofflimit
Gets a time off limit object Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit. |
timeOffLimitId | string | Yes | — | The ID of the time off limit to fetch |
genesys_workforce_get_managementunit_timeofflimits
Gets a list of time off limit objects under management unit. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit. |
genesys_workforce_get_managementunit_timeoffplan
Gets a time off plan Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit |
timeOffPlanId | string | Yes | — | The ID of the time off plan to fetch |
genesys_workforce_get_managementunit_timeoffplans
Gets a list of time off plans Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit |
genesys_workforce_get_managementunit_user_timeoffrequest
Get a time off request Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
userId | string | Yes | — | The userId to whom the Time Off Request applies. |
timeOffRequestId | string | Yes | — | Time Off Request Id |
genesys_workforce_get_managementunit_user_timeoffrequest_timeofflimits
Retrieves time off limit, allocated and waitlisted values according to specific time off request Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit. |
userId | string | Yes | — | The userId to whom the time off request applies. |
timeOffRequestId | string | Yes | — | The ID of the time off request, which dates and activityCodeId determine limit values to retrieve |
genesys_workforce_get_managementunit_user_timeoffrequests
Get a list of time off requests for a given user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
userId | string | Yes | — | The userId to whom the Time Off Request applies. |
genesys_workforce_get_managementunit_users
Get users in the management unit Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
genesys_workforce_get_managementunit_week_shifttrades
Gets all the shift trades for a given week Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
weekDateId | string | Yes | — | The start week date of the initiating shift in yyyy-MM-dd format. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
evaluateMatches | boolean | No | — | Whether to evaluate the matches for violations |
includeCrossWeekShifts | boolean | No | — | Whether to include all shift trades with either the initiating shift or the receiving shift in the week |
forceDownloadService | boolean | No | — | Force the result of this operation to be sent via download service. For testing/app development purposes |
genesys_workforce_get_managementunit_workplan
Get a work plan Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
workPlanId | string | Yes | — | The ID of the work plan to fetch |
includeOnly | any[] | No | — | limit response to the specified fields |
genesys_workforce_get_managementunit_workplanrotation
Get a work plan rotation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
workPlanRotationId | string | Yes | — | The ID of the work plan rotation to fetch |
genesys_workforce_get_managementunit_workplanrotations
Get work plan rotations Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
expand | any[] | No | — | expand |
genesys_workforce_get_managementunit_workplans
Get work plans Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
expand | any[] | No | — | Include to access additional data on the work plans |
exclude | any[] | No | — | Exclude specific data on the work plans from the response |
genesys_workforce_get_managementunits
Get management units Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageSize | integer | No | — | Deprecated, paging is not supported |
pageNumber | integer | No | — | Deprecated, paging is not supported |
expand | string | No | — | Deprecated, expand settings on the single MU route |
feature | string | No | — | If specified, the list of management units for which the user is authorized to use the requested feature will be returned |
divisionId | string | No | — | If specified, the list of management units belonging to the specified division will be returned |
genesys_workforce_get_notifications
Get a list of notifications for the current usergenesys_workforce_get_shifttrades
Gets all of my shift tradesgenesys_workforce_get_team_adherence
Get a list of user schedule adherence records for the requested team Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
teamId | string | Yes | — | The ID of the team |
genesys_workforce_get_timeoffbalance_job
Query the results of time off types job Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
jobId | string | Yes | — | The ID of the job. |
genesys_workforce_get_timeoffrequest
Get a time off request for the current user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
timeOffRequestId | string | Yes | — | The ID of the time off request |
genesys_workforce_get_timeoffrequest_waitlistpositions
Get the daily waitlist positions of a time off request for the current user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
timeOffRequestId | string | Yes | — | The ID of the time off request |
genesys_workforce_get_timeoffrequests
Get a list of time off requests for the current usergenesys_workforce_get_workforcemanagement_adherence
Get a list of UserScheduleAdherence records for the requested users Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | any[] | Yes | — | User Id(s) for which to fetch current schedule adherence information. Min 1, Max of 100 userIds per request |
genesys_workforce_get_workforcemanagement_managementunit
Get management unit Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
expand | any[] | No | — | expand |
genesys_workforce_get_workforcemanagement_managementunit_adherence
Get a list of user schedule adherence records for the requested management unit Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit |
forceDownloadService | boolean | No | — | Force the result of this operation to be sent via download service. For testing/app development purposes |
genesys_workforce_get_workforcemanagement_managementunit_agent
Get data for agent in the management unit Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
agentId | string | Yes | — | The agent id |
excludeCapabilities | boolean | No | — | Excludes all capabilities of the agent such as queues, languages, and skills |
expand | any[] | No | — | expand |
genesys_workforce_get_workforcemanagement_managementunit_user_timeoffrequests
Get a list of time off requests for a given user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
userId | string | Yes | — | The userId to whom the Time Off Request applies. |
genesys_workforce_get_workforcemanagement_managementunit_users
Get users in the management unit Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
genesys_workforce_get_workforcemanagement_managementunits
Get management units Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageSize | integer | No | — | Deprecated, paging is not supported |
pageNumber | integer | No | — | Deprecated, paging is not supported |
expand | string | No | — | Deprecated, expand settings on the single MU route |
feature | string | No | — | If specified, the list of management units for which the user is authorized to use the requested feature will be returned |
divisionId | string | No | — | If specified, the list of management units belonging to the specified division will be returned |
genesys_workforce_get_workforcemanagement_notifications
Get a list of notifications for the current usergenesys_workforce_get_workforcemanagement_team_adherence
Get a list of user schedule adherence records for the requested team Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
teamId | string | Yes | — | The ID of the team |
genesys_workforce_get_workforcemanagement_timeoffrequest
Get a time off request for the current user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
timeOffRequestId | string | Yes | — | The ID of the time off request |
genesys_workforce_get_workforcemanagement_timeoffrequests
Get a list of time off requests for the current usergenesys_workforce_patch_agent_adherence_explanation
Update an adherence explanation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
agentId | string | Yes | — | The ID of the agent to query |
explanationId | string | Yes | — | The ID of the explanation to update |
status | string | No | — | The status of the adherence explanation |
genesys_workforce_patch_managementunit
Update the requested management unit Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
divisionId | string | No | — | The new division id for the management unit |
name | string | No | — | The new name of the management unit |
settings | object | No | — | settings |
genesys_workforce_patch_managementunit_agents
Update agent configurations Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
entities | any[] | No | — | List of agents to update |
genesys_workforce_patch_managementunit_timeofflimit
Updates a time off limit object. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit. |
timeOffLimitId | string | Yes | — | The id of time off limit object to update |
defaultLimitMinutes | integer | No | — | The default time off limit value in minutes per granularity |
metadata | object | Yes | — | metadata |
genesys_workforce_patch_managementunit_timeoffplan
Updates a time off plan Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit |
timeOffPlanId | string | Yes | — | The ID of the time off plan to update |
active | boolean | No | — | Whether this time off plan should be used by agents. |
activityCodeIds | object | No | — | activityCodeIds |
autoApprovalRule | string | No | — | Auto approval rule for the time off plan. |
daysBeforeStartToExpireFromWaitlist | integer | No | — | The number of days before the time off request start date for when the request will be expired from the waitlist. |
hrisTimeOffType | object | No | — | hrisTimeOffType |
metadata | object | Yes | — | metadata |
name | string | No | — | The name of this time off plan. |
timeOffLimitIds | object | No | — | timeOffLimitIds |
genesys_workforce_patch_managementunit_timeoffrequest_user_integrationstatus
Set integration status for a time off request. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit. |
timeOffRequestId | string | Yes | — | The ID of the time off request. |
userId | string | Yes | — | The ID of user to whom the time off request belongs. |
integrationStatus | string | Yes | — | The integration status value for the time off request |
genesys_workforce_patch_managementunit_user_timeoffrequest
Update a time off request Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
userId | string | Yes | — | The id of the user the requested time off request belongs to |
timeOffRequestId | string | Yes | — | The id of the time off request to update |
activityCodeId | string | No | — | The ID of the activity code associated with this time off request. Activity code must be of the TimeOff category |
dailyDurationMinutes | integer | No | — | The daily duration of this time off request in minutes |
durationMinutes | any[] | No | — | Daily durations for each day of this time off request in minutes |
fullDayManagementUnitDates | any[] | No | — | A set of dates in yyyy-MM-dd format. Should be interpreted in the management unit’s configured time zone. |
metadata | object | Yes | — | metadata |
notes | string | No | — | Notes about the time off request |
paid | boolean | No | — | Whether this is a paid time off request |
partialDayStartDateTimes | any[] | No | — | A set of start date-times in ISO-8601 format for partial day requests. |
payableMinutes | any[] | No | — | Payable minutes for each day of this time off request |
status | string | No | — | The status of this time off request |
genesys_workforce_patch_managementunit_week_shifttrade
Updates a shift trade. This route can only be called by the initiating agent Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
weekDateId | string | Yes | — | The start week date of the initiating shift in yyyy-MM-dd format. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
tradeId | string | Yes | — | The ID of the shift trade to update |
acceptableIntervals | object | No | — | acceptableIntervals |
expiration | object | No | — | expiration |
metadata | object | Yes | — | metadata |
receivingUserId | object | No | — | receivingUserId |
genesys_workforce_patch_managementunit_workplan
Update a work plan Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
workPlanId | string | Yes | — | The ID of the work plan to update |
validationMode | string | No | — | Allows to update work plan even if validation result is invalid |
agentCount | integer | No | — | Number of agents in this work plan |
agents | any[] | No | — | Agents in this work plan |
constrainMaximumConsecutiveWorkingDays | boolean | No | — | Whether to constrain the maximum consecutive working days |
constrainMaximumConsecutiveWorkingWeekends | boolean | No | — | Whether to constrain the maximum consecutive working weekends |
constrainMaximumWorkingWeekendsPerPlanningPeriod | boolean | No | — | Whether to constrain the maximum working weekends in the planning period |
constrainMinimumTimeBetweenShifts | boolean | No | — | Whether the minimum time between shifts constraint is enabled for this work plan |
constrainPaidTimeGranularity | boolean | No | — | Whether paid time granularity is constrained for this work plan |
constrainWeeklyPaidTime | boolean | No | — | Whether the weekly paid time constraint is enabled for this work plan |
enabled | boolean | No | — | Whether the work plan is enabled for scheduling |
flexibleWeeklyPaidTime | boolean | No | — | Whether the weekly paid time constraint is flexible for this work plan |
id | string | No | — | The globally unique identifier for the object. |
maximumConsecutiveWorkingDays | integer | No | — | The maximum number of consecutive days that agents assigned to this work plan are allowed to work. Used if constrainMaximumConsecutiveWorkingDays == true |
maximumConsecutiveWorkingWeekends | integer | No | — | The maximum number of consecutive weekends that agents who are assigned to this work plan are allowed to work |
maximumDays | integer | No | — | Maximum number days in a week allowed to be scheduled for this work plan |
maximumDaysOffPerPlanningPeriod | integer | No | — | Maximum days off in the planning period |
maximumPaidMinutesPerPlanningPeriod | integer | No | — | Maximum paid minutes in the planning period |
maximumWorkingWeekendsPerPlanningPeriod | integer | No | — | Maximum working weekends in the planning period |
metadata | object | Yes | — | metadata |
minimumConsecutiveNonWorkingMinutesPerWeek | integer | No | — | Minimum amount of consecutive non working minutes per week that agents who are assigned this work plan are allowed to have off |
minimumDaysOffPerPlanningPeriod | integer | No | — | Minimum days off in the planning period |
minimumPaidMinutesPerPlanningPeriod | integer | No | — | Minimum paid minutes in the planning period |
minimumShiftStartDistanceMinutes | integer | No | — | The time period in minutes for the duration between the start times of two consecutive working days |
minimumTimeBetweenShiftsMinutes | integer | No | — | Minimum time between shifts in minutes defined in this work plan. Used if constrainMinimumTimeBetweenShifts == true |
minimumWorkingDaysPerWeek | integer | No | — | The minimum number of days that agents assigned to a work plan must work per week |
name | string | No | — | name |
optionalDays | object | No | — | optionalDays |
paidTimeGranularityMinutes | integer | No | — | Granularity in minutes allowed for shift paid time in this work plan. Used if constrainPaidTimeGranularity == true |
selfUri | string | No | — | The URI for this object |
shifts | any[] | No | — | Shifts in this work plan |
shiftStartVariancePeriod | string | No | — | The length of the period over which the maximum shift start time variance is applied |
shiftStartVariances | object | No | — | shiftStartVariances |
shiftStartVarianceType | string | No | — | This constraint ensures that an agent starts each workday within a user-defined time threshold |
valid | boolean | No | — | Whether the work plan is valid or not |
weeklyExactPaidMinutes | integer | No | — | Exact weekly paid time in minutes for this work plan. Used if flexibleWeeklyPaidTime == false |
weeklyMaximumPaidMinutes | integer | No | — | Maximum weekly paid time in minutes for this work plan. Used if flexibleWeeklyPaidTime == true |
weeklyMinimumPaidMinutes | integer | No | — | Minimum weekly paid time in minutes for this work plan. Used if flexibleWeeklyPaidTime == true |
genesys_workforce_patch_managementunit_workplanrotation
Update a work plan rotation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
workPlanRotationId | string | Yes | — | The ID of the work plan rotation to update |
agents | any[] | No | — | Agents in this work plan rotation |
dateRange | object | No | — | dateRange |
enabled | boolean | No | — | Whether the work plan rotation is enabled for scheduling |
metadata | object | Yes | — | metadata |
name | string | No | — | Name of this work plan rotation |
pattern | object | No | — | pattern |
genesys_workforce_patch_timeoffrequest
Update a time off request for the current user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
timeOffRequestId | string | Yes | — | The ID of the time off request |
markedAsRead | boolean | No | — | Whether this request has been read by the agent |
notes | string | No | — | Notes about the time off request. Can only be edited while the request is still pending |
status | string | No | — | The status of this time off request. Can only be canceled if the requested date has not already passed |
genesys_workforce_post_adherence_explanations
Submit an adherence explanation for the current user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
lengthMinutes | integer | Yes | — | The length of the adherence explanation in minutes |
notes | string | No | — | Notes about the adherence explanation |
startDate | string | Yes | — | The start timestamp of the adherence explanation in ISO-8601 format |
type | string | Yes | — | The type of the adherence explanation |
genesys_workforce_post_adherence_explanations_query
Query adherence explanations for the current user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
forceAsync | boolean | No | — | Force the result of this operation to be sent asynchronously via notification. For testing/app development purposes |
forceDownloadService | boolean | No | — | Force the result of this operation to be sent via download service. For testing/app development purposes |
endDate | string | Yes | — | The end date of the range to query. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
startDate | string | Yes | — | The start date of the range to query. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
genesys_workforce_post_agent_adherence_explanations
Add an adherence explanation for the requested user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
agentId | string | Yes | — | The ID of the agent to query |
lengthMinutes | integer | Yes | — | The length of the adherence explanation in minutes |
notes | string | No | — | Notes about the adherence explanation |
startDate | string | Yes | — | The start timestamp of the adherence explanation in ISO-8601 format |
status | string | No | — | The status of the adherence explanation |
type | string | Yes | — | The type of the adherence explanation |
genesys_workforce_post_agent_adherence_explanations_query
Query adherence explanations for the given agent across a specified range Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
agentId | string | Yes | — | The ID of the agent to query |
forceAsync | boolean | No | — | Force the result of this operation to be sent asynchronously via notification. For testing/app development purposes |
forceDownloadService | boolean | No | — | Force the result of this operation to be sent via download service. For testing/app development purposes |
endDate | string | Yes | — | The end date of the range to query. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
startDate | string | Yes | — | The start date of the range to query. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
genesys_workforce_post_agents
Move agents in and out of management unit Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
destinationManagementUnitId | string | No | — | The id of the management unit for which the move will be performed. To remove users from their management unit this should be set to null. |
userIds | any[] | Yes | — | The list of user ids to move |
genesys_workforce_post_agents_me_adherence_historical_jobs
Request an agent historical adherence report Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
expand | any[] | No | — | Which fields, if any, to expand with. wfm:AgentHistoricalAdherenceConformance:view permission is required for conformance, and wfm:agentSchedule:view permission is required for scheduledActivities. |
endDate | string | No | — | End of the date range to query in ISO-8601 format. If it is not set, end date will be set to current time |
startDate | string | No | — | Beginning of the date range to query in ISO-8601 format |
timeZone | string | No | — | The time zone, in olson format, to use in defining days when computing adherence. The results will be returned as UTC timestamps regardless of the time zone input. |
genesys_workforce_post_agents_me_possibleworkshifts
Get agent possible work shifts for requested time frame Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
weekCount | integer | Yes | — | Number of weeks for which to return possible work shifts |
weekStartDate | string | Yes | — | Start date of requested effective work plan, day of week will be in line with business unit start day of week. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
genesys_workforce_post_agentschedules_managementunits_mine
Fetch agent schedules for the logged in user’s management unit Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
forceAsync | boolean | No | — | Force the result of this operation to be sent asynchronously via notification. For testing/app development purposes |
forceDownloadService | boolean | No | — | Force the result of this operation to be sent via download service. For testing/app development purposes |
endDate | string | Yes | — | The end date for the range to query the schedule’s for the agent’s management unit. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
startDate | string | Yes | — | The start date for the range to query the schedule’s for the agent’s management unit. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
genesys_workforce_post_agentschedules_mine
Get published schedule for the current user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
endDate | string | Yes | — | End date of the range to search. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
startDate | string | Yes | — | Start date of the range to search. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
genesys_workforce_post_managementunit_agents_workplans_query
Get agents work plans configuration Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
forceDownloadService | boolean | No | — | Force the result of this operation to be sent via download service. For testing/app development purposes |
agentIds | any[] | Yes | — | The list of agent IDs |
startDate | string | Yes | — | The start of a date in yyyy-MM-dd format. Response contains values rolled back to nearest BU start day of week. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
weekCount | integer | Yes | — | The number of weeks to query |
genesys_workforce_post_managementunit_agentschedules_search
Query published schedules for given given time range for set of users Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
forceAsync | boolean | No | — | Force the result of this operation to be sent asynchronously via notification. For testing/app development purposes |
forceDownloadService | boolean | No | — | Force the result of this operation to be sent via download service. For testing/app development purposes |
endDate | string | Yes | — | End date of the range to search. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
startDate | string | Yes | — | Start date of the range to search. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
userIds | any[] | No | — | IDs of the users for whose schedules to search |
genesys_workforce_post_managementunit_historicaladherencequery
Request a historical adherence report Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit |
endDate | string | No | — | End of the date range to query in ISO-8601 format. If it is not set, end date will be set to current time |
includeExceptions | boolean | No | — | Whether user exceptions should be returned as part of the results |
startDate | string | Yes | — | Beginning of the date range to query in ISO-8601 format |
teamIds | any[] | No | — | The teamIds to report on. If null or not set, adherence will be computed for requested users if applicable or otherwise all users in the management unit. Note: If teamIds is also specified, only adherence for users in the requested teams will be returned |
timeZone | string | No | — | The time zone, in olson format, to use in defining days when computing adherence. The results will be returned as UTC timestamps regardless of the time zone input. |
userIds | any[] | No | — | The userIds to report on. If null or not set, adherence will be computed for all the users in management unit or requested teamIds |
genesys_workforce_post_managementunit_move
Move the requested management unit to a new business unit Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
businessUnitId | string | Yes | — | The ID of the business unit to which to move the management unit |
genesys_workforce_post_managementunit_timeofflimits
Creates a new time off limit object under management unit. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit. |
defaultLimitMinutes | integer | No | — | The default limit value in minutes per granularity. If not specified, then 0 is assumed, which means there are no time off minutes available |
granularity | string | No | — | Granularity choice for time off limit. If not specified, ‘Daily’ is assumed |
genesys_workforce_post_managementunit_timeofflimits_values_query
Retrieves time off limit related values based on a given set of filters. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit. |
activityCodeId | string | No | — | The ID of the activity code by which to filter the affected limit objects. Required if timeOffLimitId is not specified |
dateRanges | any[] | Yes | — | The list of the date ranges to return time off limit, allocated and waitlisted minutes. The valid number of date ranges is between 1 and 30. Maximum total number of days in all ranges in 366. |
timeOffLimitId | string | No | — | The time off limit object id to retrieve values for. Required if activityCodeId is not specified |
genesys_workforce_post_managementunit_timeoffplans
Creates a new time off plan Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit |
active | boolean | Yes | — | Whether this time off plan should be used by agents. |
activityCodeIds | any[] | No | — | The set of activity code IDs to associate with this time off plan. |
autoApprovalRule | string | Yes | — | Auto approval rule for the time off plan. |
daysBeforeStartToExpireFromWaitlist | integer | No | — | The number of days before the time off request start date for when the request will be expired from the waitlist. |
hrisTimeOffType | object | No | — | hrisTimeOffType |
name | string | Yes | — | The name of this time off plan. |
timeOffLimitIds | any[] | No | — | The set of time off limit IDs to associate with this time off plan. |
genesys_workforce_post_managementunit_timeoffrequests
Create a new time off request Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
activityCodeId | string | Yes | — | The ID of the activity code associated with this time off request. Activity code must be of the TimeOff category |
dailyDurationMinutes | integer | Yes | — | The daily duration of this time off request in minutes |
durationMinutes | any[] | No | — | Daily durations for each day of this time off request in minutes |
fullDayManagementUnitDates | any[] | No | — | A set of dates in yyyy-MM-dd format. Should be interpreted in the management unit’s configured time zone. |
notes | string | No | — | Notes about the time off request |
paid | boolean | No | — | Whether this is a paid time off request |
partialDayStartDateTimes | any[] | No | — | A set of start date-times in ISO-8601 format for partial day requests. |
payableMinutes | any[] | No | — | Payable minutes for each day of this time off request |
status | string | Yes | — | The status of this time off request |
users | any[] | Yes | — | A set of IDs for users to associate with this time off request |
genesys_workforce_post_managementunit_timeoffrequests_integrationstatus_query
Retrieves integration statuses for a list of time off requests Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit. |
timeOffRequestLookups | any[] | Yes | — | A list of time off request lookups |
genesys_workforce_post_managementunit_timeoffrequests_query
Fetches time off requests matching the conditions specified in the request body Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
forceDownloadService | boolean | No | — | Force the result of this operation to be sent via download service. For testing/app development purposes |
dateRange | object | No | — | dateRange |
ids | any[] | No | — | The set of ids to filter time off requests |
statuses | any[] | No | — | The set of statuses to filter time off requests |
substatuses | any[] | No | — | The set of substatuses to filter time off requests |
userIds | any[] | No | — | The set of user ids to filter time off requests |
genesys_workforce_post_managementunit_timeoffrequests_waitlistpositions_query
Retrieves daily waitlist position for a list of time off requests Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit. |
timeOffRequests | any[] | Yes | — | The list of the time off request ids for which to fetch the daily waitlist positions |
genesys_workforce_post_managementunit_user_timeoffbalance_jobs
Query time off balances for a given user for specified activity code and dates Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit |
userId | string | Yes | — | The ID of the user |
activityCodeIds | any[] | Yes | — | The set of activity code IDs for which to query available time off balances |
dateRanges | any[] | No | — | The list of date ranges for which to query time off balance |
genesys_workforce_post_managementunit_user_timeoffrequest_timeoffbalance_jobs
Query time off balances for dates spanned by a given time off request Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit. |
userId | string | Yes | — | The userId to whom the time off request applies. |
timeOffRequestId | string | Yes | — | The time off request id. |
genesys_workforce_post_managementunit_user_timeoffrequests_estimate
Estimates available time off for an agent Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit |
userId | string | Yes | — | The id of the user for whom the time off request estimate is requested |
activityCodeId | string | Yes | — | The ID of the activity code associated with the time off request. Activity code must be of the TimeOff category |
fullDayDates | any[] | No | — | Full day dates. partialDayDates must be empty if this field is populated |
paid | boolean | Yes | — | Whether this estimate is for a paid time off request |
partialDayDates | any[] | No | — | Partial day dates. fullDayDates must be empty if this field is populated |
genesys_workforce_post_managementunit_week_shifttrade_match
Matches a shift trade. This route can only be called by the receiving agent Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
weekDateId | string | Yes | — | The start week date of the initiating shift in yyyy-MM-dd format. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
tradeId | string | Yes | — | The ID of the shift trade to update |
metadata | object | Yes | — | metadata |
receivingScheduleId | string | Yes | — | The ID of the schedule with which the shift trade is associated |
receivingShiftId | string | No | — | The ID of the shift the receiving user is giving up in trade, if applicable |
genesys_workforce_post_managementunit_week_shifttrades
Adds a shift trade Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
weekDateId | string | Yes | — | The start week date of the initiating shift in yyyy-MM-dd format. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
acceptableIntervals | any[] | No | — | The acceptable intervals the initiating user is willing to accept in trade. Empty indicates the user is giving up the shift. Intervals are represented as an ISO-8601 string. For example: YYYY-MM-DDThh:mm:ss/YYYY-MM-DDThh:mm:ss |
expiration | string | No | — | When this shift trade request should expire. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
initiatingShiftId | string | Yes | — | The ID of the shift that the initiating user wants to give up |
receivingUserId | string | No | — | The ID of the user to whom to send the request (for use in direct trade requests) |
scheduleId | string | Yes | — | The ID of the schedule to which the initiating and receiving shifts belong |
genesys_workforce_post_managementunit_week_shifttrades_search
Searches for potential shift trade matches for the current agent Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
weekDateId | string | Yes | — | The start week date of the initiating shift in yyyy-MM-dd format. Dates are represented as an ISO-8601 string. For example: yyyy-MM-dd |
forceDownloadService | boolean | No | — | Force the result of this operation to be sent via download service. For testing/app development purposes |
receivingScheduleId | string | Yes | — | The ID of the schedule for which to search for available shift trades |
receivingShiftIds | any[] | No | — | The IDs of shifts that the receiving user would potentially be willing to trade. If empty, only returns one sided trades (pick up a shift) |
genesys_workforce_post_managementunit_workplan_copy
Create a copy of work plan Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
workPlanId | string | Yes | — | The ID of the work plan to create a copy |
name | string | Yes | — | Name of the copied work plan |
genesys_workforce_post_managementunit_workplan_validate
Validate Work Plan Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
workPlanId | string | Yes | — | The ID of the work plan to validate. For new work plan, use the word ‘new’ for the ID. |
expand | any[] | No | — | expand |
agentCount | integer | No | — | Number of agents in this work plan |
agents | any[] | No | — | Agents in this work plan |
constrainMaximumConsecutiveWorkingDays | boolean | No | — | Whether to constrain the maximum consecutive working days |
constrainMaximumConsecutiveWorkingWeekends | boolean | No | — | Whether to constrain the maximum consecutive working weekends |
constrainMaximumWorkingWeekendsPerPlanningPeriod | boolean | No | — | Whether to constrain the maximum working weekends in the planning period |
constrainMinimumTimeBetweenShifts | boolean | No | — | Whether the minimum time between shifts constraint is enabled for this work plan |
constrainPaidTimeGranularity | boolean | No | — | Whether paid time granularity is constrained for this work plan |
constrainWeeklyPaidTime | boolean | No | — | Whether the weekly paid time constraint is enabled for this work plan |
enabled | boolean | No | — | Whether the work plan is enabled for scheduling |
flexibleWeeklyPaidTime | boolean | No | — | Whether the weekly paid time constraint is flexible for this work plan |
id | string | No | — | The globally unique identifier for the object. |
maximumConsecutiveWorkingDays | integer | No | — | The maximum number of consecutive days that agents assigned to this work plan are allowed to work. Used if constrainMaximumConsecutiveWorkingDays == true |
maximumConsecutiveWorkingWeekends | integer | No | — | The maximum number of consecutive weekends that agents who are assigned to this work plan are allowed to work |
maximumDays | integer | No | — | Maximum number days in a week allowed to be scheduled for this work plan |
maximumDaysOffPerPlanningPeriod | integer | No | — | Maximum days off in the planning period |
maximumPaidMinutesPerPlanningPeriod | integer | No | — | Maximum paid minutes in the planning period |
maximumWorkingWeekendsPerPlanningPeriod | integer | No | — | Maximum working weekends in the planning period |
minimumConsecutiveNonWorkingMinutesPerWeek | integer | No | — | Minimum amount of consecutive non working minutes per week that agents who are assigned this work plan are allowed to have off |
minimumDaysOffPerPlanningPeriod | integer | No | — | Minimum days off in the planning period |
minimumPaidMinutesPerPlanningPeriod | integer | No | — | Minimum paid minutes in the planning period |
minimumShiftStartDistanceMinutes | integer | No | — | The time period in minutes for the duration between the start times of two consecutive working days |
minimumTimeBetweenShiftsMinutes | integer | No | — | Minimum time between shifts in minutes defined in this work plan. Used if constrainMinimumTimeBetweenShifts == true |
minimumWorkingDaysPerWeek | integer | No | — | The minimum number of days that agents assigned to a work plan must work per week |
name | string | No | — | name |
optionalDays | object | No | — | optionalDays |
paidTimeGranularityMinutes | integer | No | — | Granularity in minutes allowed for shift paid time in this work plan. Used if constrainPaidTimeGranularity == true |
selfUri | string | No | — | The URI for this object |
shifts | any[] | No | — | Shifts in this work plan |
shiftStartVariancePeriod | string | No | — | The length of the period over which the maximum shift start time variance is applied |
shiftStartVariances | object | No | — | shiftStartVariances |
shiftStartVarianceType | string | No | — | This constraint ensures that an agent starts each workday within a user-defined time threshold |
valid | boolean | No | — | Whether the work plan is valid or not |
weeklyExactPaidMinutes | integer | No | — | Exact weekly paid time in minutes for this work plan. Used if flexibleWeeklyPaidTime == false |
weeklyMaximumPaidMinutes | integer | No | — | Maximum weekly paid time in minutes for this work plan. Used if flexibleWeeklyPaidTime == true |
weeklyMinimumPaidMinutes | integer | No | — | Minimum weekly paid time in minutes for this work plan. Used if flexibleWeeklyPaidTime == true |
genesys_workforce_post_managementunit_workplanrotation_copy
Create a copy of work plan rotation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
workPlanRotationId | string | Yes | — | The ID of the work plan rotation to create a copy |
name | string | Yes | — | Name to apply to the new copy of the work plan rotation |
genesys_workforce_post_managementunit_workplanrotations
Create a new work plan rotation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
agents | any[] | No | — | Agents in this work plan rotation |
dateRange | object | Yes | — | dateRange |
name | string | Yes | — | Name of this work plan rotation |
pattern | object | Yes | — | pattern |
genesys_workforce_post_managementunit_workplans
Create a new work plan Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
validationMode | string | No | — | Allows to create work plan even if the validation result is invalid |
agents | any[] | No | — | Agents in this work plan |
constrainMaximumConsecutiveWorkingDays | boolean | No | — | Whether to constrain the maximum consecutive working days |
constrainMaximumConsecutiveWorkingWeekends | boolean | No | — | Whether to constrain the maximum consecutive working weekends |
constrainMaximumWorkingWeekendsPerPlanningPeriod | boolean | No | — | Whether to constrain the maximum working weekends in the planning period |
constrainMinimumTimeBetweenShifts | boolean | No | — | Whether the minimum time between shifts constraint is enabled for this work plan |
constrainPaidTimeGranularity | boolean | No | — | Whether paid time granularity should be constrained for this workplan |
constrainWeeklyPaidTime | boolean | No | — | Whether the weekly paid time constraint is enabled for this work plan |
enabled | boolean | No | — | Whether the work plan is enabled for scheduling |
flexibleWeeklyPaidTime | boolean | No | — | Whether the weekly paid time constraint is flexible for this work plan |
maximumConsecutiveWorkingDays | integer | No | — | The maximum number of consecutive days that agents assigned to this work plan are allowed to work. Used if constrainMaximumConsecutiveWorkingDays == true |
maximumConsecutiveWorkingWeekends | integer | No | — | The maximum number of consecutive weekends that agents who are assigned to this work plan are allowed to work |
maximumDays | integer | No | — | Maximum number days in a week allowed to be scheduled for this work plan |
maximumDaysOffPerPlanningPeriod | integer | No | — | Maximum days off in the planning period |
maximumPaidMinutesPerPlanningPeriod | integer | No | — | Maximum paid minutes in the planning period |
maximumWorkingWeekendsPerPlanningPeriod | integer | No | — | Maximum working weekends in the planning period |
minimumConsecutiveNonWorkingMinutesPerWeek | integer | No | — | Minimum amount of consecutive non working minutes per week that agents who are assigned this work plan are allowed to have off |
minimumDaysOffPerPlanningPeriod | integer | No | — | Minimum days off in the planning period |
minimumPaidMinutesPerPlanningPeriod | integer | No | — | Minimum paid minutes in the planning period |
minimumShiftStartDistanceMinutes | integer | No | — | The time period in minutes for the duration between the start times of two consecutive working days |
minimumTimeBetweenShiftsMinutes | integer | No | — | Minimum time between shifts in minutes defined in this work plan. Used if constrainMinimumTimeBetweenShifts == true |
minimumWorkingDaysPerWeek | integer | No | — | The minimum number of days that agents assigned to a work plan must work per week |
name | string | Yes | — | Name of this work plan |
optionalDays | object | No | — | optionalDays |
paidTimeGranularityMinutes | integer | No | — | Granularity in minutes allowed for shift paid time in this work plan. Used if constrainPaidTimeGranularity == true |
shifts | any[] | No | — | Shifts in this work plan |
shiftStartVariancePeriod | string | No | — | The length of the period over which the maximum shift start time variance is applied |
shiftStartVariances | object | No | — | shiftStartVariances |
shiftStartVarianceType | string | No | — | This constraint ensures that an agent starts each workday within a user-defined time threshold |
weeklyExactPaidMinutes | integer | No | — | Exact weekly paid time in minutes for this work plan. Used if flexibleWeeklyPaidTime == false |
weeklyMaximumPaidMinutes | integer | No | — | Maximum weekly paid time in minutes for this work plan. Used if flexibleWeeklyPaidTime == true |
weeklyMinimumPaidMinutes | integer | No | — | Minimum weekly paid time in minutes for this work plan. Used if flexibleWeeklyPaidTime == true |
genesys_workforce_post_managementunits
Add a management unit Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
businessUnitId | string | Yes | — | The id of the business unit to which this management unit belongs |
divisionId | string | No | — | The id of the division to which this management unit belongs. Defaults to home division ID |
name | string | Yes | — | The name of the management unit |
settings | object | No | — | settings |
startDayOfWeek | string | No | — | The configured first day of the week for scheduling and forecasting purposes. Moving to Business Unit |
timeZone | string | No | — | The default time zone to use for this management unit. Moving to Business Unit |
genesys_workforce_post_notifications_update
Mark a list of notifications as read or unread Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
entities | any[] | Yes | — | The notifications to update |
genesys_workforce_post_team_adherence_historical
Request a teams historical adherence report Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
teamId | string | Yes | — | The ID of the team |
endDate | string | No | — | End of the date range to query in ISO-8601 format. If it is not set, end date will be set to current time |
includeExceptions | boolean | No | — | Whether user exceptions should be returned as part of the results |
startDate | string | Yes | — | Beginning of the date range to query in ISO-8601 format |
timeZone | string | Yes | — | The time zone, in olson format, to use in defining days when computing adherence. The results will be returned as UTC timestamps regardless of the time zone input. |
userIds | any[] | No | — | The userIds to report on. If null or not set, adherence will be computed for all the users in management unit or requested teamIds |
genesys_workforce_post_timeoffbalance_jobs
Query time off balances for the current user for specified activity code and dates Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
activityCodeIds | any[] | Yes | — | The set of activity code IDs for which to query available time off balances |
dateRanges | any[] | No | — | The list of date ranges for which to query time off balance |
genesys_workforce_post_timeofflimits_available_query
Queries available time off for the current user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
activityCodeId | string | Yes | — | The ID for activity code to query available time off minutes |
dateRanges | any[] | No | — | A list of date ranges of available time off minutes. A maximum number of date ranges is 30. The maximum total number of days in all ranges is 366. If no ranges are specified, then only the presence of the associated time off limit object will be checked. In such case, if the association exists, then the response will contain a list with of a single element filled with timeOffLimitId only. |
genesys_workforce_post_timeoffrequests
Create a time off request for the current user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
activityCodeId | string | Yes | — | The ID of the activity code associated with this time off request. Activity code must be of the TimeOff category |
dailyDurationMinutes | integer | Yes | — | The daily duration of this time off request in minutes |
durationMinutes | any[] | No | — | Daily durations for each day of this time off request in minutes |
fullDayManagementUnitDates | any[] | No | — | A set of dates in yyyy-MM-dd format. Should be interpreted in the management unit’s configured time zone. |
notes | string | No | — | Notes about the time off request |
partialDayStartDateTimes | any[] | No | — | A set of start date-times in ISO-8601 format for partial day requests. |
payableMinutes | any[] | No | — | Payable minutes for each day of this time off request |
genesys_workforce_post_timeoffrequests_estimate
Estimates available time off for current user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
activityCodeId | string | Yes | — | The ID of the activity code associated with the time off request. Activity code must be of the TimeOff category |
fullDayDates | any[] | No | — | Full day dates. partialDayDates must be empty if this field is populated |
paid | boolean | Yes | — | Whether this estimate is for a paid time off request |
partialDayDates | any[] | No | — | Partial day dates. fullDayDates must be empty if this field is populated |
genesys_workforce_post_timeoffrequests_integrationstatus_query
Retrieves integration statuses for a list of current user time off requests Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
timeOffRequestIds | any[] | Yes | — | A list of time off request IDs |
genesys_workforce_post_workforcemanagement_agentschedules_mine
Get published schedule for the current user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
endDate | string | Yes | — | End date of the range to search. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
startDate | string | Yes | — | Start date of the range to search. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
genesys_workforce_post_workforcemanagement_managementunit_agentschedules_search
Query published schedules for given given time range for set of users Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
forceAsync | boolean | No | — | Force the result of this operation to be sent asynchronously via notification. For testing/app development purposes |
forceDownloadService | boolean | No | — | Force the result of this operation to be sent via download service. For testing/app development purposes |
endDate | string | Yes | — | End date of the range to search. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
startDate | string | Yes | — | Start date of the range to search. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z |
userIds | any[] | No | — | IDs of the users for whose schedules to search |
genesys_workforce_post_workforcemanagement_managementunit_timeoffrequests_query
Fetches time off requests matching the conditions specified in the request body Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit, or ‘mine’ for the management unit of the logged-in user. |
forceDownloadService | boolean | No | — | Force the result of this operation to be sent via download service. For testing/app development purposes |
dateRange | object | No | — | dateRange |
ids | any[] | No | — | The set of ids to filter time off requests |
statuses | any[] | No | — | The set of statuses to filter time off requests |
substatuses | any[] | No | — | The set of substatuses to filter time off requests |
userIds | any[] | No | — | The set of user ids to filter time off requests |
genesys_workforce_post_workforcemanagement_timeoffrequests
Create a time off request for the current user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
activityCodeId | string | Yes | — | The ID of the activity code associated with this time off request. Activity code must be of the TimeOff category |
dailyDurationMinutes | integer | Yes | — | The daily duration of this time off request in minutes |
durationMinutes | any[] | No | — | Daily durations for each day of this time off request in minutes |
fullDayManagementUnitDates | any[] | No | — | A set of dates in yyyy-MM-dd format. Should be interpreted in the management unit’s configured time zone. |
notes | string | No | — | Notes about the time off request |
partialDayStartDateTimes | any[] | No | — | A set of start date-times in ISO-8601 format for partial day requests. |
payableMinutes | any[] | No | — | Payable minutes for each day of this time off request |
genesys_workforce_put_managementunit_timeofflimit_values
Sets daily values for a date range of time off limit object Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
managementUnitId | string | Yes | — | The ID of the management unit. |
timeOffLimitId | string | Yes | — | The ID of the time off limit object to set values for |
metadata | object | Yes | — | metadata |
values | any[] | No | — | values |

