List mail servers

GET 
/mailservers

Returns configured mail servers. Requires system-settings.view. Pagination is in-memory after a full table scan; last page when next_available is no. Password is not returned. Service users are rejected (GE-1014).

Request

Responses

200

Page of mail servers plus next_available (yes/no), count (this page), and total_count. Continue with offset += limit until next_available is no.

Response Headers

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

400

Validation or authorization failure. Body is {"Message": " - "}. Codes: AUTH-1001 (missing role_id), AUTH-1003 (user not on role), AUTH-1030 (missing system-settings.view), IPV-1002 (role_id not found), IPV-1050 (limit over 500), GE-1014 (service user).

Response Headers

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

500

Uncaught errors use {"Message": "GE-1008 - Could not complete the request. Please try again."}. InconsistentMetadataException and GenericFailureException also return 500.

Response Headers

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