AgreementAcceptance.Read

Allows the app to read terms of use acceptance statuses 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 AgreementAcceptance.Read 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	-	0b7643bb-5336-476f-80b5-18fbfbc91806
DisplayText	-	Read user terms of use acceptance statuses
Description	-	Allows the app to read terms of use acceptance statuses 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 /identityGovernance/termsOfUse/agreements/{agreementsId}/acceptances
	GET /me/agreementAcceptances
	GET /users/{id | userPrincipalName}/agreementAcceptances

Resources

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

• agreementAcceptance

Graph reference: agreementAcceptance

Property	Type	Description
agreementFileId	String	The identifier of the agreement file accepted by the user.
agreementId	String	The identifier of the agreement.
deviceDisplayName	String	The display name of the device used for accepting the agreement.
deviceId	String	The unique identifier of the device used for accepting the agreement. Supports $filter (eq) and eq for null values.
deviceOSType	String	The operating system used to accept the agreement.
deviceOSVersion	String	The operating system version of the device used to accept the agreement.
expirationDateTime	DateTimeOffset	The expiration date time of the acceptance. 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. Supports $filter (eq, ge, le) and eq for null values.
id	String	The identifier of the agreement acceptance. Read-only. Supports $filter (eq).
recordedDateTime	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.
state	string	The state of the agreement acceptance. Possible values are: accepted, declined. Supports $filter (eq).
userDisplayName	String	Display name of the user when the acceptance was recorded.
userEmail	String	Email of the user when the acceptance was recorded.
userId	String	The identifier of the user who accepted the agreement. Supports $filter (eq).
userPrincipalName	String	UPN of the user when the acceptance was recorded.