shift resource type

  • 2 minutes to read
  • Contributors
    • Nick Kramer (Teams)
    • finsharp
    • Laura Graham

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported.

A unit of scheduled work in a schedule.

Methods

Method Return Type Description
Create shift shift Create a new shift.
List shifts shift collection Get the list of shifts in this schedule.
Get shift shift Get a shift by ID.
Replace shift shift Replace a shift.
Delete shift None Delete a shift from the schedule.

Properties

Name Type Description
id string ID of the shift.
userId string ID of the user assigned to the shift. Required.
schedulingGroupId string ID of the scheduling group the shift is part of. Required.
sharedShift shiftItem The shared version of this shift that is viewable by both employees and managers. Required.
draftShift shiftItem The draft version of this shift that is viewable by managers. Required.
createdDateTime DateTimeOffset The timestamp on which this shift was first created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.
lastModifiedDateTime DateTimeOffset The timestamp on which this shift was last updated. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.
lastModifiedBy identitySet The identity that last updated this shift.

JSON representation

Here is a JSON representation of the resource.

{
  "id": "SHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8",
  "createdDateTime": "2019-03-14T04:32:51.451Z",
  "lastModifiedDateTime": "2019-03-14T05:32:51.451Z",
  "userId": "c5d0c76b-80c4-481c-be50-923cd8d680a1",
  "schedulingGroupId": "TAG_228940ed-ff84-4e25-b129-1b395cf78be0",
  "lastModifiedBy": {"@odata.type":"microsoft.graph.identitySet"},
  "sharedShift": {"@odata.type":"microsoft.graph.shiftItem"},
  "draftShift": {"@odata.type":"microsoft.graph.shiftItem"}
}