@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api ApiManagementClient
@base https://management.azure.com
@version 2019-01-01
@auth OAuth2
@endpoints 11
@toc subscriptions(11)

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications
@desc Lists a collection of properties defined within a service instance.
@returns(200) A Collection of the Notification for the specified API Management service instance.

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}
@desc Gets the details of the Notification specified by its identifier.
@returns(200) The response body contains the specified Notification.

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}
@desc Create or Update API Management publisher notification.
@returns(200) Notification was successfully updated.

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientUsers
@desc Gets the list of the Notification Recipient User subscribed to the notification.
@returns(200) The response body contains the Recipient User collection for the notification.

@endpoint HEAD /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientUsers/{userId}
@desc Determine if the Notification Recipient User is subscribed to the notification.
@returns(204) The User is subscribed to receive the notification.
@errors {404: Entity does not exists.}

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientUsers/{userId}
@desc Adds the API Management User to the list of Recipients for the Notification.
@returns(200) Recipient User is already part of the notification list.
@returns(201) Recipient User was successfully added to the notification list.

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientUsers/{userId}
@desc Removes the API Management user from the list of Notification.
@returns(200) Recipient User was successfully removed from the notification list.
@returns(204) Recipient User was successfully removed from the notification list.

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientEmails
@desc Gets the list of the Notification Recipient Emails subscribed to a notification.
@returns(200) The response body contains the Recipient Email collection subscribed to the notification.

@endpoint HEAD /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientEmails/{email}
@desc Determine if Notification Recipient Email subscribed to the notification.
@returns(204) The Users is subscribed to receive the notification.
@errors {404: The Users is not subscribed to receive the notification.}

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientEmails/{email}
@desc Adds the Email address to the list of Recipients for the Notification.
@returns(200) Recipient Email is already part of the notification list.
@returns(201) Recipient Email was successfully added to the notification list.

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientEmails/{email}
@desc Removes the email from the list of Notification.
@returns(200) Recipient Email was successfully removed to the notification list.
@returns(204) Recipient Email was successfully removed to the notification list.

@end
