Subscribe or unsubscribe from system alerts

PUT 
/system-alert-prefs

subscribe sends an SNS confirmation email (Cognito email claim). unsubscribe drops a confirmed subscription. Requires users.manage and system-settings.view. Subscribe is not idempotent while pending (5-minute resend window). Already subscribed or already unsubscribed still return 200.

Request

Responses

200

subscribe: confirmation-email Message, or already subscribed. unsubscribe: success Message, or already unsubscribed.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

400

{"Message": " - "} except pending unsubscribe. Codes: AUTH-1001, AUTH-1003, AUTH-1030, IPV-1052 (missing action), IPV-1041 (invalid action), IPV-1002, GE-1020, GE-1034 (resubscribe within 5 minutes). Pending unsubscribe is {"Message": "Cannot unsubscribe a subscription that is pending confirmation."} with no code. GenericFailure is HTTP 400.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

500

Missing SubscriptionArn on unsubscribe is GE-1023 InconsistentMetadata (HTTP 500). Other uncaught errors use {"Message": "RTE-1001 - ."} (for example a service user PUT that has no Cognito email claim).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers