WorkforceIntegration.Read.All

Allows the app to read workforce integrations, to synchronize data from Microsoft Teams Shifts, on behalf of the signed-in user.

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the WorkforceIntegration.Read.All permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category	Application	Delegated
Identifier	-	f1ccd5a7-6383-466a-8db8-1a656f7d06fa
DisplayText	-	Read workforce integrations
Description	-	Allows the app to read workforce integrations, to synchronize data from Microsoft Teams Shifts, on behalf of the signed-in user.
AdminConsentRequired	Yes	Yes

Graph Methods

• API [v1.0]
• API [beta]
• PowerShell [v1.0]
• PowerShell [beta]

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	GET /teamwork/workforceIntegrations
	GET /teamwork/workforceIntegrations/{workforceIntegrationId}

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

• workforceIntegration

Graph reference: workforceIntegration

Property	Type	Description
apiVersion	Int32	API version for the call back URL. Start with 1.
createdDateTime	DateTimeOffset	The timestamp on which this workforceIntegration was first created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Inherited from changeTrackedEntity.
displayName	String	Name of the workforce integration.
eligibilityFilteringEnabledEntities	eligibilityFilteringEnabledEntities	Support to view eligibility-filtered results. Possible values are: none, swapRequest, offerShiftRequest, unknownFutureValue, timeOffReason. Use the Prefer: include-unknown-enum-members request header to get the following value in this evolvable enum: timeOffReason.
encryption	workforceIntegrationEncryption	The workforce integration encryption resource.
isActive	Boolean	Indicates whether this workforce integration is currently active and available.
supportedEntities	workforceIntegrationSupportedEntities	The Shifts entities supported for synchronous change notifications. Shifts call back to the provided URL when client changes occur to the entities specified in this property. By default, no entities are supported for change notifications. Possible values are: none, shift, swapRequest, userShiftPreferences, openShift, openShiftRequest, offerShiftRequest, unknownFutureValue, timeOffReason, timeOff, timeOffRequest. Use the Prefer: include-unknown-enum-members request header to get the following values in this evolvable enum: timeOffReason, timeOff, timeOffRequest.
url	String	Workforce Integration URL for callbacks from the Shifts service.