Microsoft Graph Admin API

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Graph Admin API
  description: Microsoft Graph API for managing administrative resources in Microsoft Entra ID. This API enables administrators
    to manage Microsoft Edge browser settings, Internet Explorer mode configurations, site lists, shared browser sites, Microsoft
    365 Apps installation options, people insights, service announcements, SharePoint settings, Copilot administration, directory
    administrative units, and admin consent policies.
  tags:
  - Microsoft
  - Graph
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: microsoft-graph
    baseUri: https://graph.microsoft.com/v1.0
    description: Microsoft Graph Admin API HTTP API.
    resources:
    - name: admin
      path: /admin
      operations:
      - name: getadmin
        method: GET
        description: Microsoft Graph Get admin singleton
        inputParameters:
        - name: $select
          in: query
          type: array
          description: Select properties to be returned
        - name: $expand
          in: query
          type: array
          description: Expand related entities
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateadmin
        method: PATCH
        description: Microsoft Graph Update admin singleton
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-edge
      path: /admin/edge
      operations:
      - name: getadminedge
        method: GET
        description: Microsoft Graph Get Edge settings
        inputParameters:
        - name: $select
          in: query
          type: array
          description: Select properties to be returned
        - name: $expand
          in: query
          type: array
          description: Expand related entities
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateadminedge
        method: PATCH
        description: Microsoft Graph Update Edge settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteadminedge
        method: DELETE
        description: Microsoft Graph Delete Edge settings
        inputParameters:
        - name: If-Match
          in: header
          type: string
          description: ETag for optimistic concurrency control
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-edge-internetexplorermode
      path: /admin/edge/internetExplorerMode
      operations:
      - name: getedgeinternetexplorermode
        method: GET
        description: Microsoft Graph Get Internet Explorer mode settings
        inputParameters:
        - name: $select
          in: query
          type: array
          description: Select properties to be returned
        - name: $expand
          in: query
          type: array
          description: Expand related entities
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateedgeinternetexplorermode
        method: PATCH
        description: Microsoft Graph Update Internet Explorer mode settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteedgeinternetexplorermode
        method: DELETE
        description: Microsoft Graph Delete Internet Explorer mode settings
        inputParameters:
        - name: If-Match
          in: header
          type: string
          description: ETag for optimistic concurrency control
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-edge-internetexplorermode-sitelists
      path: /admin/edge/internetExplorerMode/siteLists
      operations:
      - name: listbrowsersitelists
        method: GET
        description: Microsoft Graph List browser site lists
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createbrowsersitelist
        method: POST
        description: Microsoft Graph Create browser site list
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-edge-internetexplorermode-sitelists-browse
      path: /admin/edge/internetExplorerMode/siteLists/{browserSiteList-id}
      operations:
      - name: getbrowsersitelist
        method: GET
        description: Microsoft Graph Get browser site list
        inputParameters:
        - name: $select
          in: query
          type: array
          description: Select properties to be returned
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updatebrowsersitelist
        method: PATCH
        description: Microsoft Graph Update browser site list
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deletebrowsersitelist
        method: DELETE
        description: Microsoft Graph Delete browser site list
        inputParameters:
        - name: If-Match
          in: header
          type: string
          description: ETag
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-microsoft365apps
      path: /admin/microsoft365Apps
      operations:
      - name: getmicrosoft365apps
        method: GET
        description: Microsoft Graph Get Microsoft 365 Apps settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updatemicrosoft365apps
        method: PATCH
        description: Microsoft Graph Update Microsoft 365 Apps settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-reportsettings
      path: /admin/reportSettings
      operations:
      - name: getreportsettings
        method: GET
        description: Microsoft Graph Get report settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updatereportsettings
        method: PATCH
        description: Microsoft Graph Update report settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-serviceannouncement
      path: /admin/serviceAnnouncement
      operations:
      - name: getserviceannouncement
        method: GET
        description: Microsoft Graph Get service announcement
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-sharepoint
      path: /admin/sharepoint
      operations:
      - name: getsharepointsettings
        method: GET
        description: Microsoft Graph Get SharePoint settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updatesharepointsettings
        method: PATCH
        description: Microsoft Graph Update SharePoint settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: copilot-admin
      path: /copilot/admin
      operations:
      - name: getcopilotadmin
        method: GET
        description: Microsoft Graph Get Copilot admin settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: directory-administrativeunits
      path: /directory/administrativeUnits
      operations:
      - name: listadministrativeunits
        method: GET
        description: Microsoft Graph List administrative units
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createadministrativeunit
        method: POST
        description: Microsoft Graph Create administrative unit
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: directory-administrativeunits-administrativeunit
      path: /directory/administrativeUnits/{administrativeUnit-id}
      operations:
      - name: getadministrativeunit
        method: GET
        description: Microsoft Graph Get administrative unit
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateadministrativeunit
        method: PATCH
        description: Microsoft Graph Update administrative unit
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteadministrativeunit
        method: DELETE
        description: Microsoft Graph Delete administrative unit
        inputParameters:
        - name: If-Match
          in: header
          type: string
          description: ETag
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: policies-adminconsentrequestpolicy
      path: /policies/adminConsentRequestPolicy
      operations:
      - name: getadminconsentrequestpolicy
        method: GET
        description: Microsoft Graph Get admin consent request policy
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateadminconsentrequestpolicy
        method: PATCH
        description: Microsoft Graph Update admin consent request policy
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: microsoft-graph-rest
    description: REST adapter for Microsoft Graph Admin API.
    resources:
    - path: /admin
      name: getadmin
      operations:
      - method: GET
        name: getadmin
        description: Microsoft Graph Get admin singleton
        call: microsoft-graph.getadmin
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin
      name: updateadmin
      operations:
      - method: PATCH
        name: updateadmin
        description: Microsoft Graph Update admin singleton
        call: microsoft-graph.updateadmin
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/edge
      name: getadminedge
      operations:
      - method: GET
        name: getadminedge
        description: Microsoft Graph Get Edge settings
        call: microsoft-graph.getadminedge
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/edge
      name: updateadminedge
      operations:
      - method: PATCH
        name: updateadminedge
        description: Microsoft Graph Update Edge settings
        call: microsoft-graph.updateadminedge
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/edge
      name: deleteadminedge
      operations:
      - method: DELETE
        name: deleteadminedge
        description: Microsoft Graph Delete Edge settings
        call: microsoft-graph.deleteadminedge
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/edge/internetExplorerMode
      name: getedgeinternetexplorermode
      operations:
      - method: GET
        name: getedgeinternetexplorermode
        description: Microsoft Graph Get Internet Explorer mode settings
        call: microsoft-graph.getedgeinternetexplorermode
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/edge/internetExplorerMode
      name: updateedgeinternetexplorermode
      operations:
      - method: PATCH
        name: updateedgeinternetexplorermode
        description: Microsoft Graph Update Internet Explorer mode settings
        call: microsoft-graph.updateedgeinternetexplorermode
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/edge/internetExplorerMode
      name: deleteedgeinternetexplorermode
      operations:
      - method: DELETE
        name: deleteedgeinternetexplorermode
        description: Microsoft Graph Delete Internet Explorer mode settings
        call: microsoft-graph.deleteedgeinternetexplorermode
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/edge/internetExplorerMode/siteLists
      name: listbrowsersitelists
      operations:
      - method: GET
        name: listbrowsersitelists
        description: Microsoft Graph List browser site lists
        call: microsoft-graph.listbrowsersitelists
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/edge/internetExplorerMode/siteLists
      name: createbrowsersitelist
      operations:
      - method: POST
        name: createbrowsersitelist
        description: Microsoft Graph Create browser site list
        call: microsoft-graph.createbrowsersitelist
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/edge/internetExplorerMode/siteLists/{browserSiteList-id}
      name: getbrowsersitelist
      operations:
      - method: GET
        name: getbrowsersitelist
        description: Microsoft Graph Get browser site list
        call: microsoft-graph.getbrowsersitelist
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/edge/internetExplorerMode/siteLists/{browserSiteList-id}
      name: updatebrowsersitelist
      operations:
      - method: PATCH
        name: updatebrowsersitelist
        description: Microsoft Graph Update browser site list
        call: microsoft-graph.updatebrowsersitelist
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/edge/internetExplorerMode/siteLists/{browserSiteList-id}
      name: deletebrowsersitelist
      operations:
      - method: DELETE
        name: deletebrowsersitelist
        description: Microsoft Graph Delete browser site list
        call: microsoft-graph.deletebrowsersitelist
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/microsoft365Apps
      name: getmicrosoft365apps
      operations:
      - method: GET
        name: getmicrosoft365apps
        description: Microsoft Graph Get Microsoft 365 Apps settings
        call: microsoft-graph.getmicrosoft365apps
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/microsoft365Apps
      name: updatemicrosoft365apps
      operations:
      - method: PATCH
        name: updatemicrosoft365apps
        description: Microsoft Graph Update Microsoft 365 Apps settings
        call: microsoft-graph.updatemicrosoft365apps
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/reportSettings
      name: getreportsettings
      operations:
      - method: GET
        name: getreportsettings
        description: Microsoft Graph Get report settings
        call: microsoft-graph.getreportsettings
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/reportSettings
      name: updatereportsettings
      operations:
      - method: PATCH
        name: updatereportsettings
        description: Microsoft Graph Update report settings
        call: microsoft-graph.updatereportsettings
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/serviceAnnouncement
      name: getserviceannouncement
      operations:
      - method: GET
        name: getserviceannouncement
        description: Microsoft Graph Get service announcement
        call: microsoft-graph.getserviceannouncement
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/sharepoint
      name: getsharepointsettings
      operations:
      - method: GET
        name: getsharepointsettings
        description: Microsoft Graph Get SharePoint settings
        call: microsoft-graph.getsharepointsettings
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/sharepoint
      name: updatesharepointsettings
      operations:
      - method: PATCH
        name: updatesharepointsettings
        description: Microsoft Graph Update SharePoint settings
        call: microsoft-graph.updatesharepointsettings
        outputParameters:
        - type: object
          mapping: $.
    - path: /copilot/admin
      name: getcopilotadmin
      operations:
      - method: GET
        name: getcopilotadmin
        description: Microsoft Graph Get Copilot admin settings
        call: microsoft-graph.getcopilotadmin
        outputParameters:
        - type: object
          mapping: $.
    - path: /directory/administrativeUnits
      name: listadministrativeunits
      operations:
      - method: GET
        name: listadministrativeunits
        description: Microsoft Graph List administrative units
        call: microsoft-graph.listadministrativeunits
        outputParameters:
        - type: object
          mapping: $.
    - path: /directory/administrativeUnits
      name: createadministrativeunit
      operations:
      - method: POST
        name: createadministrativeunit
        description: Microsoft Graph Create administrative unit
        call: microsoft-graph.createadministrativeunit
        outputParameters:
        - type: object
          mapping: $.
    - path: /directory/administrativeUnits/{administrativeUnit-id}
      name: getadministrativeunit
      operations:
      - method: GET
        name: getadministrativeunit
        description: Microsoft Graph Get administrative unit
        call: microsoft-graph.getadministrativeunit
        outputParameters:
        - type: object
          mapping: $.
    - path: /directory/administrativeUnits/{administrativeUnit-id}
      name: updateadministrativeunit
      operations:
      - method: PATCH
        name: updateadministrativeunit
        description: Microsoft Graph Update administrative unit
        call: microsoft-graph.updateadministrativeunit
        outputParameters:
        - type: object
          mapping: $.
    - path: /directory/administrativeUnits/{administrativeUnit-id}
      name: deleteadministrativeunit
      operations:
      - method: DELETE
        name: deleteadministrativeunit
        description: Microsoft Graph Delete administrative unit
        call: microsoft-graph.deleteadministrativeunit
        outputParameters:
        - type: object
          mapping: $.
    - path: /policies/adminConsentRequestPolicy
      name: getadminconsentrequestpolicy
      operations:
      - method: GET
        name: getadminconsentrequestpolicy
        description: Microsoft Graph Get admin consent request policy
        call: microsoft-graph.getadminconsentrequestpolicy
        outputParameters:
        - type: object
          mapping: $.
    - path: /policies/adminConsentRequestPolicy
      name: updateadminconsentrequestpolicy
      operations:
      - method: PATCH
        name: updateadminconsentrequestpolicy
        description: Microsoft Graph Update admin consent request policy
        call: microsoft-graph.updateadminconsentrequestpolicy
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: microsoft-graph-mcp
    transport: http
    description: MCP adapter for Microsoft Graph Admin API for AI agent use.
    tools:
    - name: getadmin
      description: Microsoft Graph Get admin singleton
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-graph.getadmin
      with:
        $select: tools.$select
        $expand: tools.$expand
      inputParameters:
      - name: $select
        type: array
        description: Select properties to be returned
      - name: $expand
        type: array
        description: Expand related entities
      outputParameters:
      - type: object
        mapping: $.
    - name: updateadmin
      description: Microsoft Graph Update admin singleton
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoft-graph.updateadmin
      outputParameters:
      - type: object
        mapping: $.
    - name: getadminedge
      description: Microsoft Graph Get Edge settings
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-graph.getadminedge
      with:
        $select: tools.$select
        $expand: tools.$expand
      inputParameters:
      - name: $select
        type: array
        description: Select properties to be returned
      - name: $expand
        type: array
        description: Expand related entities
      outputParameters:
      - type: object
        mapping: $.
    - name: updateadminedge
      description: Microsoft Graph Update Edge settings
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoft-graph.updateadminedge
      outputParameters:
      - type: object
        mapping: $.
    - name: deleteadminedge
      description: Microsoft Graph Delete Edge settings
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: microsoft-graph.deleteadminedge
      outputParameters:
      - type: object
        mapping: $.
    - name: getedgeinternetexplorermode
      description: Microsoft Graph Get Internet Explorer mode settings
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-graph.getedgeinternetexplorermode
      with:
        $select: tools.$select
        $expand: tools.$expand
      inputParameters:
      - name: $select
        type: array
        description: Select properties to be returned
      - name: $expand
        type: array
        description: Expand related entities
      outputParameters:
      - type: object
        mapping: $.
    - name: updateedgeinternetexplorermode
      description: Microsoft Graph Update Internet Explorer mode settings
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoft-graph.updateedgeinternetexplorermode
      outputParameters:
      - type: object
        mapping: $.
    - name: deleteedgeinternetexplorermode
      description: Microsoft Graph Delete Internet Explorer mode settings
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: microsoft-graph.deleteedgeinternetexplorermode
      outputParameters:
      - type: object
        mapping: $.
    - name: listbrowsersitelists
      description: Microsoft Graph List browser site lists
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-graph.listbrowsersitelists
      outputParameters:
      - type: object
        mapping: $.
    - name: createbrowsersitelist
      description: Microsoft Graph Create browser site list
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoft-graph.createbrowsersitelist
      outputParameters:
      - type: object
        mapping: $.
    - name: getbrowsersitelist
      description: Microsoft Graph Get browser site list
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-graph.getbrowsersitelist
      with:
        $select: tools.$select
      inputParameters:
      - name: $select
        type: array
        description: Select properties to be returned
      outputParameters:
      - type: object
        mapping: $.
    - name: updatebrowsersitelist
      description: Microsoft Graph Update browser site list
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoft-graph.updatebrowsersitelist
      outputParameters:
      - type: object
        mapping: $.
    - name: deletebrowsersitelist
      description: Microsoft Graph Delete browser site list
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: microsoft-graph.deletebrowsersitelist
      outputParameters:
      - type: object
        mapping: $.
    - name: getmicrosoft365apps
      description: Microsoft Graph Get Microsoft 365 Apps settings
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-graph.getmicrosoft365apps
      outputParameters:
      - type: object
        mapping: $.
    - name: updatemicrosoft365apps
      description: Microsoft Graph Update Microsoft 365 Apps settings
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoft-graph.updatemicrosoft365apps
      outputParameters:
      - type: object
        mapping: $.
    - name: getreportsettings
      description: Microsoft Graph Get report settings
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-graph.getreportsettings
      outputParameters:
      - type: object
        mapping: $.
    - name: updatereportsettings
      description: Microsoft Graph Update report settings
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoft-graph.updatereportsettings
      outputParameters:
      - type: object
        mapping: $.
    - name: getserviceannouncement
      description: Microsoft Graph Get service announcement
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-graph.getserviceannouncement
      outputParameters:
      - type: object
        mapping: $.
    - name: getsharepointsettings
      description: Microsoft Graph Get SharePoint settings
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-graph.getsharepointsettings
      outputParameters:
      - type: object
        mapping: $.
    - name: updatesharepointsettings
      description: Microsoft Graph Update SharePoint settings
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoft-graph.updatesharepointsettings
      outputParameters:
      - type: object
        mapping: $.
    - name: getcopilotadmin
      description: Microsoft Graph Get Copilot admin settings
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-graph.getcopilotadmin
      outputParameters:
      - type: object
        mapping: $.
    - name: listadministrativeunits
      description: Microsoft Graph List administrative units
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-graph.listadministrativeunits
      outputParameters:
      - type: object
        mapping: $.
    - name: createadministrativeunit
      description: Microsoft Graph Create administrative unit
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoft-graph.createadministrativeunit
      outputParameters:
      - type: object
        mapping: $.
    - name: getadministrativeunit
      description: Microsoft Graph Get administrative unit
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-graph.getadministrativeunit
      outputParameters:
      - type: object
        mapping: $.
    - name: updateadministrativeunit
      description: Microsoft Graph Update administrative unit
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoft-graph.updateadministrativeunit
      outputParameters:
      - type: object
        mapping: $.
    - name: deleteadministrativeunit
      description: Microsoft Graph Delete administrative unit
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: microsoft-graph.deleteadministrativeunit
      outputParameters:
      - type: object
        mapping: $.
    - name: getadminconsentrequestpolicy
      description: Microsoft Graph Get admin consent request policy
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-graph.getadminconsentrequestpolicy
      outputParameters:
      - type: object
        mapping: $.
    - name: updateadminconsentrequestpolicy
      description: Microsoft Graph Update admin consent request policy
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoft-graph.updateadminconsentrequestpolicy
      outputParameters:
      - type: object
        mapping: $.