---
title: "Update Machine Tasks"
method: PUT
path: "/v1/Scheduling/schedule/machine-tasks"
tags: ["Scheduling"]
---

# Update Machine Tasks

`PUT /v1/Scheduling/schedule/machine-tasks`

Updates existing scheduled tasks for machines. The request body should include the updated task details.

## Request body

- TaskSchedulingUpdateDto[]
  - `SchedulingId` integer, nullable — The unique identifier of the scheduling instance being updated. This field is nullable if the scheduling instance is not specified.
  - `MachineId` integer — The unique identifier of the machine associated with the task.
  - `TaskLutId` string, nullable — The identifier for the type of task from the lookup table. This field is nullable if the task type is not specified.
  - `DriverId` string, uuid, nullable — The unique identifier of the driver assigned to the task. This field is nullable if no driver is assigned.
  - `ScheduleDate` string, date-time, nullable — The date and time when the task is scheduled to be performed. This field is nullable if the schedule date is not specified.
  - `StatusId` integer — The status identifier of the task, indicating its current state (e.g., pending, completed).
  - `Notes` string, nullable — Additional notes related to the task. This field is nullable if there are no notes.
  - `GeneratePickList` boolean — Indicates whether a pick list should be generated for the task.
  - `GeneratePickListTime` string, nullable — The time when the pick list should be generated. This field is nullable if the pick list generation time is not specified.
  - `GeneratePickListRange` integer, nullable — The range in minutes for generating the pick list. This field is nullable if the range is not specified.
  - `ScheduleNextWorkingDay` boolean — Indicates whether the task should be scheduled for the next working day.
  - `TimezoneOffset` number, double — The timezone offset in hours for the scheduled task, relative to UTC.
  - `AssignedToPatternId` integer, nullable — The unique identifier of the pattern to which the task is assigned. This field is nullable if the task is not associated with a pattern.
  - `AssignedToScheduleId` integer, nullable — The unique identifier of the schedule to which the task is assigned. This field is nullable if the task is not associated with a schedule.
  - `Pattern` Pattern
    - `PatternId` integer, nullable — The unique identifier of the pattern.
    - `Name` string, nullable — The name of the pattern.
    - `Description` string, nullable — The description of the pattern.
    - `RepeatType` integer, nullable — The type of repetition for the pattern (e.g., daily, weekly).
    - `RepeatInterval` integer — The interval of repetition for the pattern.
    - `IsStatic` boolean — Indicates whether the pattern is static.
    - `StartOn` string, date-time, nullable — The start date and time of the pattern.
    - `EndOn` string, date-time, nullable — The end date and time of the pattern.
    - `EndAfter` integer, nullable — The number of occurrences after which the pattern ends.
    - `RepeatOn` RepeatOn[], nullable — The days and weeks on which the pattern repeats.
      - `Tasks` string, nullable — The tasks associated with the repetition pattern.
      - `Days` string, nullable — The days of the week on which the tasks repeat.
      - `Week` string, nullable — The week of the month on which the tasks repeat.
      - `MonthDay` string, nullable — The day of the month on which the tasks repeat.
      - `SetPos` string, nullable — The position within the month (e.g., first, second) for the tasks to repeat.
      - `RecurrenceEx` string, nullable — Any exceptions to the recurrence pattern.
      - `WeekNumber` string, nullable — The week number within the recurrence period.
  - `IsMobile` boolean, nullable — Indicates whether the task was created or updated via a mobile device. This field is nullable if the source of creation is not specified.
  - `IsSeriesUpdate` boolean, nullable — Indicates whether the task is part of a series update. This field is nullable if the task is not part of a series.
  - `OriginalDate` string, date-time, nullable — The original date of the task before any rescheduling. This field is nullable if there was no rescheduling.
  - `IncompletionReasonId` integer, nullable — The unique identifier of the reason for task incompletion. This field is nullable if the task was completed.
  - `IncompletionReason` string, nullable — The reason for task incompletion, if applicable. This field is nullable if the task was completed.

## Response `200`

The updated scheduled tasks.

- ScheduleTaskDto[]
  - `MachineId` integer — The unique identifier of the machine associated with the task.
  - `TaskLutId` string, nullable — The identifier for the type of task from the lookup table.
  - `SchedulingId` integer — The unique identifier of the scheduling instance.
  - `DriverId` string, uuid, nullable — The unique identifier of the driver assigned to the task.
  - `DriverName` string, nullable — The name of the driver assigned to the task.
  - `TimezoneOffset` number, double — The timezone offset in hours for the scheduled task.
  - `ScheduleDate` string, date-time, nullable — The date and time when the task is scheduled.
  - `StatusId` integer — The status identifier of the task.
  - `Notes` string, nullable — Additional notes related to the task.
  - `GeneratePickList` boolean — Indicates whether a pick list should be generated for the task.
  - `GeneratePickListTime` string, nullable — The time when the pick list is generated.
  - `GeneratePickListRange` integer, nullable — The range in minutes for generating the pick list.
  - `ScheduleNextWorkingDay` boolean — Indicates whether the task should be scheduled for the next working day.
  - `AssignedToPatternId` integer, nullable — The unique identifier of the pattern to which the task is assigned.
  - `AssignedToScheduleId` integer, nullable — The unique identifier of the schedule to which the task is assigned.
  - `IncompletionReason` string, nullable — The reason for task incompletion, if applicable.
  - `IncompletionReasonImages` EntityPicture[], nullable — A list of images associated with the reason for task incompletion.
    - `EntityPictureId` integer — The unique identifier of the entity picture.
    - `EntityPictureUrl` string, nullable — The URL of the entity picture.
  - `Pattern` Pattern
    - `PatternId` integer, nullable — The unique identifier of the pattern.
    - `Name` string, nullable — The name of the pattern.
    - `Description` string, nullable — The description of the pattern.
    - `RepeatType` integer, nullable — The type of repetition for the pattern (e.g., daily, weekly).
    - `RepeatInterval` integer — The interval of repetition for the pattern.
    - `IsStatic` boolean — Indicates whether the pattern is static.
    - `StartOn` string, date-time, nullable — The start date and time of the pattern.
    - `EndOn` string, date-time, nullable — The end date and time of the pattern.
    - `EndAfter` integer, nullable — The number of occurrences after which the pattern ends.
    - `RepeatOn` RepeatOn[], nullable — The days and weeks on which the pattern repeats.
      - `Tasks` string, nullable — The tasks associated with the repetition pattern.
      - `Days` string, nullable — The days of the week on which the tasks repeat.
      - `Week` string, nullable — The week of the month on which the tasks repeat.
      - `MonthDay` string, nullable — The day of the month on which the tasks repeat.
      - `SetPos` string, nullable — The position within the month (e.g., first, second) for the tasks to repeat.
      - `RecurrenceEx` string, nullable — Any exceptions to the recurrence pattern.
      - `WeekNumber` string, nullable — The week number within the recurrence period.
  - `IsClustered` boolean, nullable — Indicates whether the task is part of a clustered set of tasks.
  - `ClusterIds` string, nullable — The identifiers of the clustered tasks, if applicable.
  - `CreatedBy` integer — The unique identifier of the user who created the task.
  - `CreatedDt` string, date-time — The date and time when the task was created.
  - `UpdatedBy` integer, nullable — The unique identifier of the user who last updated the task.
  - `UpdatedDt` string, date-time, nullable — The date and time when the task was last updated.
  - `isMobile` boolean, nullable — Indicates whether the task was created or updated via a mobile device.
  - `isSeriesUpdate` boolean, nullable — Indicates whether the task is part of a series update.
  - `originalDate` string, nullable — The original date of the task before any rescheduling, if applicable.
  - `IncompletionReasonId` integer, nullable — The unique identifier of the reason for task incompletion.
  - `IncompletionReasonName` string, nullable — The name of the reason for task incompletion.

---

[API](https://skmtc.net/nayax/apis/nayax-cortina-api.md) · [All operations](https://skmtc.net/nayax/apis/nayax-cortina-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nayax/nayax-cortina-api/versions/421f6f83c257/schema)
