SchedulePermissions.ReadWrite.All

Permission Details

Application Permission

Read/Write schedule permissions for a role

Allows the app to read/write schedule permissions for a specific role in Shifts application without a signed-in user.

Permission ID: 7239b71d-b402-4150-b13d-78ecfe8df441

Delegated Permission

Read/Write schedule permissions for a role.

Allows the app to read/write schedule permissions for a specific role in Shifts application on behalf of the signed-in user.

Permission ID: 07919803-6073-4cd8-bc55-28077db0ee10

Properties

Microsoft Graph v1.0 endpoint-derived-docs

Properties is shown from stable Microsoft Graph v1.0 metadata.

Property	Type	Description
`id`	`string`	The unique identifier of the team. The group has the same ID as the team. This property is read-only, and is inherited from the base entity type.
`classification`	`string`Nullable	An optional label. Typically describes the data or business sensitivity of the team. Must match one of a preconfigured set in the tenant's directory.
`classSettings`	`teamClassSettings`	Configure settings of a class. Available only when the team represents a class.
`createdDateTime`	`dateTimeOffset`Nullable	Timestamp at which the team was created.
`description`	`string`Nullable	An optional description for the team. Maximum length: 1,024 characters.
`displayName`	`string`Nullable	The name of the team.
`firstChannelName`	`String`Nullable	The name of the first channel in the team. This is an optional property, only used during team creation and isn't returned in methods to get and list teams.
`funSettings`	`teamFunSettings`	Settings to configure use of Giphy, memes, and stickers in the team.
`guestSettings`	`teamGuestSettings`	Settings to configure whether guests can create, update, or delete channels in the team.
`internalId`	`string`Nullable	A unique ID for the team that was used in a few places such as the audit log/Office 365 Management Activity API.
`isArchived`	`Boolean`Nullable	Whether this team is in read-only mode.
`memberSettings`	`teamMemberSettings`	Settings to configure whether members can perform certain actions, for example, create channels and add bots, in the team.
`messagingSettings`	`teamMessagingSettings`	Settings to configure messaging and mentions in the team.
`specialization`	`teamSpecialization`	Optional. Indicates whether the team is intended for a particular use case. Each team specialization has access to unique behaviors and experiences targeted to its use case.
`summary`	`teamSummary`	Contains summary information about the team, including number of owners, members, and guests.

Showing 15 of 32 properties.

JSON Representation

Microsoft Graph v1.0 endpoint-derived-docs

JSON representation is shown from stable Microsoft Graph v1.0 metadata.

JSON representation

{
  "classSettings": {
    "@odata.type": "microsoft.graph.teamClassSettings"
  },
  "classification": "String",
  "createdDateTime": "DateTimeOffset",
  "description": "String",
  "displayName": "String",
  "firstChannelName": "String",
  "funSettings": {
    "@odata.type": "microsoft.graph.teamFunSettings"
  },
  "guestSettings": {
    "@odata.type": "microsoft.graph.teamGuestSettings"
  },
  "internalId": "String",
  "isArchived": "Boolean",
  "memberSettings": {
    "@odata.type": "microsoft.graph.teamMemberSettings"
  },
  "messagingSettings": {
    "@odata.type": "microsoft.graph.teamMessagingSettings"
  },
  "specialization": "String",
  "tenantId": "String",
  "visibility": "String",
  "webUrl": "String (URL)"
}

Relationships

Microsoft Graph v1.0 endpoint-derived-docs

Relationships is shown from stable Microsoft Graph v1.0 metadata.

Relationship	Type	Description
`allChannels`	`channel collection`	List of channels either hosted in or shared with the team (incoming channels).
`channels`	`channel collection`	The collection of channels and messages associated with the team.
`incomingChannels`	`channel collection`	List of channels shared with the team.
`installedApps`	`teamsAppInstallation collection`	The apps installed in this team.
`members`	`conversationMember collection`	Members and owners of the team.
`operations`	`teamsAsyncOperation collection`	The async operations that ran or are running on this team.
`photo`	`profilePhoto`	The profile photo for the team.
`primaryChannel`	`channel`	The general channel for the team.
`schedule`	`schedule`	The schedule of shifts for this team.
`tags`	`teamworkTag collection`	The tags associated with the team.
`template`	`teamsTemplate`	The template this team was created from. See available templates.
`permissionGrants`	`resourceSpecificPermissionGrant collection`	A collection of permissions granted to apps to access the team.
`owners`	`user collection`	The list of this team's owners. Currently, when creating a team using application permissions, exactly one owner must be specified. When using user-delegated permissions, no owner can be specified (the current user is the owner). The owner must be specified as an object ID (GUID), not a UPN.

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.

No API methods available for this version.

Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET `/team/{teamId}/schedule/shiftsRoleDefinitions/{roleId}`
PATCH `/team/{teamId}/schedule/shiftsRoleDefinitions/{roleId}`

No Microsoft Learn PowerShell mapping available

Microsoft Graph PowerShell v1.0 commands are not available from refreshed Microsoft Learn PowerShell snippets for this permission.

No deterministic PowerShell command map is available for this permission.

Browse PowerShell docs

No Microsoft Learn PowerShell mapping available

Microsoft Graph PowerShell beta commands are not available from refreshed Microsoft Learn PowerShell snippets for this permission.

No deterministic PowerShell command map is available for this permission.

Browse PowerShell docs

Code Examples

C# / .NET SDK

using Azure.Identity;
using Microsoft.Graph;

var scopes = new[] { "SchedulePermissions.ReadWrite.All" };
var credential = new InteractiveBrowserCredential(
    new InteractiveBrowserCredentialOptions
    {
        ClientId = "YOUR_CLIENT_ID",
        TenantId = "YOUR_TENANT_ID",
        RedirectUri = new Uri("http://localhost")
    });

var graphClient = new GraphServiceClient(credential, scopes);
var response = await graphClient
    .WithUrl("https://graph.microsoft.com/v1.0/team/{id}/schedule/shiftsRoleDefinitions/{id}")
    .GetAsync();

JavaScript

import { Client } from "@microsoft/microsoft-graph-client";
import { InteractiveBrowserCredential } from "@azure/identity";

const credential = new InteractiveBrowserCredential({
  clientId: "YOUR_CLIENT_ID",
  tenantId: "YOUR_TENANT_ID",
  redirectUri: "http://localhost"
});

const token = await credential.getToken(["SchedulePermissions.ReadWrite.All"]);
const client = Client.init({
  authProvider: (done) => done(null, token.token)
});

const response = await client.api("/team/{id}/schedule/shiftsRoleDefinitions/{id}").get();

PowerShell

Connect-MgGraph -Scopes "SchedulePermissions.ReadWrite.All"
Invoke-MgGraphRequest -Method GET -Uri "https://graph.microsoft.com/v1.0/team/{id}/schedule/shiftsRoleDefinitions/{id}"

Python

from azure.identity import InteractiveBrowserCredential
import requests

credential = InteractiveBrowserCredential(
    client_id="YOUR_CLIENT_ID",
    tenant_id="YOUR_TENANT_ID"
)

token = credential.get_token("SchedulePermissions.ReadWrite.All")
response = requests.get(
    "https://graph.microsoft.com/v1.0/team/{id}/schedule/shiftsRoleDefinitions/{id}",
    headers={"Authorization": f"Bearer {token.token}"}
)

print(response.json())

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 SchedulePermissions.ReadWrite.All

4

Grant Admin Consent

Application permissions always require admin consent.

Frequently asked questions

What is the SchedulePermissions.ReadWrite.All Microsoft Graph permission?

SchedulePermissions.ReadWrite.All is available as both an application permission and a delegated permission in the Microsoft Graph API, grouped under the SchedulePermissions category. Allows the app to read/write schedule permissions for a specific role in Shifts application without a signed-in user. It grants read and write access to resources. Application permissions always require admin consent. It is mapped to the Microsoft Graph team resource type. 2 documented Microsoft Graph REST methods require it.

Is SchedulePermissions.ReadWrite.All an application or a delegated permission?

SchedulePermissions.ReadWrite.All is available as both an application permission (app-only access, no signed-in user) and a delegated permission (access on behalf of a signed-in user).

Does SchedulePermissions.ReadWrite.All require admin consent?

Application permissions always require admin consent.

What is the permission ID (GUID) for SchedulePermissions.ReadWrite.All?

For SchedulePermissions.ReadWrite.All, the application (app role) ID is 7239b71d-b402-4150-b13d-78ecfe8df441, and the delegated (OAuth2 scope) ID is 07919803-6073-4cd8-bc55-28077db0ee10. These are the real Microsoft Graph identifiers and can be used directly in an app registration manifest.