Microsoft Graph

Microsoft Graph Subscriptions

Microsoft Graph Subscriptions let your app receive near real-time change notifications (webhooks) when Microsoft 365 data changes—such as Outlook mail and calendar items, users and groups, files in OneDrive/SharePoint, or Teams chats and channels. You register a subscription that specifies the resource to watch and a publicly reachable HTTPS endpoint; Microsoft Graph validates the endpoint and then posts notifications whenever relevant items are created, updated, or deleted.

GitHub OpenAPI

Documentation

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

Specifications

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

OpenAPI Specification

subscriptions-openapi-original.yml Raw ↑ 
openapi: 3.1.0
info:
  title: Microsoft Graph Subscriptions
  description: Needs a description.
paths:
  /directory/subscriptions:
    description: >-
      Provides operations to manage the subscriptions property of the
      microsoft.graph.directory entity.
    get:
      tags:
        - directory.companySubscription
      summary: Microsoft Graph List subscriptions
      description: Get the list of commercial subscriptions that an organization acquired.
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/directory-list-subscriptions?view=graph-rest-1.0
      operationId: directory.ListSubscriptions
      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/microsoft.graph.companySubscriptionCollectionResponse
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
      x-ms-docs-operation-type: operation
    post:
      tags:
        - directory.companySubscription
      summary: Microsoft Graph Create new navigation property to subscriptions for directory
      operationId: directory.CreateSubscriptions
      requestBody:
        description: New navigation property
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.companySubscription'
        required: true
      responses:
        2XX:
          description: Created navigation property.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.companySubscription'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /directory/subscriptions/{companySubscription-id}:
    description: >-
      Provides operations to manage the subscriptions property of the
      microsoft.graph.directory entity.
    get:
      tags:
        - directory.companySubscription
      summary: Microsoft Graph Get companySubscription
      description: Get a specific commercial subscription that an organization acquired.
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/companysubscription-get?view=graph-rest-1.0
      operationId: directory.GetSubscriptions
      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/microsoft.graph.companySubscription'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
        - directory.companySubscription
      summary: Microsoft Graph Update the navigation property subscriptions in directory
      operationId: directory.UpdateSubscriptions
      requestBody:
        description: New navigation property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.companySubscription'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.companySubscription'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
        - directory.companySubscription
      summary: Microsoft Graph Delete navigation property subscriptions for directory
      operationId: directory.DeleteSubscriptions
      parameters:
        - name: If-Match
          in: header
          description: ETag
          schema:
            type: string
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    parameters:
      - name: companySubscription-id
        in: path
        description: The unique identifier of companySubscription
        required: true
        schema:
          type: string
        x-ms-docs-key-type: companySubscription
    x-ms-docs-grouped-path:
      - >-
        /directory/subscriptions(commerceSubscriptionId='{commerceSubscriptionId}')
  /directory/subscriptions(commerceSubscriptionId='{commerceSubscriptionId}'):
    description: >-
      Provides operations to manage the subscriptions property of the
      microsoft.graph.directory entity.
    get:
      tags:
        - directory.companySubscription
      summary: Microsoft Graph Get companySubscription
      description: Get a specific commercial subscription that an organization acquired.
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/companysubscription-get?view=graph-rest-1.0
      operationId: directory.subscriptions.GetByCommerceSubscriptionId
      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/microsoft.graph.companySubscription'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
        - directory.companySubscription
      summary: Microsoft Graph Update the navigation property subscriptions in directory
      operationId: directory.subscriptions.UpdateByCommerceSubscriptionId
      requestBody:
        description: New navigation property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.companySubscription'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.companySubscription'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
        - directory.companySubscription
      summary: Microsoft Graph Delete navigation property subscriptions for directory
      operationId: directory.subscriptions.DeleteByCommerceSubscriptionId
      parameters:
        - name: If-Match
          in: header
          description: ETag
          schema:
            type: string
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    parameters:
      - name: commerceSubscriptionId
        in: path
        description: Alternate key of companySubscription
        required: true
        schema:
          type: string
          nullable: true
    x-ms-docs-grouped-path:
      - /directory/subscriptions/{companySubscription-id}
  /directory/subscriptions/$count:
    description: Provides operations to count the resources in the collection.
    get:
      tags:
        - directory.companySubscription
      summary: Microsoft Graph Get the number of the resource
      operationId: directory.subscriptions.GetCount-06e4
      parameters:
        - $ref: '#/components/parameters/search'
        - $ref: '#/components/parameters/filter'
      responses:
        2XX:
          $ref: '#/components/responses/ODataCountResponse'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
  /drives/{drive-id}/items/{driveItem-id}/subscriptions:
    description: >-
      Provides operations to manage the subscriptions property of the
      microsoft.graph.driveItem entity.
    get:
      tags:
        - drives.driveItem
      summary: Microsoft Graph Get subscriptions from drives
      description: >-
        The set of subscriptions on the item. Only supported on the root of a
        drive.
      operationId: drives.items.ListSubscriptions
      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/microsoft.graph.subscriptionCollectionResponse
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
      x-ms-docs-operation-type: operation
    post:
      tags:
        - drives.driveItem
      summary: Microsoft Graph Create new navigation property to subscriptions for drives
      operationId: drives.items.CreateSubscriptions
      requestBody:
        description: New navigation property
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.subscription'
        required: true
      responses:
        2XX:
          description: Created navigation property.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.subscription'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    parameters:
      - name: drive-id
        in: path
        description: The unique identifier of drive
        required: true
        schema:
          type: string
        x-ms-docs-key-type: drive
      - name: driveItem-id
        in: path
        description: The unique identifier of driveItem
        required: true
        schema:
          type: string
        x-ms-docs-key-type: driveItem
  /drives/{drive-id}/items/{driveItem-id}/subscriptions/{subscription-id}:
    description: >-
      Provides operations to manage the subscriptions property of the
      microsoft.graph.driveItem entity.
    get:
      tags:
        - drives.driveItem
      summary: Microsoft Graph Get subscriptions from drives
      description: >-
        The set of subscriptions on the item. Only supported on the root of a
        drive.
      operationId: drives.items.GetSubscriptions
      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/microsoft.graph.subscription'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
        - drives.driveItem
      summary: Microsoft Graph Update the navigation property subscriptions in drives
      operationId: drives.items.UpdateSubscriptions
      requestBody:
        description: New navigation property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.subscription'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.subscription'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
        - drives.driveItem
      summary: Microsoft Graph Delete navigation property subscriptions for drives
      operationId: drives.items.DeleteSubscriptions
      parameters:
        - name: If-Match
          in: header
          description: ETag
          schema:
            type: string
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    parameters:
      - name: drive-id
        in: path
        description: The unique identifier of drive
        required: true
        schema:
          type: string
        x-ms-docs-key-type: drive
      - name: driveItem-id
        in: path
        description: The unique identifier of driveItem
        required: true
        schema:
          type: string
        x-ms-docs-key-type: driveItem
      - name: subscription-id
        in: path
        description: The unique identifier of subscription
        required: true
        schema:
          type: string
        x-ms-docs-key-type: subscription
  /drives/{drive-id}/items/{driveItem-id}/subscriptions/{subscription-id}/reauthorize:
    description: Provides operations to call the reauthorize method.
    post:
      tags:
        - drives.driveItem
      summary: Microsoft Graph Invoke action reauthorize
      description: >-
        Reauthorize a subscription when you receive a reauthorizationRequired
        challenge.
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/subscription-reauthorize?view=graph-rest-1.0
      operationId: drives.drive.items.driveItem.subscriptions.subscription.reauthorize
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: action
    parameters:
      - name: drive-id
        in: path
        description: The unique identifier of drive
        required: true
        schema:
          type: string
        x-ms-docs-key-type: drive
      - name: driveItem-id
        in: path
        description: The unique identifier of driveItem
        required: true
        schema:
          type: string
        x-ms-docs-key-type: driveItem
      - name: subscription-id
        in: path
        description: The unique identifier of subscription
        required: true
        schema:
          type: string
        x-ms-docs-key-type: subscription
    x-ms-docs-grouped-path:
      - /drives/{drive-id}/list/subscriptions/{subscription-id}/reauthorize
  /drives/{drive-id}/items/{driveItem-id}/subscriptions/$count:
    description: Provides operations to count the resources in the collection.
    get:
      tags:
        - drives.driveItem
      summary: Microsoft Graph Get the number of the resource
      operationId: drives.items.subscriptions.GetCount-f848
      parameters:
        - $ref: '#/components/parameters/search'
        - $ref: '#/components/parameters/filter'
      responses:
        2XX:
          $ref: '#/components/responses/ODataCountResponse'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
    parameters:
      - name: drive-id
        in: path
        description: The unique identifier of drive
        required: true
        schema:
          type: string
        x-ms-docs-key-type: drive
      - name: driveItem-id
        in: path
        description: The unique identifier of driveItem
        required: true
        schema:
          type: string
        x-ms-docs-key-type: driveItem
  /drives/{drive-id}/list/subscriptions:
    description: >-
      Provides operations to manage the subscriptions property of the
      microsoft.graph.list entity.
    get:
      tags:
        - Drives.list
      summary: Microsoft Graph Get subscriptions from drives
      description: The set of subscriptions on the list.
      operationId: drives.list.ListSubscriptions
      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/microsoft.graph.subscriptionCollectionResponse
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
      x-ms-docs-operation-type: operation
    post:
      tags:
        - Drives.list
      summary: Microsoft Graph Create new navigation property to subscriptions for drives
      operationId: drives.list.CreateSubscriptions
      requestBody:
        description: New navigation property
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.subscription'
        required: true
      responses:
        2XX:
          description: Created navigation property.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.subscription'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    parameters:
      - name: drive-id
        in: path
        description: The unique identifier of drive
        required: true
        schema:
          type: string
        x-ms-docs-key-type: drive
  /drives/{drive-id}/list/subscriptions/{subscription-id}:
    description: >-
      Provides operations to manage the subscriptions property of the
      microsoft.graph.list entity.
    get:
      tags:
        - Drives.list
      summary: Microsoft Graph Get subscriptions from drives
      description: The set of subscriptions on the list.
      operationId: drives.list.GetSubscriptions
      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/microsoft.graph.subscription'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
        - Drives.list
      summary: Microsoft Graph Update the navigation property subscriptions in drives
      operationId: drives.list.UpdateSubscriptions
      requestBody:
        description: New navigation property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.subscription'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.subscription'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
        - Drives.list
      summary: Microsoft Graph Delete navigation property subscriptions for drives
      operationId: drives.list.DeleteSubscriptions
      parameters:
        - name: If-Match
          in: header
          description: ETag
          schema:
            type: string
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    parameters:
      - name: drive-id
        in: path
        description: The unique identifier of drive
        required: true
        schema:
          type: string
        x-ms-docs-key-type: drive
      - name: subscription-id
        in: path
        description: The unique identifier of subscription
        required: true
        schema:
          type: string
        x-ms-docs-key-type: subscription
  /drives/{drive-id}/list/subscriptions/{subscription-id}/reauthorize:
    description: Provides operations to call the reauthorize method.
    post:
      tags:
        - Drives.list
      summary: Microsoft Graph Invoke action reauthorize
      description: >-
        Reauthorize a subscription when you receive a reauthorizationRequired
        challenge.
      externalDocs:
        description: Find more info here
        url: >-
          https://learn.microsoft.com/graph/api/subscription-reauthorize?view=graph-rest-1.0
      operationId: drives.drive.list.subscriptions.subscription.reauthorize
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: action
    parameters:
      - name: drive-id
        in: path
        description: The unique identifier of drive
        required: true
        schema:
          type: string
        x-ms-docs-key-type: drive
      - name: subscription-id
        in: path
        description: The unique identifier of subscription
        required: true
        schema:
          type: string
        x-ms-docs-key-type: subscription
    x-ms-docs-grouped-path:
      - >-
        /drives/{drive-id}/items/{driveItem-id}/subscriptions/{subscription-id}/reauthorize
  /drives/{drive-id}/list/subscriptions/$count:
    description: Provides operations to count the resources in the collection.
    get:
      tags:
        - Drives.list
      summary: Microsoft Graph Get the number of the resource
      operationId: drives.list.subscriptions.GetCount-59f5
      parameters:
        - $ref: '#/components/parameters/search'
        - $ref: '#/components/parameters/filter'
      responses:
        2XX:
          $ref: '#/components/responses/ODataCountResponse'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
    parameters:
      - name: drive-id
        in: path
        description: The unique identifier of drive
        required: true
        schema:
          type: string
        x-ms-docs-key-type: drive
  /groups/{group-id}/sites/{site-id}/lists/{list-id}/subscriptions:
    description: >-
      Provides operations to manage the subscriptions property of the
      microsoft.graph.list entity.
    get:
      tags:
        - Groups.site
      summary: Microsoft Graph Get subscriptions from groups
      description: The set of subscriptions on the list.
      operationId: groups.sites.lists.ListSubscriptions
      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/microsoft.graph.subscriptionCollectionResponse
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
      x-ms-docs-operation-type: operation
    post:
      tags:
        - Groups.site
      summary: Microsoft Graph Create new navigation property to subscriptions for groups
      operationId: groups.sites.lists.CreateSubscriptions
      requestBody:
        description: New navigation property
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.subscription'
        required: true
      responses:
        2XX:
          description: Created navigation property.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.subscription'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    parameters:
      - name: group-id
        in: path
        description: The unique identifier of group
        required: true
        schema:
          type: string
        x-ms-docs-key-type: group
      - name: site-id
        in: path
        description: The unique identifier of site
        required: true
        schema:
          type: string
        x-ms-docs-key-type: site
      - name: list-id
        in: path
        description: The unique identifier of list
        required: true
        schema:
          type: string
        x-ms-docs-key-type: list
  /groups/{group-id}/sites/{site-id}/lists/{list-id}/subscriptions/{subscription-id}:
    description: >-
      Provides operations to manage the subscriptions property of the
      microsoft.graph.list entity.
    get:
      tags:
        - Groups.site
      summary: Microsoft Graph Get subscriptions from groups
      description: The set of subscriptions on the list.
      operationId: groups.sites.lists.GetSubscriptions
      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/microsoft.graph.subscription'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
        - Groups.site
      summary: Microsoft Graph Update the navigation property subscriptions in groups
      operationId: groups.sites.lists.UpdateSubscriptions
      requestBody:
        description: New navigation property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.subscription'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.subscription'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
        - Groups.site
      summary: Microsoft Graph Delete navigation property subscriptions

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