ProRoster - Start an AI auto assignment of demands

API Url

Used to start the AI auto assignment of demands.

POST
http://localhost:16010/ProMarkREST/web/ProRoster/plans/{planId}/automations

Permissions: user

Path parameters

FieldTypeDescription
planIdNumber

The plan Id.

Query parameters

FieldTypeDescription
empIdsoptionalString

Comma seperated list of employee ids. if not sent the employees of the current plans are loaded.

Parameter

FieldTypeDescription
requestObject

Main object containing the request data.

  dataObject

Object containg data to be uploaded.

    planSimulationObject[]
      fromDate

The start date of the simulation

      isPrivateBoolean

If the snapshot is private, meaning only the planner who created it will see it

      nameString

The name of the simulation that will be found in the snapshots

      settingsObject[]

Object used for the simulation different settings

        settingNameoptionalObject

Object for a specific setting, where settingName can be: correctTeam, maxHoursDay, maxHoursWeek, maxHoursMonth, lateFridayNeverWithEarlyMonday, maxNHoursInKWeeks, workBothWeekendDays, sameTimeOfDayForConsecutiveShifts, lateShiftWithDayOffNextDayNeverWithEarlyShift, alternatingShiftTypes, hoursBetweenShift, dayOffInAWeekAfterWeekendShift, atLeastTwoContinousDaysOffAWeek If left empty, the AI engine will take care of filling those settings

          firstPriorityWeightoptionalNumber

Value for first priority weight used to determin how critical the setting is

          fourthPriorityWeightoptionalNumber

Value for first priority weight used to determin how critical the setting is

          secondPriorityWeightoptionalNumber

Value for first priority weight used to determin how critical the setting is

          thirdPriorityWeightoptionalNumber

Value for first priority weight used to determin how critical the setting is

      toDate

The end date of the simulation

Request example:

{
"request": {
"data": {
"planSimulation": {
"name": "1",
"from": "2024-04-03",
"to": "2024-04-10",
"isPrivate": true,
"settings": {
"correctTeam": {
"firstPriorityWeight": 0,
"fourthPriorityWeight": 0,
"thirdPriorityWeight": 0,
"secondPriorityWeight": 0
}
}
}
}
}
}

Success 200

FieldTypeDescription
responseObject

Main object containing the response data.

  messageoptionalObject

Object containing response messages.

    codeNumber

Message code.

    textString

Message text.

    typeString

Type of message.

Allowed values:"warning""info"