agreement resource type
Namespace: microsoft.graph
Represents a tenant's customizable terms of use agreement that is created and managed with Azure Active Directory (Azure AD). You can use the following methods to create and manage the Azure Active Directory Terms of Use feature according to your scenario.
Methods
Method | Return Type | Description |
---|---|---|
List | agreement collection | Get an agreement object collection. |
Create | agreement | Create a new agreement by posting to the agreement collection. |
Get | agreement | Read properties and relationships of an agreement object. |
Update | None | Update an agreement object. |
Delete | None | Delete an agreement object. |
List acceptances | agreementAcceptance collection | Get the details about the acceptance records for a specific agreement. |
List agreementAcceptances | agreementAcceptance collection | Get the agreement acceptances for the signed-in user. |
Get agreementFile | agreementFile collection | Retrieve the details of the default file for an agreement, including the language and version information. |
List files | agreementFileLocalization collection | Retrieve all localized files related to an agreement. |
Create agreementFileLocalization | agreementFileLocalization | Create a new localized agreement file. |
Properties
Property | Type | Description |
---|---|---|
displayName | String | Display name of the agreement. The display name is used for internal tracking of the agreement but is not shown to end users who view the agreement. Supports $filter (eq ). |
id | String | The identifier of the agreement. Read-only. Supports $filter (eq ). |
isPerDeviceAcceptanceRequired | Boolean | Indicates whether end users are required to accept this agreement on every device that they access it from. The end user is required to register their device in Azure AD, if they haven't already done so. Supports $filter (eq ). |
isViewingBeforeAcceptanceRequired | Boolean | Indicates whether the user has to expand the agreement before accepting. Supports $filter (eq ). |
termsExpiration | termsExpiration | Expiration schedule and frequency of agreement for all users. Supports $filter (eq ). |
userReacceptRequiredFrequency | Duration | The duration after which the user must re-accept the terms of use. The value is represented in ISO 8601 format for durations. Supports $filter (eq ). |
Relationships
Relationship | Type | Description |
---|---|---|
acceptances | agreementAcceptance collection | Read-only. Information about acceptances of this agreement. |
file | agreementFile | Default PDF linked to this agreement. |
files | agreementFileLocalization collection | PDFs linked to this agreement. This property is in the process of being deprecated. Use the file property instead. Supports $expand . |
JSON representation
The following is a JSON representation of the resource.
{
"@odata.type": "#microsoft.graph.agreement",
"displayName": "String",
"id": "String (identifier)",
"isPerDeviceAcceptanceRequired": "Boolean",
"isViewingBeforeAcceptanceRequired": "Boolean",
"termsExpiration": {
"@odata.type": "microsoft.graph.termsExpiration"
},
"userReacceptRequiredFrequency": "String (duration)"
}
See also
Feedback
Submit and view feedback for