naftiko: 1.0.0-alpha2
info:
  label: Microsoft Graph OData Service for namespace microsoft.graph — agreements.agreementFile
  description: 'Microsoft Graph OData Service for namespace microsoft.graph — agreements.agreementFile. 15 operations. Lead
    operation: Microsoft Graph Get agreementFile. Self-contained Naftiko capability covering one Microsoft Graph business
    surface.'
  tags:
  - Microsoft Graph
  - agreements.agreementFile
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_GRAPH_API_KEY: MICROSOFT_GRAPH_API_KEY
capability:
  consumes:
  - type: http
    namespace: microsoft-graph-agreements-agreementfile
    baseUri: https://graph.microsoft.com/v1.0
    description: Microsoft Graph OData Service for namespace microsoft.graph — agreements.agreementFile business capability.
      Self-contained, no shared references.
    resources:
    - name: agreements-agreement-id-file
      path: /agreements/{agreement-id}/file
      operations:
      - name: agreementsgetfile
        method: GET
        description: Microsoft Graph Get agreementFile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: $select
          in: query
          type: array
          description: Select properties to be returned
        - name: $expand
          in: query
          type: array
          description: Expand related entities
      - name: agreementsupdatefile
        method: PATCH
        description: Microsoft Graph Update the navigation property file in agreements
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: agreementsdeletefile
        method: DELETE
        description: Microsoft Graph Delete navigation property file for agreements
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: If-Match
          in: header
          type: string
          description: ETag
    - name: agreements-agreement-id-file-localizations
      path: /agreements/{agreement-id}/file/localizations
      operations:
      - name: agreementsfilelistlocalizations
        method: GET
        description: Microsoft Graph List agreementFileLocalizations
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: $orderby
          in: query
          type: array
          description: Order items by property values
        - name: $select
          in: query
          type: array
          description: Select properties to be returned
        - name: $expand
          in: query
          type: array
          description: Expand related entities
      - name: agreementsfilecreatelocalizations
        method: POST
        description: Microsoft Graph Create new navigation property to localizations for agreements
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: agreements-agreement-id-file-localizations-$count
      path: /agreements/{agreement-id}/file/localizations/$count
      operations:
      - name: agreementsfilelocalizationsgetcount37c2
        method: GET
        description: Microsoft Graph Get the number of the resource
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: agreements-agreement-id-file-localizations-agreementFileLocalization-id
      path: /agreements/{agreement-id}/file/localizations/{agreementFileLocalization-id}
      operations:
      - name: agreementsfilegetlocalizations
        method: GET
        description: Microsoft Graph Get localizations from agreements
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: $select
          in: query
          type: array
          description: Select properties to be returned
        - name: $expand
          in: query
          type: array
          description: Expand related entities
      - name: agreementsfileupdatelocalizations
        method: PATCH
        description: Microsoft Graph Update the navigation property localizations in agreements
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: agreementsfiledeletelocalizations
        method: DELETE
        description: Microsoft Graph Delete navigation property localizations for agreements
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: If-Match
          in: header
          type: string
          description: ETag
    - name: agreements-agreement-id-file-localizations-agreementFileLocalization-id-versions
      path: /agreements/{agreement-id}/file/localizations/{agreementFileLocalization-id}/versions
      operations:
      - name: agreementsfilelocalizationslistversions
        method: GET
        description: Microsoft Graph Get versions from agreements
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: $orderby
          in: query
          type: array
          description: Order items by property values
        - name: $select
          in: query
          type: array
          description: Select properties to be returned
        - name: $expand
          in: query
          type: array
          description: Expand related entities
      - name: agreementsfilelocalizationscreateversions
        method: POST
        description: Microsoft Graph Create new navigation property to versions for agreements
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: agreements-agreement-id-file-localizations-agreementFileLocalization-id-versions
      path: /agreements/{agreement-id}/file/localizations/{agreementFileLocalization-id}/versions/$count
      operations:
      - name: agreementsfilelocalizationsversionsgetcountc405
        method: GET
        description: Microsoft Graph Get the number of the resource
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: agreements-agreement-id-file-localizations-agreementFileLocalization-id-versions
      path: /agreements/{agreement-id}/file/localizations/{agreementFileLocalization-id}/versions/{agreementFileVersion-id}
      operations:
      - name: agreementsfilelocalizationsgetversions
        method: GET
        description: Microsoft Graph Get versions from agreements
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: $select
          in: query
          type: array
          description: Select properties to be returned
        - name: $expand
          in: query
          type: array
          description: Expand related entities
      - name: agreementsfilelocalizationsupdateversions
        method: PATCH
        description: Microsoft Graph Update the navigation property versions in agreements
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: agreementsfilelocalizationsdeleteversions
        method: DELETE
        description: Microsoft Graph Delete navigation property versions for agreements
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: If-Match
          in: header
          type: string
          description: ETag
  exposes:
  - type: rest
    namespace: microsoft-graph-agreements-agreementfile-rest
    port: 8080
    description: REST adapter for Microsoft Graph OData Service for namespace microsoft.graph — agreements.agreementFile.
      One Spectral-compliant resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/agreements/{agreement-id}/file
      name: agreements-agreement-id-file
      description: REST surface for agreements-agreement-id-file.
      operations:
      - method: GET
        name: agreementsgetfile
        description: Microsoft Graph Get agreementFile
        call: microsoft-graph-agreements-agreementfile.agreementsgetfile
        with:
          $select: rest.$select
          $expand: rest.$expand
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: agreementsupdatefile
        description: Microsoft Graph Update the navigation property file in agreements
        call: microsoft-graph-agreements-agreementfile.agreementsupdatefile
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: agreementsdeletefile
        description: Microsoft Graph Delete navigation property file for agreements
        call: microsoft-graph-agreements-agreementfile.agreementsdeletefile
        with:
          If-Match: rest.If-Match
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/agreements/{agreement-id}/file/localizations
      name: agreements-agreement-id-file-localizations
      description: REST surface for agreements-agreement-id-file-localizations.
      operations:
      - method: GET
        name: agreementsfilelistlocalizations
        description: Microsoft Graph List agreementFileLocalizations
        call: microsoft-graph-agreements-agreementfile.agreementsfilelistlocalizations
        with:
          $orderby: rest.$orderby
          $select: rest.$select
          $expand: rest.$expand
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: agreementsfilecreatelocalizations
        description: Microsoft Graph Create new navigation property to localizations for agreements
        call: microsoft-graph-agreements-agreementfile.agreementsfilecreatelocalizations
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/agreements/{agreement-id}/file/localizations/count
      name: agreements-agreement-id-file-localizations-count
      description: REST surface for agreements-agreement-id-file-localizations-$count.
      operations:
      - method: GET
        name: agreementsfilelocalizationsgetcount37c2
        description: Microsoft Graph Get the number of the resource
        call: microsoft-graph-agreements-agreementfile.agreementsfilelocalizationsgetcount37c2
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/agreements/{agreement-id}/file/localizations/{agreementfilelocalization-id}
      name: agreements-agreement-id-file-localizations-agreementfilelocalization-id
      description: REST surface for agreements-agreement-id-file-localizations-agreementFileLocalization-id.
      operations:
      - method: GET
        name: agreementsfilegetlocalizations
        description: Microsoft Graph Get localizations from agreements
        call: microsoft-graph-agreements-agreementfile.agreementsfilegetlocalizations
        with:
          $select: rest.$select
          $expand: rest.$expand
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: agreementsfileupdatelocalizations
        description: Microsoft Graph Update the navigation property localizations in agreements
        call: microsoft-graph-agreements-agreementfile.agreementsfileupdatelocalizations
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: agreementsfiledeletelocalizations
        description: Microsoft Graph Delete navigation property localizations for agreements
        call: microsoft-graph-agreements-agreementfile.agreementsfiledeletelocalizations
        with:
          If-Match: rest.If-Match
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/agreements/{agreement-id}/file/localizations/{agreementfilelocalization-id}/versions
      name: agreements-agreement-id-file-localizations-agreementfilelocalization-id-versions
      description: REST surface for agreements-agreement-id-file-localizations-agreementFileLocalization-id-versions.
      operations:
      - method: GET
        name: agreementsfilelocalizationslistversions
        description: Microsoft Graph Get versions from agreements
        call: microsoft-graph-agreements-agreementfile.agreementsfilelocalizationslistversions
        with:
          $orderby: rest.$orderby
          $select: rest.$select
          $expand: rest.$expand
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: agreementsfilelocalizationscreateversions
        description: Microsoft Graph Create new navigation property to versions for agreements
        call: microsoft-graph-agreements-agreementfile.agreementsfilelocalizationscreateversions
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/agreements/{agreement-id}/file/localizations/{agreementfilelocalization-id}/versions/count
      name: agreements-agreement-id-file-localizations-agreementfilelocalization-id-versions
      description: REST surface for agreements-agreement-id-file-localizations-agreementFileLocalization-id-versions.
      operations:
      - method: GET
        name: agreementsfilelocalizationsversionsgetcountc405
        description: Microsoft Graph Get the number of the resource
        call: microsoft-graph-agreements-agreementfile.agreementsfilelocalizationsversionsgetcountc405
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/agreements/{agreement-id}/file/localizations/{agreementfilelocalization-id}/versions/{agreementfileversion-id}
      name: agreements-agreement-id-file-localizations-agreementfilelocalization-id-versions
      description: REST surface for agreements-agreement-id-file-localizations-agreementFileLocalization-id-versions.
      operations:
      - method: GET
        name: agreementsfilelocalizationsgetversions
        description: Microsoft Graph Get versions from agreements
        call: microsoft-graph-agreements-agreementfile.agreementsfilelocalizationsgetversions
        with:
          $select: rest.$select
          $expand: rest.$expand
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: agreementsfilelocalizationsupdateversions
        description: Microsoft Graph Update the navigation property versions in agreements
        call: microsoft-graph-agreements-agreementfile.agreementsfilelocalizationsupdateversions
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: agreementsfilelocalizationsdeleteversions
        description: Microsoft Graph Delete navigation property versions for agreements
        call: microsoft-graph-agreements-agreementfile.agreementsfilelocalizationsdeleteversions
        with:
          If-Match: rest.If-Match
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: microsoft-graph-agreements-agreementfile-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Graph OData Service for namespace microsoft.graph — agreements.agreementFile. One
      tool per consumed operation, routed inline through this capability's consumes block.
    tools:
    - name: microsoft-graph-get-agreementfile
      description: Microsoft Graph Get agreementFile
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-graph-agreements-agreementfile.agreementsgetfile
      with:
        $select: tools.$select
        $expand: tools.$expand
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-update-navigation-property
      description: Microsoft Graph Update the navigation property file in agreements
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: microsoft-graph-agreements-agreementfile.agreementsupdatefile
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-delete-navigation-property
      description: Microsoft Graph Delete navigation property file for agreements
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: microsoft-graph-agreements-agreementfile.agreementsdeletefile
      with:
        If-Match: tools.If-Match
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-list-agreementfilelocalizations
      description: Microsoft Graph List agreementFileLocalizations
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-graph-agreements-agreementfile.agreementsfilelistlocalizations
      with:
        $orderby: tools.$orderby
        $select: tools.$select
        $expand: tools.$expand
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-create-new-navigation
      description: Microsoft Graph Create new navigation property to localizations for agreements
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoft-graph-agreements-agreementfile.agreementsfilecreatelocalizations
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-get-number-resource
      description: Microsoft Graph Get the number of the resource
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-graph-agreements-agreementfile.agreementsfilelocalizationsgetcount37c2
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-get-localizations-agreements
      description: Microsoft Graph Get localizations from agreements
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-graph-agreements-agreementfile.agreementsfilegetlocalizations
      with:
        $select: tools.$select
        $expand: tools.$expand
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-update-navigation-property-2
      description: Microsoft Graph Update the navigation property localizations in agreements
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: microsoft-graph-agreements-agreementfile.agreementsfileupdatelocalizations
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-delete-navigation-property-2
      description: Microsoft Graph Delete navigation property localizations for agreements
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: microsoft-graph-agreements-agreementfile.agreementsfiledeletelocalizations
      with:
        If-Match: tools.If-Match
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-get-versions-agreements
      description: Microsoft Graph Get versions from agreements
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-graph-agreements-agreementfile.agreementsfilelocalizationslistversions
      with:
        $orderby: tools.$orderby
        $select: tools.$select
        $expand: tools.$expand
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-create-new-navigation-2
      description: Microsoft Graph Create new navigation property to versions for agreements
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoft-graph-agreements-agreementfile.agreementsfilelocalizationscreateversions
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-get-number-resource-2
      description: Microsoft Graph Get the number of the resource
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-graph-agreements-agreementfile.agreementsfilelocalizationsversionsgetcountc405
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-get-versions-agreements-2
      description: Microsoft Graph Get versions from agreements
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-graph-agreements-agreementfile.agreementsfilelocalizationsgetversions
      with:
        $select: tools.$select
        $expand: tools.$expand
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-update-navigation-property-3
      description: Microsoft Graph Update the navigation property versions in agreements
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: microsoft-graph-agreements-agreementfile.agreementsfilelocalizationsupdateversions
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-delete-navigation-property-3
      description: Microsoft Graph Delete navigation property versions for agreements
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: microsoft-graph-agreements-agreementfile.agreementsfilelocalizationsdeleteversions
      with:
        If-Match: tools.If-Match
      outputParameters:
      - type: object
        mapping: $.