# Universal Alerting

## Retrieve Universal Alert rules

 - [GET /universal-alert](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/universal-alerting/get_universal_alert.md): Returns an array of all universal alert rules associated with the network.

## Create a single custom rule

 - [POST /universal-alert](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/universal-alerting/post_universal_alert.md): Creates a single custom Wifi Motion Alert.

## Get Universal Alert Status

 - [GET /universal-alert/status](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/universal-alerting/get_universal_alert_status.md): Returns an array of all alerts associated with the network, but from the view of the job queue, including all the internal state of the job. 

The data field of this response contains the client facing alert alert model. This endpoint is to assist with seeing the internals of the job queue.

## Get universal alert

 - [GET /universal-alert/{uuid}](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/universal-alerting/get_universal_alert_.md): Get a single alert by its uuid.

## Delete Universal Alert

 - [DELETE /universal-alert/{uuid}](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/universal-alerting/delete_universal_alert.md): Deletes an alert by its uuid.

A successful delete will return the entire alert model.

Only the alerts owned by the network can be deleted. And these alerts can be deleted by both member or owner.

## Update of Single Alert

 - [PATCH /universal-alert/{uuid}](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/universal-alerting/patch_universal-alert.md): Update a single alert

If an alert has been switched into an  state because the alert has completed every possible recurrence, the mutation must include a new RRULE that has at least one occurrence in the future.

Under the hood, PATCH is a get job, delete job, and create a job.

Note that the following parameters cannot be mutated via the PATCH:
- external_id
- uuid
- options

path parameter can only be the uuid

## Universal Alert Bulk Enable

 - [PATCH /universal-alert-bulk](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/universal-alerting/patch_universal_alert_bulk.md): Enable or disable multiple alerts.