Edit

Share via

agreementFile resource type

  • Article

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents a customizable terms-of-use agreement file that a tenant manages with Microsoft Entra ID. It contains metadata about the agreement file (for example, the name, the language, and whether it's the default file).

Inherits from agreementFileProperties.

Methods

Method Return type Description
Get default file agreementFile Read the properties and relationships of an agreementFile object.
List files agreementFile collection Get a list of the agreementFile objects and their properties.
Create localized files agreementFile Create a new agreementFile object.
List localized files agreementFileLocalization collection Get the agreementFileLocalization resources from the localizations navigation property.

Properties

Property Type Description
createdDateTime DateTimeOffset The date time representing when the file was created. 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. Read-only. Inherited from agreementFileProperties.
displayName String Localized display name of the policy file of an agreement. The localized display name is shown to end users who view the agreement. Inherited from agreementFileProperties.
fileData agreementFileData Data that represents the terms of use PDF document. Read-only. Inherited from agreementFileProperties.
fileName String Name of the agreement file (for example, TOU.pdf). Read-only. Inherited from agreementFileProperties.
id String The identifier of the agreementFileVersion object. Read-only. Inherited from agreementFileProperties.
isDefault Boolean If none of the languages matches the client preference, indicates whether this is the default agreement file. If none of the files are marked as default, the first one is treated as the default. Read-only. Inherited from agreementFileProperties.
isMajorVersion Boolean Indicates whether the agreement file is a major version update. Major version updates invalidate the agreement's acceptances on the corresponding language. Inherited from agreementFileProperties.
language String The language of the agreement file in the format "languagecode2-country/regioncode2". "languagecode2" is a lowercase two-letter code derived from ISO 639-1, while "country/regioncode2" is derived from ISO 3166 and usually consists of two uppercase letters, or a BCP-47 language tag. For example, U.S. English is en-US. Read-only. Inherited from agreementFileProperties.

Relationships

Relationship Type Description
localizations agreementFileLocalization collection The localized version of the terms of use agreement files attached to the agreement.

JSON representation

The following JSON representation shows the resource type.

{
  "fileData": {"@odata.type": "microsoft.graph.agreementFileData"},
  "fileName": "String",
  "id": "String (identifier)",
  "isDefault": true,
  "language": "String"
}