Microsoft Graph

Microsoft Graph Agreements

Microsoft Graph Agreements is the API for managing Microsoft Entra ID (Azure AD) Terms of Use. It lets organizations programmatically create, publish, localize, and version agreement documents (like EULAs, privacy notices, or acceptable use policies), configure how they’re shown to users, and require acceptance or periodic re-acceptance. Through Conditional Access, you can enforce that users (including guests) must accept terms before signing in or accessing specific apps.

GitHub OpenAPI

Documentation

📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/agreement?view=graph-rest-1.0

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/microsoft-graph/refs/heads/main/openapi/agreements-openapi-original.yml

OpenAPI Specification

agreements-openapi-original.yml Raw ↑ 
openapi: 3.1.0
info:
  title: Microsoft Graph Agreements API
  description: |
    Microsoft Graph API for managing agreements in Microsoft Entra ID. 
    This API enables organizations to create, manage, and track terms of use agreements, 
    including agreement files, localizations, and user acceptances.
  version: 1.0.0
  contact:
    name: Microsoft Graph API Support
    url: https://developer.microsoft.com/graph
servers:
  - url: https://graph.microsoft.com/v1.0
    description: Microsoft Graph API v1.0 endpoint
tags:
  - name: Agreement Acceptances
    description: Operations for managing user acceptances of agreements
  - name: Agreement File Localizations
    description: Operations for managing localized versions of agreement files
  - name: Agreement File Versions
    description: Operations for managing versions of agreement file localizations
  - name: Agreement Files
    description: Operations for managing agreement file content and properties
  - name: Agreements
    description: Operations for managing agreement entities including creating, reading, updating, and deleting agreements
paths:
  /agreements:
    description: Provides operations to manage the collection of agreement entities.
    get:
      tags:
        - Agreements
      summary: Microsoft Graph List all agreements
      description: Retrieve a list of all agreement entities in the organization. Supports OData query parameters for filtering, sorting, and pagination.
      operationId: listAgreements
      parameters:
        - $ref: '#/components/parameters/Top'
        - $ref: '#/components/parameters/Skip'
        - $ref: '#/components/parameters/Search'
        - $ref: '#/components/parameters/Filter'
        - $ref: '#/components/parameters/Count'
        - name: $orderby
          in: query
          description: Order items by property values
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          $ref: '#/components/responses/AgreementCollectionResponse'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
        5XX:
          $ref: '#/components/responses/ErrorResponse'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
      x-ms-docs-operation-type: operation
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: default
    post:
      tags:
        - Agreements
      summary: Microsoft Graph Create a new agreement
      description: Create a new agreement entity in the organization. The agreement can include terms of use content and acceptance requirements.
      operationId: createAgreement
      requestBody:
        description: The agreement entity to create
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Agreement'
            examples:
              CreateAgreementRequest:
                $ref: '#/components/examples/CreateAgreementRequest'
        required: true
      responses:
        2XX:
          description: Created entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Agreement'
              examples:
                CreateAgreementResponse:
                  $ref: '#/components/examples/CreateAgreementResponse'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
        5XX:
          $ref: '#/components/responses/ErrorResponse'
      x-ms-docs-operation-type: operation
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: default
  /agreements/{agreement-id}:
    description: Provides operations to manage a specific agreement entity.
    parameters:
      - $ref: '#/components/parameters/AgreementId'
    get:
      tags:
        - Agreements
      summary: Microsoft Graph Get an agreement by ID
      description: Retrieve a specific agreement entity by its unique identifier.
      operationId: getAgreement
      parameters:
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          description: Retrieved entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Agreement'
              examples:
                GetAgreementResponse:
                  $ref: '#/components/examples/GetAgreementResponse'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
        5XX:
          $ref: '#/components/responses/ErrorResponse'
      x-ms-docs-operation-type: operation
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: default
    patch:
      tags:
        - Agreements
      summary: Microsoft Graph Update an agreement
      description: Update the properties of a specific agreement entity.
      operationId: updateAgreement
      requestBody:
        description: New property values for the agreement
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Agreement'
            examples:
              UpdateAgreementRequest:
                $ref: '#/components/examples/UpdateAgreementRequest'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Agreement'
              examples:
                UpdateAgreementResponse:
                  $ref: '#/components/examples/UpdateAgreementResponse'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
        5XX:
          $ref: '#/components/responses/ErrorResponse'
      x-ms-docs-operation-type: operation
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: default
    delete:
      tags:
        - Agreements
      summary: Microsoft Graph Delete an agreement
      description: Delete a specific agreement entity from the organization.
      operationId: deleteAgreement
      parameters:
        - name: If-Match
          in: header
          description: ETag for optimistic concurrency control
          schema:
            type: string
      responses:
        '204':
          description: Success - No content returned
        4XX:
          $ref: '#/components/responses/ErrorResponse'
        5XX:
          $ref: '#/components/responses/ErrorResponse'
      x-ms-docs-operation-type: operation
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: default
  /agreements/{agreement-id}/acceptances:
    description: Provides operations to manage the acceptances property of an agreement entity.
    parameters:
      - $ref: '#/components/parameters/AgreementId'
    get:
      tags:
        - Agreement Acceptances
      summary: Microsoft Graph List agreement acceptances
      description: Retrieve a list of all user acceptances for a specific agreement. Read-only information about acceptances of this agreement.
      operationId: listAgreementAcceptances
      parameters:
        - $ref: '#/components/parameters/Top'
        - $ref: '#/components/parameters/Skip'
        - $ref: '#/components/parameters/Search'
        - $ref: '#/components/parameters/Filter'
        - $ref: '#/components/parameters/Count'
        - name: $orderby
          in: query
          description: Order items by property values
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          $ref: '#/components/responses/AgreementAcceptanceCollectionResponse'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
        5XX:
          $ref: '#/components/responses/ErrorResponse'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
      x-ms-docs-operation-type: operation
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: default
    post:
      tags:
        - Agreement Acceptances
      summary: Microsoft Graph Create an agreement acceptance
      description: Create a new acceptance record for a specific agreement.
      operationId: createAgreementAcceptance
      requestBody:
        description: New acceptance record to create
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgreementAcceptance'
            examples:
              CreateAgreementAcceptanceRequest:
                $ref: '#/components/examples/CreateAgreementAcceptanceRequest'
        required: true
      responses:
        2XX:
          description: Created navigation property
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgreementAcceptance'
              examples:
                CreateAgreementAcceptanceResponse:
                  $ref: '#/components/examples/CreateAgreementAcceptanceResponse'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
        5XX:
          $ref: '#/components/responses/ErrorResponse'
      x-ms-docs-operation-type: operation
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: default
  /agreements/{agreement-id}/acceptances/{agreementAcceptance-id}:
    description: Provides operations to manage a specific acceptance of an agreement.
    parameters:
      - $ref: '#/components/parameters/AgreementId'
      - $ref: '#/components/parameters/AgreementAcceptanceId'
    get:
      tags:
        - Agreement Acceptances
      summary: Microsoft Graph Get an agreement acceptance by ID
      description: Retrieve a specific acceptance record for an agreement.
      operationId: getAgreementAcceptance
      parameters:
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          description: Retrieved navigation property
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgreementAcceptance'
              examples:
                GetAgreementAcceptanceResponse:
                  $ref: '#/components/examples/GetAgreementAcceptanceResponse'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
        5XX:
          $ref: '#/components/responses/ErrorResponse'
      x-ms-docs-operation-type: operation
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: default
    patch:
      tags:
        - Agreement Acceptances
      summary: Microsoft Graph Update an agreement acceptance
      description: Update the properties of a specific agreement acceptance record.
      operationId: updateAgreementAcceptance
      requestBody:
        description: New property values for the acceptance
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgreementAcceptance'
            examples:
              UpdateAgreementAcceptanceRequest:
                $ref: '#/components/examples/UpdateAgreementAcceptanceRequest'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgreementAcceptance'
              examples:
                UpdateAgreementAcceptanceResponse:
                  $ref: '#/components/examples/UpdateAgreementAcceptanceResponse'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
        5XX:
          $ref: '#/components/responses/ErrorResponse'
      x-ms-docs-operation-type: operation
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: default
    delete:
      tags:
        - Agreement Acceptances
      summary: Microsoft Graph Delete an agreement acceptance
      description: Delete a specific acceptance record from an agreement.
      operationId: deleteAgreementAcceptance
      parameters:
        - name: If-Match
          in: header
          description: ETag for optimistic concurrency control
          schema:
            type: string
      responses:
        '204':
          description: Success - No content returned
        4XX:
          $ref: '#/components/responses/ErrorResponse'
        5XX:
          $ref: '#/components/responses/ErrorResponse'
      x-ms-docs-operation-type: operation
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: default
  /agreements/{agreement-id}/acceptances/$count:
    description: Get the count of agreement acceptances.
    parameters:
      - $ref: '#/components/parameters/AgreementId'
    get:
      tags:
        - Agreement Acceptances
      summary: Microsoft Graph Count agreement acceptances
      description: Get the total count of acceptance records for a specific agreement.
      operationId: countAgreementAcceptances
      parameters:
        - $ref: '#/components/parameters/Search'
        - $ref: '#/components/parameters/Filter'
      responses:
        2XX:
          $ref: '#/components/responses/ODataCountResponse'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
        5XX:
          $ref: '#/components/responses/ErrorResponse'
      x-ms-docs-operation-type: operation
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: default
  /agreements/{agreement-id}/file:
    description: Provides operations to manage the file property of an agreement entity.
    parameters:
      - $ref: '#/components/parameters/AgreementId'
    get:
      tags:
        - Agreement Files
      summary: Microsoft Graph Get agreement file
      description: Retrieve the default PDF file linked to an agreement.
      operationId: getAgreementFile
      parameters:
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          description: Retrieved navigation property
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgreementFile'
              examples:
                GetAgreementFileResponse:
                  $ref: '#/components/examples/GetAgreementFileResponse'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
        5XX:
          $ref: '#/components/responses/ErrorResponse'
      x-ms-docs-operation-type: operation
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: default
    patch:
      tags:
        - Agreement Files
      summary: Microsoft Graph Update agreement file
      description: Update the properties of the default file for an agreement.
      operationId: updateAgreementFile
      requestBody:
        description: New property values for the agreement file
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgreementFile'
            examples:
              UpdateAgreementFileRequest:
                $ref: '#/components/examples/UpdateAgreementFileRequest'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgreementFile'
              examples:
                UpdateAgreementFileResponse:
                  $ref: '#/components/examples/UpdateAgreementFileResponse'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
        5XX:
          $ref: '#/components/responses/ErrorResponse'
      x-ms-docs-operation-type: operation
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: default
    delete:
      tags:
        - Agreement Files
      summary: Microsoft Graph Delete agreement file
      description: Delete the default file associated with an agreement.
      operationId: deleteAgreementFile
      parameters:
        - name: If-Match
          in: header
          description: ETag for optimistic concurrency control
          schema:
            type: string
      responses:
        '204':
          description: Success - No content returned
        4XX:
          $ref: '#/components/responses/ErrorResponse'
        5XX:
          $ref: '#/components/responses/ErrorResponse'
      x-ms-docs-operation-type: operation
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: default
  /agreements/{agreement-id}/file/localizations:
    description: Provides operations to manage localized versions of the agreement file.
    parameters:
      - $ref: '#/components/parameters/AgreementId'
    get:
      tags:
        - Agreement File Localizations
      summary: Microsoft Graph List agreement file localizations
      description: Retrieve a list of all localized versions of the terms of use agreement files attached to an agreement.
      operationId: listAgreementFileLocalizations
      parameters:
        - $ref: '#/components/parameters/Top'
        - $ref: '#/components/parameters/Skip'
        - $ref: '#/components/parameters/Search'
        - $ref: '#/components/parameters/Filter'
        - $ref: '#/components/parameters/Count'
        - name: $orderby
          in: query
          description: Order items by property values
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          $ref: '#/components/responses/AgreementFileLocalizationCollectionResponse'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
        5XX:
          $ref: '#/components/responses/ErrorResponse'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
      x-ms-docs-operation-type: operation
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: default
    post:
      tags:
        - Agreement File Localizations
      summary: Microsoft Graph Create agreement file localization
      description: Create a new localized version of the terms of use agreement file.
      operationId: createAgreementFileLocalization
      requestBody:
        description: New localization to create
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgreementFileLocalization'
            examples:
              CreateAgreementFileLocalizationRequest:
                $ref: '#/components/examples/CreateAgreementFileLocalizationRequest'
        required: true
      responses:
        2XX:
          description: Created navigation property
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgreementFileLocalization'
              examples:
                CreateAgreementFileLocalizationResponse:
                  $ref: '#/components/examples/CreateAgreementFileLocalizationResponse'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
        5XX:
          $ref: '#/components/responses/ErrorResponse'
      x-ms-docs-operation-type: operation
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: default
  /agreements/{agreement-id}/file/localizations/{agreementFileLocalization-id}:
    description: Provides operations to manage a specific localized version of an agreement file.
    parameters:
      - $ref: '#/components/parameters/AgreementId'
      - $ref: '#/components/parameters/AgreementFileLocalizationId'
    get:
      tags:
        - Agreement File Localizations
      summary: Microsoft Graph Get agreement file localization
      description: Retrieve a specific localized version of the agreement file.
      operationId: getAgreementFileLocalization
      parameters:
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          description: Retrieved navigation property
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgreementFileLocalization'
              examples:
                GetAgreementFileLocalizationResponse:
                  $ref: '#/components/examples/GetAgreementFileLocalizationResponse'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
        5XX:
          $ref: '#/components/responses/ErrorResponse'
      x-ms-docs-operation-type: operation
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: default
    patch:
      tags:
        - Agreement File Localizations
      summary: Microsoft Graph Update agreement file localization
      description: Update the properties of a specific localized agreement file.
      operationId: updateAgreementFileLocalization
      requestBody:
        description: New property values for the localization
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgreementFileLocalization'
            examples:
              UpdateAgreementFileLocalizationRequest:
                $ref: '#/components/examples/UpdateAgreementFileLocalizationRequest'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgreementFileLocalization'
              examples:
                UpdateAgreementFileLocalizationResponse:
                  $ref: '#/components/examples/UpdateAgreementFileLocalizationResponse'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
        5XX:
          $ref: '#/components/responses/ErrorResponse'
      x-ms-docs-operation-type: operation
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: default
    delete:
      tags:
        - Agreement File Localizations
      summary: Microsoft Graph Delete agreement file localization
      description: Delete a specific localized version of the agreement file.
      operationId: deleteAgreementFileLocalization
      parameters:
        - name: If-Match
          in: header
          description: ETag for optimistic concurrency control
          schema:
            type: string
      responses:
        '204':
          description: Success - No content returned
        4XX:
          $ref: '#/components/responses/ErrorResponse'
        5XX:
          $ref: '#/components/responses/ErrorResponse'
      x-ms-docs-operation-type: operation
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: default
  /agreements/{agreement-id}/file/localizations/{agreementFileLocalization-id}/versions:
    description: Provides operations to manage versions of a localized agreement file.
    parameters:
      - $ref: '#/components/parameters/AgreementId'
      - $ref: '#/components/parameters/AgreementFileLocalizationId'
    get:
      tags:
        - Agreement File Versions
      summary: Microsoft Graph List agreement file localization versions
      description: Retrieve a list of all versions for a specific localized agreement file.
      operationId: listAgreementFileLocalizationVersions
      parameters:
        - $ref: '#/components/parameters/Top'
        - $ref: '#/components/parameters/Skip'
        - $ref: '#/components/parameters/Search'
        - $ref: '#/components/parameters/Filter'
        - $ref: '#/components/parameters/Count'
        - name: $orderby
          in: query
          description: Order items by property values
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          $ref: '#/components/responses/AgreementFileVersionCollectionResponse'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
        5XX:
          $ref: '#/components/responses/ErrorResponse'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
      x-ms-docs-operation-type: operation
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: default
    post:
      tags:
        - Agreement File Versions
      summary: Microsoft Graph Create agreement file localization version
      description: Create a new version for a localized agreement file.
      operationId: createAgreementFileLocalizationVersion
      requestBody:
        description: New version to create
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgreementFileVersion'
            examples:
              CreateAgreementFileVersionRequest:
                $ref: '#/components/examples/CreateAgreementFileVersionRequest'
        required: true
      responses:
        2XX:
          description: Created navigation property
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgreementFileVersion'
              examples:
                CreateAgreementFileVersionResponse:
                  $ref: '#/components/examples/CreateAgreementFileVersionResponse'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
        5XX:
          $ref: '#/components/responses/ErrorResponse'
      x-ms-docs-operation-type: operation
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: default
  /agreements/{agreement-id}/file/localizations/{agreementFileLocalization-id}/versions/{agreementFileVersion-id}:
    description: Provides operations to manage a specific version of a localized agreement file.
    parameters:
      - $ref: '#/components/parameters/AgreementId'
      - $ref: '#/components/parameters/AgreementFileLocalizationId'
      - $ref: '#/components/parameters/AgreementFileVersionId'
    get:
      tags:
        - Agreement File Versions
      summary: Microsoft Graph Get agreement file localization version
      description: Retrieve a specific version of a localized agreement file.
      operationId: getAgreementFileLocalizationVersion
      parameters:
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          description: Retrieved navigation property
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgreementFileVersion'
              examples:
                GetAgreementFileVersionResponse:
                  $ref: '#/components/examples/GetAgreementFileVersionResponse'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
        5XX:
          $ref: '#/components/responses/ErrorResponse'
      x-ms-docs-operation-type: operation
      x-microcks-operation:
        delay: 100
        dispatcher: FALLBACK
        dispatcherRules: default
    patch:
      tags:
        - Agreement File Versions
      summary: Microsoft Graph Update agreement file localization version
      description: Update the properties of a specific version of a localized agreement file.
      operationId: updateAgreementFileLocalizationVersion
      requestBody:
        description: New property values for the version
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgreementFileVersion'
            examples:
              UpdateAgreementFileVersionRequest:
                $ref: '#/components/examples/UpdateAgreementFileVersionRequest'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgreementFileVersion'
              examples:
                UpdateAgreementFileVersionResponse:
                  $ref: '#/components/examples/UpdateAgreem

# --- truncated at 32 KB (63 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-graph/refs/heads/main/openapi/agreements-openapi-original.yml