Delete a mail server
DELETE/mailservers/:server_id
Deletes a mail server from DynamoDB and its SSM credentials. Requires system-settings.fullaccess. Unknown ids are not rejected with 400; SSM delete or audit then fails as 500. Service users are rejected (GE-1014).
Request
Responses
- 200
- 400
- 500
Server and SSM parameter were deleted.
Response Headers
Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers
Authorization failure. Body is {"Message": " -
Response Headers
Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers
DynamoDB delete failure uses DB-1003. SSM delete status other than 200 uses GE-1012. Missing SSM parameter and other uncaught errors use {"Message": "GE-1008 - Could not complete the request. Please try again."}.
Response Headers
Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers