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

Tools

ToolDescription
genesys_workforce_delete_managementunitDelete management unit
genesys_workforce_delete_managementunit_timeofflimitDeletes a time off limit object
genesys_workforce_delete_managementunit_timeoffplanDeletes a time off plan
genesys_workforce_delete_managementunit_workplanDelete a work plan
genesys_workforce_delete_managementunit_workplanrotationDelete a work plan rotation
genesys_workforce_get_adherenceGet a list of UserScheduleAdherence records for the requested users
genesys_workforce_get_adherence_explanationGet an adherence explanation for the current user
genesys_workforce_get_adherence_explanations_jobQuery the status of an adherence explanation operation. Only the user who started the operation can query the status
genesys_workforce_get_adherence_historical_jobQuery the status of a historical adherence request operation. Only the user who started the operation can query the status
genesys_workforce_get_agent_adherence_explanationGet an adherence explanation
genesys_workforce_get_agent_managementunitGet the management unit to which the agent belongs
genesys_workforce_get_agents_me_adherence_historical_jobRequest to fetch the status of the agent adherence job. Only the user who started the operation can query the status
genesys_workforce_get_agents_me_managementunitGet the management unit to which the currently logged in agent belongs
genesys_workforce_get_managementunitGet management unit
genesys_workforce_get_managementunit_adherenceGet a list of user schedule adherence records for the requested management unit
genesys_workforce_get_managementunit_agentGet data for agent in the management unit
genesys_workforce_get_managementunit_agent_shifttradesGets all the shift trades for a given agent
genesys_workforce_get_managementunit_shifttrades_matchedGets a summary of all shift trades in the matched state
genesys_workforce_get_managementunit_shifttrades_usersGets list of users available for whom you can send direct shift trade requests
genesys_workforce_get_managementunit_timeofflimitGets a time off limit object
genesys_workforce_get_managementunit_timeofflimitsGets a list of time off limit objects under management unit.
genesys_workforce_get_managementunit_timeoffplanGets a time off plan
genesys_workforce_get_managementunit_timeoffplansGets a list of time off plans
genesys_workforce_get_managementunit_user_timeoffrequestGet a time off request
genesys_workforce_get_managementunit_user_timeoffrequest_timeofflimitsRetrieves time off limit, allocated and waitlisted values according to specific time off request
genesys_workforce_get_managementunit_user_timeoffrequestsGet a list of time off requests for a given user
genesys_workforce_get_managementunit_usersGet users in the management unit
genesys_workforce_get_managementunit_week_shifttradesGets all the shift trades for a given week
genesys_workforce_get_managementunit_workplanGet a work plan
genesys_workforce_get_managementunit_workplanrotationGet a work plan rotation
genesys_workforce_get_managementunit_workplanrotationsGet work plan rotations
genesys_workforce_get_managementunit_workplansGet work plans
genesys_workforce_get_managementunitsGet management units
genesys_workforce_get_notificationsGet a list of notifications for the current user
genesys_workforce_get_shifttradesGets all of my shift trades
genesys_workforce_get_team_adherenceGet a list of user schedule adherence records for the requested team
genesys_workforce_get_timeoffbalance_jobQuery the results of time off types job
genesys_workforce_get_timeoffrequestGet a time off request for the current user
genesys_workforce_get_timeoffrequest_waitlistpositionsGet the daily waitlist positions of a time off request for the current user
genesys_workforce_get_timeoffrequestsGet a list of time off requests for the current user
genesys_workforce_get_workforcemanagement_adherenceGet a list of UserScheduleAdherence records for the requested users
genesys_workforce_get_workforcemanagement_managementunitGet management unit
genesys_workforce_get_workforcemanagement_managementunit_adherenceGet a list of user schedule adherence records for the requested management unit
genesys_workforce_get_workforcemanagement_managementunit_agentGet data for agent in the management unit
genesys_workforce_get_workforcemanagement_managementunit_user_timeoffrequestsGet a list of time off requests for a given user
genesys_workforce_get_workforcemanagement_managementunit_usersGet users in the management unit
genesys_workforce_get_workforcemanagement_managementunitsGet management units
genesys_workforce_get_workforcemanagement_notificationsGet a list of notifications for the current user
genesys_workforce_get_workforcemanagement_team_adherenceGet a list of user schedule adherence records for the requested team
genesys_workforce_get_workforcemanagement_timeoffrequestGet a time off request for the current user
genesys_workforce_get_workforcemanagement_timeoffrequestsGet a list of time off requests for the current user
genesys_workforce_patch_agent_adherence_explanationUpdate an adherence explanation
genesys_workforce_patch_managementunitUpdate the requested management unit
genesys_workforce_patch_managementunit_agentsUpdate agent configurations
genesys_workforce_patch_managementunit_timeofflimitUpdates a time off limit object.
genesys_workforce_patch_managementunit_timeoffplanUpdates a time off plan
genesys_workforce_patch_managementunit_timeoffrequest_user_integrationstatusSet integration status for a time off request.
genesys_workforce_patch_managementunit_user_timeoffrequestUpdate a time off request
genesys_workforce_patch_managementunit_week_shifttradeUpdates a shift trade. This route can only be called by the initiating agent
genesys_workforce_patch_managementunit_workplanUpdate a work plan
genesys_workforce_patch_managementunit_workplanrotationUpdate a work plan rotation
genesys_workforce_patch_timeoffrequestUpdate a time off request for the current user
genesys_workforce_post_adherence_explanationsSubmit an adherence explanation for the current user
genesys_workforce_post_adherence_explanations_queryQuery adherence explanations for the current user
genesys_workforce_post_agent_adherence_explanationsAdd an adherence explanation for the requested user
genesys_workforce_post_agent_adherence_explanations_queryQuery adherence explanations for the given agent across a specified range
genesys_workforce_post_agentsMove agents in and out of management unit
genesys_workforce_post_agents_me_adherence_historical_jobsRequest an agent historical adherence report
genesys_workforce_post_agents_me_possibleworkshiftsGet agent possible work shifts for requested time frame
genesys_workforce_post_agentschedules_managementunits_mineFetch agent schedules for the logged in user’s management unit
genesys_workforce_post_agentschedules_mineGet published schedule for the current user
genesys_workforce_post_managementunit_agents_workplans_queryGet agents work plans configuration
genesys_workforce_post_managementunit_agentschedules_searchQuery published schedules for given given time range for set of users
genesys_workforce_post_managementunit_historicaladherencequeryRequest a historical adherence report
genesys_workforce_post_managementunit_moveMove the requested management unit to a new business unit
genesys_workforce_post_managementunit_timeofflimitsCreates a new time off limit object under management unit.
genesys_workforce_post_managementunit_timeofflimits_values_queryRetrieves time off limit related values based on a given set of filters.
genesys_workforce_post_managementunit_timeoffplansCreates a new time off plan
genesys_workforce_post_managementunit_timeoffrequestsCreate a new time off request
genesys_workforce_post_managementunit_timeoffrequests_integrationstatus_queryRetrieves integration statuses for a list of time off requests
genesys_workforce_post_managementunit_timeoffrequests_queryFetches time off requests matching the conditions specified in the request body
genesys_workforce_post_managementunit_timeoffrequests_waitlistpositions_queryRetrieves daily waitlist position for a list of time off requests
genesys_workforce_post_managementunit_user_timeoffbalance_jobsQuery time off balances for a given user for specified activity code and dates
genesys_workforce_post_managementunit_user_timeoffrequest_timeoffbalance_jobsQuery time off balances for dates spanned by a given time off request
genesys_workforce_post_managementunit_user_timeoffrequests_estimateEstimates available time off for an agent
genesys_workforce_post_managementunit_week_shifttrade_matchMatches a shift trade. This route can only be called by the receiving agent
genesys_workforce_post_managementunit_week_shifttradesAdds a shift trade
genesys_workforce_post_managementunit_week_shifttrades_searchSearches for potential shift trade matches for the current agent
genesys_workforce_post_managementunit_workplan_copyCreate a copy of work plan
genesys_workforce_post_managementunit_workplan_validateValidate Work Plan
genesys_workforce_post_managementunit_workplanrotation_copyCreate a copy of work plan rotation
genesys_workforce_post_managementunit_workplanrotationsCreate a new work plan rotation
genesys_workforce_post_managementunit_workplansCreate a new work plan
genesys_workforce_post_managementunitsAdd a management unit
genesys_workforce_post_notifications_updateMark a list of notifications as read or unread
genesys_workforce_post_team_adherence_historicalRequest a teams historical adherence report
genesys_workforce_post_timeoffbalance_jobsQuery time off balances for the current user for specified activity code and dates
genesys_workforce_post_timeofflimits_available_queryQueries available time off for the current user
genesys_workforce_post_timeoffrequestsCreate a time off request for the current user
genesys_workforce_post_timeoffrequests_estimateEstimates available time off for current user
genesys_workforce_post_timeoffrequests_integrationstatus_queryRetrieves integration statuses for a list of current user time off requests
genesys_workforce_post_workforcemanagement_agentschedules_mineGet published schedule for the current user
genesys_workforce_post_workforcemanagement_managementunit_agentschedules_searchQuery published schedules for given given time range for set of users
genesys_workforce_post_workforcemanagement_managementunit_timeoffrequests_queryFetches time off requests matching the conditions specified in the request body
genesys_workforce_post_workforcemanagement_timeoffrequestsCreate a time off request for the current user
genesys_workforce_put_managementunit_timeofflimit_valuesSets daily values for a date range of time off limit object

genesys_workforce_delete_managementunit

Delete management unit Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit.
timeOffLimitIdstringYesThe ID of the time off limit object to delete

genesys_workforce_delete_managementunit_timeoffplan

Deletes a time off plan Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit
timeOffPlanIdstringYesThe ID of the time off plan to delete

genesys_workforce_delete_managementunit_workplan

Delete a work plan Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
workPlanIdstringYesThe ID of the work plan to delete

genesys_workforce_delete_managementunit_workplanrotation

Delete a work plan rotation Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
workPlanRotationIdstringYesThe ID of the work plan rotation to be deleted

genesys_workforce_get_adherence

Get a list of UserScheduleAdherence records for the requested users Parameters:
ParameterTypeRequiredDefaultDescription
userIdany[]YesUser 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:
ParameterTypeRequiredDefaultDescription
explanationIdstringYesThe 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:
ParameterTypeRequiredDefaultDescription
jobIdstringYesThe 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:
ParameterTypeRequiredDefaultDescription
jobIdstringYesjobId

genesys_workforce_get_agent_adherence_explanation

Get an adherence explanation Parameters:
ParameterTypeRequiredDefaultDescription
agentIdstringYesThe ID of the agent to query
explanationIdstringYesThe ID of the explanation to update

genesys_workforce_get_agent_managementunit

Get the management unit to which the agent belongs Parameters:
ParameterTypeRequiredDefaultDescription
agentIdstringYesThe 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:
ParameterTypeRequiredDefaultDescription
jobIdstringYesID of the job to get

genesys_workforce_get_agents_me_managementunit

Get the management unit to which the currently logged in agent belongs

genesys_workforce_get_managementunit

Get management unit Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
expandany[]Noexpand

genesys_workforce_get_managementunit_adherence

Get a list of user schedule adherence records for the requested management unit Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit
forceDownloadServicebooleanNoForce 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
agentIdstringYesThe agent id
excludeCapabilitiesbooleanNoExcludes all capabilities of the agent such as queues, languages, and skills
expandany[]Noexpand

genesys_workforce_get_managementunit_agent_shifttrades

Gets all the shift trades for a given agent Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
agentIdstringYesThe agent id

genesys_workforce_get_managementunit_shifttrades_matched

Gets a summary of all shift trades in the matched state Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit.
timeOffLimitIdstringYesThe 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit.

genesys_workforce_get_managementunit_timeoffplan

Gets a time off plan Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit
timeOffPlanIdstringYesThe ID of the time off plan to fetch

genesys_workforce_get_managementunit_timeoffplans

Gets a list of time off plans Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit

genesys_workforce_get_managementunit_user_timeoffrequest

Get a time off request Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
userIdstringYesThe userId to whom the Time Off Request applies.
timeOffRequestIdstringYesTime 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit.
userIdstringYesThe userId to whom the time off request applies.
timeOffRequestIdstringYesThe 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
userIdstringYesThe userId to whom the Time Off Request applies.

genesys_workforce_get_managementunit_users

Get users in the management unit Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
weekDateIdstringYesThe 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
evaluateMatchesbooleanNoWhether to evaluate the matches for violations
includeCrossWeekShiftsbooleanNoWhether to include all shift trades with either the initiating shift or the receiving shift in the week
forceDownloadServicebooleanNoForce 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
workPlanIdstringYesThe ID of the work plan to fetch
includeOnlyany[]Nolimit response to the specified fields

genesys_workforce_get_managementunit_workplanrotation

Get a work plan rotation Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
workPlanRotationIdstringYesThe ID of the work plan rotation to fetch

genesys_workforce_get_managementunit_workplanrotations

Get work plan rotations Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
expandany[]Noexpand

genesys_workforce_get_managementunit_workplans

Get work plans Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
expandany[]NoInclude to access additional data on the work plans
excludeany[]NoExclude specific data on the work plans from the response

genesys_workforce_get_managementunits

Get management units Parameters:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNoDeprecated, paging is not supported
pageNumberintegerNoDeprecated, paging is not supported
expandstringNoDeprecated, expand settings on the single MU route
featurestringNoIf specified, the list of management units for which the user is authorized to use the requested feature will be returned
divisionIdstringNoIf 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 user

genesys_workforce_get_shifttrades

Gets all of my shift trades

genesys_workforce_get_team_adherence

Get a list of user schedule adherence records for the requested team Parameters:
ParameterTypeRequiredDefaultDescription
teamIdstringYesThe ID of the team

genesys_workforce_get_timeoffbalance_job

Query the results of time off types job Parameters:
ParameterTypeRequiredDefaultDescription
jobIdstringYesThe ID of the job.

genesys_workforce_get_timeoffrequest

Get a time off request for the current user Parameters:
ParameterTypeRequiredDefaultDescription
timeOffRequestIdstringYesThe 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:
ParameterTypeRequiredDefaultDescription
timeOffRequestIdstringYesThe ID of the time off request

genesys_workforce_get_timeoffrequests

Get a list of time off requests for the current user

genesys_workforce_get_workforcemanagement_adherence

Get a list of UserScheduleAdherence records for the requested users Parameters:
ParameterTypeRequiredDefaultDescription
userIdany[]YesUser 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
expandany[]Noexpand

genesys_workforce_get_workforcemanagement_managementunit_adherence

Get a list of user schedule adherence records for the requested management unit Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit
forceDownloadServicebooleanNoForce 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
agentIdstringYesThe agent id
excludeCapabilitiesbooleanNoExcludes all capabilities of the agent such as queues, languages, and skills
expandany[]Noexpand

genesys_workforce_get_workforcemanagement_managementunit_user_timeoffrequests

Get a list of time off requests for a given user Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
userIdstringYesThe userId to whom the Time Off Request applies.

genesys_workforce_get_workforcemanagement_managementunit_users

Get users in the management unit Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe 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:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNoDeprecated, paging is not supported
pageNumberintegerNoDeprecated, paging is not supported
expandstringNoDeprecated, expand settings on the single MU route
featurestringNoIf specified, the list of management units for which the user is authorized to use the requested feature will be returned
divisionIdstringNoIf 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 user

genesys_workforce_get_workforcemanagement_team_adherence

Get a list of user schedule adherence records for the requested team Parameters:
ParameterTypeRequiredDefaultDescription
teamIdstringYesThe ID of the team

genesys_workforce_get_workforcemanagement_timeoffrequest

Get a time off request for the current user Parameters:
ParameterTypeRequiredDefaultDescription
timeOffRequestIdstringYesThe ID of the time off request

genesys_workforce_get_workforcemanagement_timeoffrequests

Get a list of time off requests for the current user

genesys_workforce_patch_agent_adherence_explanation

Update an adherence explanation Parameters:
ParameterTypeRequiredDefaultDescription
agentIdstringYesThe ID of the agent to query
explanationIdstringYesThe ID of the explanation to update
statusstringNoThe status of the adherence explanation

genesys_workforce_patch_managementunit

Update the requested management unit Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
divisionIdstringNoThe new division id for the management unit
namestringNoThe new name of the management unit
settingsobjectNosettings

genesys_workforce_patch_managementunit_agents

Update agent configurations Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
entitiesany[]NoList of agents to update

genesys_workforce_patch_managementunit_timeofflimit

Updates a time off limit object. Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit.
timeOffLimitIdstringYesThe id of time off limit object to update
defaultLimitMinutesintegerNoThe default time off limit value in minutes per granularity
metadataobjectYesmetadata

genesys_workforce_patch_managementunit_timeoffplan

Updates a time off plan Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit
timeOffPlanIdstringYesThe ID of the time off plan to update
activebooleanNoWhether this time off plan should be used by agents.
activityCodeIdsobjectNoactivityCodeIds
autoApprovalRulestringNoAuto approval rule for the time off plan.
daysBeforeStartToExpireFromWaitlistintegerNoThe number of days before the time off request start date for when the request will be expired from the waitlist.
hrisTimeOffTypeobjectNohrisTimeOffType
metadataobjectYesmetadata
namestringNoThe name of this time off plan.
timeOffLimitIdsobjectNotimeOffLimitIds

genesys_workforce_patch_managementunit_timeoffrequest_user_integrationstatus

Set integration status for a time off request. Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit.
timeOffRequestIdstringYesThe ID of the time off request.
userIdstringYesThe ID of user to whom the time off request belongs.
integrationStatusstringYesThe integration status value for the time off request

genesys_workforce_patch_managementunit_user_timeoffrequest

Update a time off request Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
userIdstringYesThe id of the user the requested time off request belongs to
timeOffRequestIdstringYesThe id of the time off request to update
activityCodeIdstringNoThe ID of the activity code associated with this time off request. Activity code must be of the TimeOff category
dailyDurationMinutesintegerNoThe daily duration of this time off request in minutes
durationMinutesany[]NoDaily durations for each day of this time off request in minutes
fullDayManagementUnitDatesany[]NoA set of dates in yyyy-MM-dd format. Should be interpreted in the management unit’s configured time zone.
metadataobjectYesmetadata
notesstringNoNotes about the time off request
paidbooleanNoWhether this is a paid time off request
partialDayStartDateTimesany[]NoA set of start date-times in ISO-8601 format for partial day requests.
payableMinutesany[]NoPayable minutes for each day of this time off request
statusstringNoThe 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
weekDateIdstringYesThe 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
tradeIdstringYesThe ID of the shift trade to update
acceptableIntervalsobjectNoacceptableIntervals
expirationobjectNoexpiration
metadataobjectYesmetadata
receivingUserIdobjectNoreceivingUserId

genesys_workforce_patch_managementunit_workplan

Update a work plan Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
workPlanIdstringYesThe ID of the work plan to update
validationModestringNoAllows to update work plan even if validation result is invalid
agentCountintegerNoNumber of agents in this work plan
agentsany[]NoAgents in this work plan
constrainMaximumConsecutiveWorkingDaysbooleanNoWhether to constrain the maximum consecutive working days
constrainMaximumConsecutiveWorkingWeekendsbooleanNoWhether to constrain the maximum consecutive working weekends
constrainMaximumWorkingWeekendsPerPlanningPeriodbooleanNoWhether to constrain the maximum working weekends in the planning period
constrainMinimumTimeBetweenShiftsbooleanNoWhether the minimum time between shifts constraint is enabled for this work plan
constrainPaidTimeGranularitybooleanNoWhether paid time granularity is constrained for this work plan
constrainWeeklyPaidTimebooleanNoWhether the weekly paid time constraint is enabled for this work plan
enabledbooleanNoWhether the work plan is enabled for scheduling
flexibleWeeklyPaidTimebooleanNoWhether the weekly paid time constraint is flexible for this work plan
idstringNoThe globally unique identifier for the object.
maximumConsecutiveWorkingDaysintegerNoThe maximum number of consecutive days that agents assigned to this work plan are allowed to work. Used if constrainMaximumConsecutiveWorkingDays == true
maximumConsecutiveWorkingWeekendsintegerNoThe maximum number of consecutive weekends that agents who are assigned to this work plan are allowed to work
maximumDaysintegerNoMaximum number days in a week allowed to be scheduled for this work plan
maximumDaysOffPerPlanningPeriodintegerNoMaximum days off in the planning period
maximumPaidMinutesPerPlanningPeriodintegerNoMaximum paid minutes in the planning period
maximumWorkingWeekendsPerPlanningPeriodintegerNoMaximum working weekends in the planning period
metadataobjectYesmetadata
minimumConsecutiveNonWorkingMinutesPerWeekintegerNoMinimum amount of consecutive non working minutes per week that agents who are assigned this work plan are allowed to have off
minimumDaysOffPerPlanningPeriodintegerNoMinimum days off in the planning period
minimumPaidMinutesPerPlanningPeriodintegerNoMinimum paid minutes in the planning period
minimumShiftStartDistanceMinutesintegerNoThe time period in minutes for the duration between the start times of two consecutive working days
minimumTimeBetweenShiftsMinutesintegerNoMinimum time between shifts in minutes defined in this work plan. Used if constrainMinimumTimeBetweenShifts == true
minimumWorkingDaysPerWeekintegerNoThe minimum number of days that agents assigned to a work plan must work per week
namestringNoname
optionalDaysobjectNooptionalDays
paidTimeGranularityMinutesintegerNoGranularity in minutes allowed for shift paid time in this work plan. Used if constrainPaidTimeGranularity == true
selfUristringNoThe URI for this object
shiftsany[]NoShifts in this work plan
shiftStartVariancePeriodstringNoThe length of the period over which the maximum shift start time variance is applied
shiftStartVariancesobjectNoshiftStartVariances
shiftStartVarianceTypestringNoThis constraint ensures that an agent starts each workday within a user-defined time threshold
validbooleanNoWhether the work plan is valid or not
weeklyExactPaidMinutesintegerNoExact weekly paid time in minutes for this work plan. Used if flexibleWeeklyPaidTime == false
weeklyMaximumPaidMinutesintegerNoMaximum weekly paid time in minutes for this work plan. Used if flexibleWeeklyPaidTime == true
weeklyMinimumPaidMinutesintegerNoMinimum weekly paid time in minutes for this work plan. Used if flexibleWeeklyPaidTime == true

genesys_workforce_patch_managementunit_workplanrotation

Update a work plan rotation Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
workPlanRotationIdstringYesThe ID of the work plan rotation to update
agentsany[]NoAgents in this work plan rotation
dateRangeobjectNodateRange
enabledbooleanNoWhether the work plan rotation is enabled for scheduling
metadataobjectYesmetadata
namestringNoName of this work plan rotation
patternobjectNopattern

genesys_workforce_patch_timeoffrequest

Update a time off request for the current user Parameters:
ParameterTypeRequiredDefaultDescription
timeOffRequestIdstringYesThe ID of the time off request
markedAsReadbooleanNoWhether this request has been read by the agent
notesstringNoNotes about the time off request. Can only be edited while the request is still pending
statusstringNoThe 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:
ParameterTypeRequiredDefaultDescription
lengthMinutesintegerYesThe length of the adherence explanation in minutes
notesstringNoNotes about the adherence explanation
startDatestringYesThe start timestamp of the adherence explanation in ISO-8601 format
typestringYesThe type of the adherence explanation

genesys_workforce_post_adherence_explanations_query

Query adherence explanations for the current user Parameters:
ParameterTypeRequiredDefaultDescription
forceAsyncbooleanNoForce the result of this operation to be sent asynchronously via notification. For testing/app development purposes
forceDownloadServicebooleanNoForce the result of this operation to be sent via download service. For testing/app development purposes
endDatestringYesThe 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
startDatestringYesThe 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:
ParameterTypeRequiredDefaultDescription
agentIdstringYesThe ID of the agent to query
lengthMinutesintegerYesThe length of the adherence explanation in minutes
notesstringNoNotes about the adherence explanation
startDatestringYesThe start timestamp of the adherence explanation in ISO-8601 format
statusstringNoThe status of the adherence explanation
typestringYesThe type of the adherence explanation

genesys_workforce_post_agent_adherence_explanations_query

Query adherence explanations for the given agent across a specified range Parameters:
ParameterTypeRequiredDefaultDescription
agentIdstringYesThe ID of the agent to query
forceAsyncbooleanNoForce the result of this operation to be sent asynchronously via notification. For testing/app development purposes
forceDownloadServicebooleanNoForce the result of this operation to be sent via download service. For testing/app development purposes
endDatestringYesThe 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
startDatestringYesThe 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:
ParameterTypeRequiredDefaultDescription
destinationManagementUnitIdstringNoThe 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.
userIdsany[]YesThe list of user ids to move

genesys_workforce_post_agents_me_adherence_historical_jobs

Request an agent historical adherence report Parameters:
ParameterTypeRequiredDefaultDescription
expandany[]NoWhich fields, if any, to expand with. wfm:AgentHistoricalAdherenceConformance:view permission is required for conformance, and wfm:agentSchedule:view permission is required for scheduledActivities.
endDatestringNoEnd of the date range to query in ISO-8601 format. If it is not set, end date will be set to current time
startDatestringNoBeginning of the date range to query in ISO-8601 format
timeZonestringNoThe 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:
ParameterTypeRequiredDefaultDescription
weekCountintegerYesNumber of weeks for which to return possible work shifts
weekStartDatestringYesStart 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:
ParameterTypeRequiredDefaultDescription
forceAsyncbooleanNoForce the result of this operation to be sent asynchronously via notification. For testing/app development purposes
forceDownloadServicebooleanNoForce the result of this operation to be sent via download service. For testing/app development purposes
endDatestringYesThe 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
startDatestringYesThe 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:
ParameterTypeRequiredDefaultDescription
endDatestringYesEnd date of the range to search. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
startDatestringYesStart 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
forceDownloadServicebooleanNoForce the result of this operation to be sent via download service. For testing/app development purposes
agentIdsany[]YesThe list of agent IDs
startDatestringYesThe 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
weekCountintegerYesThe number of weeks to query

genesys_workforce_post_managementunit_agentschedules_search

Query published schedules for given given time range for set of users Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
forceAsyncbooleanNoForce the result of this operation to be sent asynchronously via notification. For testing/app development purposes
forceDownloadServicebooleanNoForce the result of this operation to be sent via download service. For testing/app development purposes
endDatestringYesEnd date of the range to search. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
startDatestringYesStart date of the range to search. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
userIdsany[]NoIDs of the users for whose schedules to search

genesys_workforce_post_managementunit_historicaladherencequery

Request a historical adherence report Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit
endDatestringNoEnd of the date range to query in ISO-8601 format. If it is not set, end date will be set to current time
includeExceptionsbooleanNoWhether user exceptions should be returned as part of the results
startDatestringYesBeginning of the date range to query in ISO-8601 format
teamIdsany[]NoThe 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
timeZonestringNoThe 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.
userIdsany[]NoThe 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
businessUnitIdstringYesThe 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit.
defaultLimitMinutesintegerNoThe default limit value in minutes per granularity. If not specified, then 0 is assumed, which means there are no time off minutes available
granularitystringNoGranularity 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit.
activityCodeIdstringNoThe ID of the activity code by which to filter the affected limit objects. Required if timeOffLimitId is not specified
dateRangesany[]YesThe 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.
timeOffLimitIdstringNoThe 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit
activebooleanYesWhether this time off plan should be used by agents.
activityCodeIdsany[]NoThe set of activity code IDs to associate with this time off plan.
autoApprovalRulestringYesAuto approval rule for the time off plan.
daysBeforeStartToExpireFromWaitlistintegerNoThe number of days before the time off request start date for when the request will be expired from the waitlist.
hrisTimeOffTypeobjectNohrisTimeOffType
namestringYesThe name of this time off plan.
timeOffLimitIdsany[]NoThe 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
activityCodeIdstringYesThe ID of the activity code associated with this time off request. Activity code must be of the TimeOff category
dailyDurationMinutesintegerYesThe daily duration of this time off request in minutes
durationMinutesany[]NoDaily durations for each day of this time off request in minutes
fullDayManagementUnitDatesany[]NoA set of dates in yyyy-MM-dd format. Should be interpreted in the management unit’s configured time zone.
notesstringNoNotes about the time off request
paidbooleanNoWhether this is a paid time off request
partialDayStartDateTimesany[]NoA set of start date-times in ISO-8601 format for partial day requests.
payableMinutesany[]NoPayable minutes for each day of this time off request
statusstringYesThe status of this time off request
usersany[]YesA 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit.
timeOffRequestLookupsany[]YesA 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
forceDownloadServicebooleanNoForce the result of this operation to be sent via download service. For testing/app development purposes
dateRangeobjectNodateRange
idsany[]NoThe set of ids to filter time off requests
statusesany[]NoThe set of statuses to filter time off requests
substatusesany[]NoThe set of substatuses to filter time off requests
userIdsany[]NoThe 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit.
timeOffRequestsany[]YesThe 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit
userIdstringYesThe ID of the user
activityCodeIdsany[]YesThe set of activity code IDs for which to query available time off balances
dateRangesany[]NoThe 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit.
userIdstringYesThe userId to whom the time off request applies.
timeOffRequestIdstringYesThe time off request id.

genesys_workforce_post_managementunit_user_timeoffrequests_estimate

Estimates available time off for an agent Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit
userIdstringYesThe id of the user for whom the time off request estimate is requested
activityCodeIdstringYesThe ID of the activity code associated with the time off request. Activity code must be of the TimeOff category
fullDayDatesany[]NoFull day dates. partialDayDates must be empty if this field is populated
paidbooleanYesWhether this estimate is for a paid time off request
partialDayDatesany[]NoPartial 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
weekDateIdstringYesThe 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
tradeIdstringYesThe ID of the shift trade to update
metadataobjectYesmetadata
receivingScheduleIdstringYesThe ID of the schedule with which the shift trade is associated
receivingShiftIdstringNoThe 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
weekDateIdstringYesThe 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
acceptableIntervalsany[]NoThe 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
expirationstringNoWhen this shift trade request should expire. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
initiatingShiftIdstringYesThe ID of the shift that the initiating user wants to give up
receivingUserIdstringNoThe ID of the user to whom to send the request (for use in direct trade requests)
scheduleIdstringYesThe 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
weekDateIdstringYesThe 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
forceDownloadServicebooleanNoForce the result of this operation to be sent via download service. For testing/app development purposes
receivingScheduleIdstringYesThe ID of the schedule for which to search for available shift trades
receivingShiftIdsany[]NoThe 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
workPlanIdstringYesThe ID of the work plan to create a copy
namestringYesName of the copied work plan

genesys_workforce_post_managementunit_workplan_validate

Validate Work Plan Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
workPlanIdstringYesThe ID of the work plan to validate. For new work plan, use the word ‘new’ for the ID.
expandany[]Noexpand
agentCountintegerNoNumber of agents in this work plan
agentsany[]NoAgents in this work plan
constrainMaximumConsecutiveWorkingDaysbooleanNoWhether to constrain the maximum consecutive working days
constrainMaximumConsecutiveWorkingWeekendsbooleanNoWhether to constrain the maximum consecutive working weekends
constrainMaximumWorkingWeekendsPerPlanningPeriodbooleanNoWhether to constrain the maximum working weekends in the planning period
constrainMinimumTimeBetweenShiftsbooleanNoWhether the minimum time between shifts constraint is enabled for this work plan
constrainPaidTimeGranularitybooleanNoWhether paid time granularity is constrained for this work plan
constrainWeeklyPaidTimebooleanNoWhether the weekly paid time constraint is enabled for this work plan
enabledbooleanNoWhether the work plan is enabled for scheduling
flexibleWeeklyPaidTimebooleanNoWhether the weekly paid time constraint is flexible for this work plan
idstringNoThe globally unique identifier for the object.
maximumConsecutiveWorkingDaysintegerNoThe maximum number of consecutive days that agents assigned to this work plan are allowed to work. Used if constrainMaximumConsecutiveWorkingDays == true
maximumConsecutiveWorkingWeekendsintegerNoThe maximum number of consecutive weekends that agents who are assigned to this work plan are allowed to work
maximumDaysintegerNoMaximum number days in a week allowed to be scheduled for this work plan
maximumDaysOffPerPlanningPeriodintegerNoMaximum days off in the planning period
maximumPaidMinutesPerPlanningPeriodintegerNoMaximum paid minutes in the planning period
maximumWorkingWeekendsPerPlanningPeriodintegerNoMaximum working weekends in the planning period
minimumConsecutiveNonWorkingMinutesPerWeekintegerNoMinimum amount of consecutive non working minutes per week that agents who are assigned this work plan are allowed to have off
minimumDaysOffPerPlanningPeriodintegerNoMinimum days off in the planning period
minimumPaidMinutesPerPlanningPeriodintegerNoMinimum paid minutes in the planning period
minimumShiftStartDistanceMinutesintegerNoThe time period in minutes for the duration between the start times of two consecutive working days
minimumTimeBetweenShiftsMinutesintegerNoMinimum time between shifts in minutes defined in this work plan. Used if constrainMinimumTimeBetweenShifts == true
minimumWorkingDaysPerWeekintegerNoThe minimum number of days that agents assigned to a work plan must work per week
namestringNoname
optionalDaysobjectNooptionalDays
paidTimeGranularityMinutesintegerNoGranularity in minutes allowed for shift paid time in this work plan. Used if constrainPaidTimeGranularity == true
selfUristringNoThe URI for this object
shiftsany[]NoShifts in this work plan
shiftStartVariancePeriodstringNoThe length of the period over which the maximum shift start time variance is applied
shiftStartVariancesobjectNoshiftStartVariances
shiftStartVarianceTypestringNoThis constraint ensures that an agent starts each workday within a user-defined time threshold
validbooleanNoWhether the work plan is valid or not
weeklyExactPaidMinutesintegerNoExact weekly paid time in minutes for this work plan. Used if flexibleWeeklyPaidTime == false
weeklyMaximumPaidMinutesintegerNoMaximum weekly paid time in minutes for this work plan. Used if flexibleWeeklyPaidTime == true
weeklyMinimumPaidMinutesintegerNoMinimum 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
workPlanRotationIdstringYesThe ID of the work plan rotation to create a copy
namestringYesName to apply to the new copy of the work plan rotation

genesys_workforce_post_managementunit_workplanrotations

Create a new work plan rotation Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
agentsany[]NoAgents in this work plan rotation
dateRangeobjectYesdateRange
namestringYesName of this work plan rotation
patternobjectYespattern

genesys_workforce_post_managementunit_workplans

Create a new work plan Parameters:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
validationModestringNoAllows to create work plan even if the validation result is invalid
agentsany[]NoAgents in this work plan
constrainMaximumConsecutiveWorkingDaysbooleanNoWhether to constrain the maximum consecutive working days
constrainMaximumConsecutiveWorkingWeekendsbooleanNoWhether to constrain the maximum consecutive working weekends
constrainMaximumWorkingWeekendsPerPlanningPeriodbooleanNoWhether to constrain the maximum working weekends in the planning period
constrainMinimumTimeBetweenShiftsbooleanNoWhether the minimum time between shifts constraint is enabled for this work plan
constrainPaidTimeGranularitybooleanNoWhether paid time granularity should be constrained for this workplan
constrainWeeklyPaidTimebooleanNoWhether the weekly paid time constraint is enabled for this work plan
enabledbooleanNoWhether the work plan is enabled for scheduling
flexibleWeeklyPaidTimebooleanNoWhether the weekly paid time constraint is flexible for this work plan
maximumConsecutiveWorkingDaysintegerNoThe maximum number of consecutive days that agents assigned to this work plan are allowed to work. Used if constrainMaximumConsecutiveWorkingDays == true
maximumConsecutiveWorkingWeekendsintegerNoThe maximum number of consecutive weekends that agents who are assigned to this work plan are allowed to work
maximumDaysintegerNoMaximum number days in a week allowed to be scheduled for this work plan
maximumDaysOffPerPlanningPeriodintegerNoMaximum days off in the planning period
maximumPaidMinutesPerPlanningPeriodintegerNoMaximum paid minutes in the planning period
maximumWorkingWeekendsPerPlanningPeriodintegerNoMaximum working weekends in the planning period
minimumConsecutiveNonWorkingMinutesPerWeekintegerNoMinimum amount of consecutive non working minutes per week that agents who are assigned this work plan are allowed to have off
minimumDaysOffPerPlanningPeriodintegerNoMinimum days off in the planning period
minimumPaidMinutesPerPlanningPeriodintegerNoMinimum paid minutes in the planning period
minimumShiftStartDistanceMinutesintegerNoThe time period in minutes for the duration between the start times of two consecutive working days
minimumTimeBetweenShiftsMinutesintegerNoMinimum time between shifts in minutes defined in this work plan. Used if constrainMinimumTimeBetweenShifts == true
minimumWorkingDaysPerWeekintegerNoThe minimum number of days that agents assigned to a work plan must work per week
namestringYesName of this work plan
optionalDaysobjectNooptionalDays
paidTimeGranularityMinutesintegerNoGranularity in minutes allowed for shift paid time in this work plan. Used if constrainPaidTimeGranularity == true
shiftsany[]NoShifts in this work plan
shiftStartVariancePeriodstringNoThe length of the period over which the maximum shift start time variance is applied
shiftStartVariancesobjectNoshiftStartVariances
shiftStartVarianceTypestringNoThis constraint ensures that an agent starts each workday within a user-defined time threshold
weeklyExactPaidMinutesintegerNoExact weekly paid time in minutes for this work plan. Used if flexibleWeeklyPaidTime == false
weeklyMaximumPaidMinutesintegerNoMaximum weekly paid time in minutes for this work plan. Used if flexibleWeeklyPaidTime == true
weeklyMinimumPaidMinutesintegerNoMinimum weekly paid time in minutes for this work plan. Used if flexibleWeeklyPaidTime == true

genesys_workforce_post_managementunits

Add a management unit Parameters:
ParameterTypeRequiredDefaultDescription
businessUnitIdstringYesThe id of the business unit to which this management unit belongs
divisionIdstringNoThe id of the division to which this management unit belongs. Defaults to home division ID
namestringYesThe name of the management unit
settingsobjectNosettings
startDayOfWeekstringNoThe configured first day of the week for scheduling and forecasting purposes. Moving to Business Unit
timeZonestringNoThe 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:
ParameterTypeRequiredDefaultDescription
entitiesany[]YesThe notifications to update

genesys_workforce_post_team_adherence_historical

Request a teams historical adherence report Parameters:
ParameterTypeRequiredDefaultDescription
teamIdstringYesThe ID of the team
endDatestringNoEnd of the date range to query in ISO-8601 format. If it is not set, end date will be set to current time
includeExceptionsbooleanNoWhether user exceptions should be returned as part of the results
startDatestringYesBeginning of the date range to query in ISO-8601 format
timeZonestringYesThe 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.
userIdsany[]NoThe 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:
ParameterTypeRequiredDefaultDescription
activityCodeIdsany[]YesThe set of activity code IDs for which to query available time off balances
dateRangesany[]NoThe 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:
ParameterTypeRequiredDefaultDescription
activityCodeIdstringYesThe ID for activity code to query available time off minutes
dateRangesany[]NoA 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:
ParameterTypeRequiredDefaultDescription
activityCodeIdstringYesThe ID of the activity code associated with this time off request. Activity code must be of the TimeOff category
dailyDurationMinutesintegerYesThe daily duration of this time off request in minutes
durationMinutesany[]NoDaily durations for each day of this time off request in minutes
fullDayManagementUnitDatesany[]NoA set of dates in yyyy-MM-dd format. Should be interpreted in the management unit’s configured time zone.
notesstringNoNotes about the time off request
partialDayStartDateTimesany[]NoA set of start date-times in ISO-8601 format for partial day requests.
payableMinutesany[]NoPayable minutes for each day of this time off request

genesys_workforce_post_timeoffrequests_estimate

Estimates available time off for current user Parameters:
ParameterTypeRequiredDefaultDescription
activityCodeIdstringYesThe ID of the activity code associated with the time off request. Activity code must be of the TimeOff category
fullDayDatesany[]NoFull day dates. partialDayDates must be empty if this field is populated
paidbooleanYesWhether this estimate is for a paid time off request
partialDayDatesany[]NoPartial 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:
ParameterTypeRequiredDefaultDescription
timeOffRequestIdsany[]YesA list of time off request IDs

genesys_workforce_post_workforcemanagement_agentschedules_mine

Get published schedule for the current user Parameters:
ParameterTypeRequiredDefaultDescription
endDatestringYesEnd date of the range to search. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
startDatestringYesStart 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
forceAsyncbooleanNoForce the result of this operation to be sent asynchronously via notification. For testing/app development purposes
forceDownloadServicebooleanNoForce the result of this operation to be sent via download service. For testing/app development purposes
endDatestringYesEnd date of the range to search. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
startDatestringYesStart date of the range to search. Date time is represented as an ISO-8601 string. For example: yyyy-MM-ddTHH:mm:ss[.mmm]Z
userIdsany[]NoIDs 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit, or ‘mine’ for the management unit of the logged-in user.
forceDownloadServicebooleanNoForce the result of this operation to be sent via download service. For testing/app development purposes
dateRangeobjectNodateRange
idsany[]NoThe set of ids to filter time off requests
statusesany[]NoThe set of statuses to filter time off requests
substatusesany[]NoThe set of substatuses to filter time off requests
userIdsany[]NoThe set of user ids to filter time off requests

genesys_workforce_post_workforcemanagement_timeoffrequests

Create a time off request for the current user Parameters:
ParameterTypeRequiredDefaultDescription
activityCodeIdstringYesThe ID of the activity code associated with this time off request. Activity code must be of the TimeOff category
dailyDurationMinutesintegerYesThe daily duration of this time off request in minutes
durationMinutesany[]NoDaily durations for each day of this time off request in minutes
fullDayManagementUnitDatesany[]NoA set of dates in yyyy-MM-dd format. Should be interpreted in the management unit’s configured time zone.
notesstringNoNotes about the time off request
partialDayStartDateTimesany[]NoA set of start date-times in ISO-8601 format for partial day requests.
payableMinutesany[]NoPayable 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:
ParameterTypeRequiredDefaultDescription
managementUnitIdstringYesThe ID of the management unit.
timeOffLimitIdstringYesThe ID of the time off limit object to set values for
metadataobjectYesmetadata
valuesany[]Novalues