{ "opencollection": "1.0.0", "info": { "name": "Microsoft Graph Admin Admin.admin Subscriptions.subscription API", "version": "1.0.0" }, "items": [ { "info": { "name": "Subscriptions.subscription", "type": "folder" }, "items": [ { "info": { "name": "Microsoft Graph List subscriptions", "type": "http" }, "http": { "method": "GET", "url": "https://graph.microsoft.com/v1.0/subscriptions", "params": [ { "name": "$top", "value": "50", "type": "query", "description": "Show only the first n items" }, { "name": "$skip", "value": "", "type": "query", "description": "Skip the first n items" }, { "name": "$search", "value": "", "type": "query", "description": "Search items by search phrases" }, { "name": "$filter", "value": "", "type": "query", "description": "Filter items by property values" }, { "name": "$count", "value": "", "type": "query", "description": "Include count of items" }, { "name": "$orderby", "value": "", "type": "query", "description": "Order items by property values" }, { "name": "$select", "value": "", "type": "query", "description": "Select properties to be returned" }, { "name": "$expand", "value": "", "type": "query", "description": "Expand related entities" } ] }, "docs": "Retrieve the properties and relationships of webhook subscriptions, based on the app ID, the user, and the user's role with a tenant. The content of the response depends on the context in which the app is calling; for details, see the scenarios in the Permissions section." }, { "info": { "name": "Microsoft Graph Create subscription", "type": "http" }, "http": { "method": "POST", "url": "https://graph.microsoft.com/v1.0/subscriptions", "body": { "type": "json", "data": "{}" } }, "docs": "Subscribes a listener application to receive change notifications when the requested type of changes occur to the specified resource in Microsoft Graph. To identify the resources for which you can create subscriptions and the limitations on subscriptions, see Set up notifications for changes in resource data: Supported resources. Some resources support rich notifications, that is, notifications that include resource data. For more information about these resources, see Set up change notification" }, { "info": { "name": "Microsoft Graph Get subscription", "type": "http" }, "http": { "method": "GET", "url": "https://graph.microsoft.com/v1.0/subscriptions/:subscription-id", "params": [ { "name": "subscription-id", "value": "", "type": "path", "description": "The unique identifier of subscription" }, { "name": "$select", "value": "", "type": "query", "description": "Select properties to be returned" } ] }, "docs": "Retrieve the properties and relationships of a subscription. See the table in the Permissions section for the list of resources that support subscribing to change notifications." }, { "info": { "name": "Microsoft Graph Update subscription", "type": "http" }, "http": { "method": "PATCH", "url": "https://graph.microsoft.com/v1.0/subscriptions/:subscription-id", "params": [ { "name": "subscription-id", "value": "", "type": "path", "description": "The unique identifier of subscription" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Renew a subscription by extending its expiry time. The table in the Permissions section lists the resources that support subscribing to change notifications. Subscriptions expire after a length of time that varies by resource type. In order to avoid missing change notifications, an app should renew its subscriptions well in advance of their expiry date. See subscription for maximum length of a subscription for each resource type." }, { "info": { "name": "Microsoft Graph Delete subscription", "type": "http" }, "http": { "method": "DELETE", "url": "https://graph.microsoft.com/v1.0/subscriptions/:subscription-id", "headers": [ { "name": "If-Match", "value": "" } ], "params": [ { "name": "subscription-id", "value": "", "type": "path", "description": "The unique identifier of subscription" } ] }, "docs": "Delete a subscription. For the list of resources that support subscribing to change notifications, see the table in the Permissions section." } ] } ], "bundled": true }