Schedule.ReadWrite.All
Export JSON
Export CSV
Copy URL
Print
ApplicationDelegated
Read/Write
All Resources
Allows the app to manage all schedules, schedule groups, shifts and associated entities in the Teams or Shifts application without a signed-in user.
Permission data: April 6, 2026 at 4:06 AM UTC
Delegated Access
App-Only Access
Permission Details
Application Permission
Read and write all schedule items
Allows the app to manage all schedules, schedule groups, shifts and associated entities in the Teams or Shifts application without a signed-in user.
Permission ID:
b7760610-0545-4e8a-9ec3-cce9e63db01c
Delegated Permission
Admin consent required
Read and write user schedule items
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.
User sees: Allows the app to manage schedule, schedule groups, shifts and associated entities in the Teams or Shifts application on your behalf.
Permission ID:
63f27281-c9d9-4f29-94dd-6942f7f1feb0
Properties
Microsoft Graph v1.0
exact-category-docs
Properties is shown from stable Microsoft Graph v1.0 metadata.
| Property | Type | Description |
|---|---|---|
enabled |
BooleanNullable |
Indicates whether the schedule is enabled for the team. Required. |
id |
string |
ID of the schedule. |
isActivitiesIncludedWhenCopyingShiftsEnabled |
BooleanNullable |
Indicates whether copied shifts include activities from the original shift. |
offerShiftRequestsEnabled |
BooleanNullable |
Indicates whether offer shift requests are enabled for the schedule. |
openShiftsEnabled |
BooleanNullable |
Indicates whether open shifts are enabled for the schedule. |
provisionStatus |
operationStatusRead-only |
The status of the schedule provisioning. The possible values are notStarted, running, completed, failed. |
provisionStatusCode |
stringRead-onlyNullable |
Additional information about why schedule provisioning failed. |
startDayOfWeek |
dayOfWeek |
Indicates the start day of the week. The possible values are: sunday, monday, tuesday, wednesday, thursday, friday, saturday. |
swapShiftsRequestsEnabled |
BooleanNullable |
Indicates whether swap shifts requests are enabled for the schedule. |
timeClockEnabled |
BooleanNullable |
Indicates whether time clock is enabled for the schedule. |
timeClockSettings |
timeClockSettings |
The time clock location settings for this schedule. |
timeOffRequestsEnabled |
BooleanNullable |
Indicates whether time off requests are enabled for the schedule. |
timeZone |
stringNullable |
Indicates the time zone of the schedule team using tz database format. Required. |
workforceIntegrationIds |
String collection |
The IDs for the workforce integrations associated with this schedule. |
dayNotes |
dayNote collection |
The day notes in the schedule. |
Showing 15 of 25 properties.
JSON Representation
Microsoft Graph v1.0
exact-category-docs
JSON representation is shown from stable Microsoft Graph v1.0 metadata.
JSON representation
{
"@odata.type": "#microsoft.graph.schedule",
"id": "String (identifier)",
"enabled": "Boolean",
"timeZone": "String",
"provisionStatus": "String",
"provisionStatusCode": "String",
"workforceIntegrationIds": [
"String"
],
"timeClockEnabled": "Boolean",
"timeClockSettings": {
"@odata.type": "microsoft.graph.timeClockSettings"
},
"openShiftsEnabled": "Boolean",
"swapShiftsRequestsEnabled": "Boolean",
"offerShiftRequestsEnabled": "Boolean",
"timeOffRequestsEnabled": "Boolean",
"startDayOfWeek": "String",
"isActivitiesIncludedWhenCopyingShiftsEnabled": "Boolean"
}Relationships
Microsoft Graph v1.0
exact-category-docs
Relationships is shown from stable Microsoft Graph v1.0 metadata.
| Relationship | Type | Description |
|---|---|---|
dayNotes |
dayNote collection |
The day notes in the schedule. |
offerShiftRequests |
offerShiftRequest collection |
The offer requests for shifts in the schedule. |
openShiftChangeRequests |
openShiftChangeRequest collection |
The open shift requests in the schedule. |
openShifts |
openShift collection |
The set of open shifts in a scheduling group in the schedule. |
schedulingGroups |
schedulingGroup collection |
The logical grouping of users in the schedule (usually by role). |
shifts |
shift collection |
The shifts in the schedule. |
swapShiftsChangeRequests |
swapShiftsChangeRequest collection |
The swap requests for shifts in the schedule. |
timeCards |
timeCard collection |
The time cards in the schedule. |
timesOff |
timeOff collection |
The instances of times off in the schedule. |
timeOffReasons |
timeOffReason collection |
The set of reasons for a time off in the schedule. |
timeOffRequests |
timeOffRequest collection |
The time off requests in the schedule. |
workforceIntegrations |
workforceIntegration collection |
An instance of a workforce integration per team with outbound data flow on synchronous change notifications (for supported entities). |
workforceIntegrationIds |
string collection |
The IDs for the workforce integrations associated with this schedule. |
shiftsRoleDefinitions |
shiftsRoleDefinition collection |
The definitions of the roles in the schedule. |
Graph Methods
Delegated access
App-only access
Exact Microsoft Learn match
Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
Exact Microsoft Learn match
Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
Exact Microsoft Learn PowerShell match
Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.
Exact Microsoft Learn PowerShell match
Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.
Code Examples
C# / .NET SDK
Create offerShiftRequest
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new OfferShiftRequest
{
SenderShiftId = "SHFT_f7e484ed-fdd6-421c-92d9-0bc9e62e2c29",
SenderMessage = "Having a family emergency, could you take this shift for me?",
RecipientUserId = "fe278b61-21ac-4872-8b41-1962bbb98e3c",
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Teams["{team-id}"].Schedule.OfferShiftRequests.PostAsync(requestBody, (requestConfiguration) =>
{
requestConfiguration.Headers.Add("Authorization", "Bearer {token}");
});
JavaScript
changeTrackedEntity: stageForDeletion
const options = {
authProvider,
};
const client = Client.init(options);
await client.api('/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/openShifts/OPNSHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8/stageForDeletion')
.post();
PowerShell
Create offerShiftRequest
Import-Module Microsoft.Graph.Teams
$params = @{
senderShiftId = "SHFT_f7e484ed-fdd6-421c-92d9-0bc9e62e2c29"
senderMessage = "Having a family emergency, could you take this shift for me?"
recipientUserId = "fe278b61-21ac-4872-8b41-1962bbb98e3c"
}
New-MgTeamScheduleOfferShiftRequest -TeamId $teamId -BodyParameter $params
Python
Create offerShiftRequest
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.teams.item.schedule.offer_shift_requests.offer_shift_requests_request_builder import OfferShiftRequestsRequestBuilder
from kiota_abstractions.base_request_configuration import RequestConfiguration
from msgraph.generated.models.offer_shift_request import OfferShiftRequest
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = OfferShiftRequest(
sender_shift_id = "SHFT_f7e484ed-fdd6-421c-92d9-0bc9e62e2c29",
sender_message = "Having a family emergency, could you take this shift for me?",
recipient_user_id = "fe278b61-21ac-4872-8b41-1962bbb98e3c",
)
request_configuration = RequestConfiguration()
request_configuration.headers.add("Authorization", "Bearer {token}")
result = await graph_client.teams.by_team_id('team-id').schedule.offer_shift_requests.post(request_body, request_configuration = request_configuration)App Registration
1
Navigate to Azure Portal
Go to App registrations in Microsoft Entra admin center
2
Add API Permission
Select your app → API permissions → Add a permission → Microsoft Graph
3
Select Permission Type
Choose Application permissions or delegated permissions and search for Schedule.ReadWrite.All
4
Grant Admin Consent
Application permissions always require admin consent.