Show / Hide Table of Contents

Schedule.ReadWrite.All

Allows the app to manage schedule, schedule groups, shifts and associated entities in the Teams or Shifts application on behalf of the signed-in user.

Graph Methods

Type: A = Application Permission, D = Delegate Permission

Ver Type Method
V1 A,D DELETE /teams/{id}/schedule/openShifts/{openShiftId}
V1 A,D DELETE /teams/{teamId}/schedule/schedulingGroups/{schedulingGroupId}
V1 A,D DELETE /teams/{teamId}/schedule/shifts/{shiftId}
Beta A,D DELETE /teams/{teamId}/schedule/timecards/{timeCardID}
V1 A,D DELETE /teams/{teamId}/schedule/timeOffReasons/{timeOffReasonId}
V1 A,D DELETE /teams/{teamId}/schedule/timeOffRequests/{timeOffRequestId}
V1 A,D DELETE /teams/{teamId}/schedule/timesOff/{timeOffId}
V1 A,D GET /teams/{id}/schedule/openShiftChangeRequests
V1 A,D GET /teams/{id}/schedule/openShiftChangeRequests/{openShiftsChangeRequestId}
V1 A,D GET /teams/{id}/schedule/openShifts
V1 A,D GET /teams/{id}/schedule/openShifts/{openShiftId}
V1 A,D GET /teams/{teamId}/schedule
V1 A,D GET /teams/{teamId}/schedule/offerShiftRequests
V1 A,D GET /teams/{teamId}/schedule/offerShiftRequests/{offerShiftRequestId}
V1 A,D GET /teams/{teamId}/schedule/schedulingGroups
V1 A,D GET /teams/{teamId}/schedule/schedulingGroups/{schedulingGroupId}
V1 A,D GET /teams/{teamId}/schedule/shifts
V1 A,D GET /teams/{teamId}/schedule/shifts/{shiftId}
V1 A,D GET /teams/{teamId}/schedule/swapShiftsChangeRequests
Beta A,D GET /teams/{teamId}/schedule/timecards
Beta A,D GET /teams/{teamId}/schedule/timecards/{timecardID}
V1 A,D GET /teams/{teamId}/schedule/timeOffReasons
V1 A,D GET /teams/{teamId}/schedule/timeOffReasons/{timeOffReasonId}
V1 A,D GET /teams/{teamId}/schedule/timeOffRequests
V1 A,D GET /teams/{teamId}/schedule/timeOffRequests/{timeOffRequestId}
V1 A,D GET /teams/{teamId}/schedule/timesOff
V1 A,D GET /teams/{teamId}/schedule/timesOff/{timeOffId}
V1 A,D POST /teams/{id}/schedule/openShiftChangeRequests
V1 A,D POST /teams/{id}/schedule/openShiftChangeRequests/{openShiftChangeRequestId}/approve
V1 A,D POST /teams/{id}/schedule/openShiftChangeRequests/{openShiftChangeRequestId}/decline
V1 A,D POST /teams/{id}/schedule/openShifts
V1 A,D POST /teams/{teamId}/schedule/offerShiftRequests
V1 A,D POST /teams/{teamId}/schedule/offerShiftRequests/{offerShiftRequestId}/approve
V1 A,D POST /teams/{teamId}/schedule/offerShiftRequests/{offerShiftRequestId}/decline
V1 A,D POST /teams/{teamId}/schedule/schedulingGroups
V1 A,D POST /teams/{teamId}/schedule/share
V1 A,D POST /teams/{teamId}/schedule/shifts
V1 A,D POST /teams/{teamId}/schedule/swapShiftsChangeRequests
V1 A,D POST /teams/{teamId}/schedule/swapShiftsChangeRequests/{swapShiftChangeRequestId}/approve
V1 A,D POST /teams/{teamId}/schedule/swapShiftsChangeRequests/{swapShiftChangeRequestId}/decline
Beta A,D POST /teams/{teamId}/schedule/timecards
Beta A,D POST /teams/{teamId}/schedule/timecards/{timeCardID}/clockOut
Beta A,D POST /teams/{teamId}/schedule/timecards/{timeCardID}/confirm
Beta A,D POST /teams/{teamId}/schedule/timecards/{timeCardID}/endBreak
Beta A,D POST /teams/{teamId}/schedule/timecards/{timeCardID}/startBreak
Beta A,D POST /teams/{teamId}/schedule/timecards/clockIn
V1 A,D POST /teams/{teamId}/schedule/timeOffReasons
V1 A,D POST /teams/{teamId}/schedule/timeOffRequests/{timeOffRequestId}/approve
V1 A,D POST /teams/{teamId}/schedule/timeOffRequests/{timeOffRequestId}/decline
V1 A,D POST /teams/{teamId}/schedule/timesOff
V1 A,D PUT /teams/{id}/schedule/openShifts/{openShiftId}
V1 A,D PUT /teams/{teamId}/schedule
V1 A,D PUT /teams/{teamId}/schedule/schedulingGroups/{schedulingGroupId}
V1 A,D PUT /teams/{teamId}/schedule/shifts/{shiftId}
Beta A,D PUT /teams/{teamId}/schedule/timecards/{timeCardID}
V1 A,D PUT /teams/{teamId}/schedule/timeOffReasons/{timeOffReasonId}
V1 A,D PUT /teams/{teamId}/schedule/timesOff/{timeOffId}

Delegate Permission

Id 63f27281-c9d9-4f29-94dd-6942f7f1feb0
Consent Type Admin
Display String Read and write user schedule items
Description Allows the app to manage schedule, schedule groups, shifts and associated entities in the Teams or Shifts application on behalf of the signed-in user.

Application Permission

Id b7760610-0545-4e8a-9ec3-cce9e63db01c
Display String Read and write all schedule items
Description Allows the app to manage all schedules, schedule groups, shifts and associated entities in the Teams or Shifts application without a signed-in user.

Resources

itemBody

Property Type Description
content String The content of the item.
contentType bodyType The type of the content. Possible values are text and html.

offerShiftRequest

Property Type Description
recipientActionDateTime DateTimeOffset 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 is 2014-01-01T00:00:00Z
recipientActionMessage String Custom message sent by recipient of the offer shift request.
recipientUserId String User ID of the recipient of the offer shift request.
senderShiftId String User ID of the sender of the offer shift request.

openShift

Property Type Description
draftOpenShift openShiftItem An unpublished open shift.
schedulingGroupId String ID for the scheduling group that the open shift belongs to.
sharedOpenShift openShiftItem A published open shift.

openShiftChangeRequest

Property Type Description
openShiftId String ID for the open shift.

schedule

schedulingGroup

shift

swapShiftsChangeRequest

Property Type Description
recipientShiftId String ShiftId for the recipient user with whom the request is to swap.

timecard

Property Type Description
id string ID of the timeCard.
userId string User ID to which the timeCard belongs.
state timeCardState The current state of the timeCard during its life cycle.Possible values are: clockedIn, onBreak, clockedOut, unknownFutureValue.
clockInEvent timeCardEvent The clock-in event of the timeCard.
clockOutEvent timeCardEvent The clock-out event of the timeCard.
notes itemBody Notes about the timeCard.
breaks timeCardBreak collection The list of breaks associated with the timeCard.
originalEntry timeCardEntry The original timeCardEntry of the timeCard, before user edits.
confirmedBy confirmedBy Indicate if this timeCard entry is confirmed. Possible values are none, user, manager, unknownFutureValue.
createdDateTime Edm.dateTimeOffset The timestamp in which the timeCard was created.
createdBy IdentitySet Identity of the person who created the entity.
lastModifiedDateTime dateTimeOffset The timestamp in which the timeCard was last modified.
lastModifiedBy IdentitySet Identity of the person who last modified the entity.

timeOff

timeOffItem

Property Type Description
timeOffReasonId string ID of the timeOffReason for this timeOffItem. Required.
startDateTime DateTimeOffset The start date and time for the timeOffItem. Required. 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 is 2014-01-01T00:00:00Z.
endDateTime DateTimeOffset The end date and time for the timeOffItem. Required. 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 is 2014-01-01T00:00:00Z.
theme scheduleEntityTheme Supported colors: white; blue; green; purple; pink; yellow; gray; darkBlue; darkGreen; darkPurple; darkPink; darkYellow.

timeOffReason

timeOffRequest

Property Type Description
endDateTime DateTimeOffset 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 is 2014-01-01T00:00:00Z
startDateTime DateTimeOffset 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 is 2014-01-01T00:00:00Z
timeOffReasonId String The reason for the time off.
In This Article
Back to top Created by merill | Submit feedback