Views:
Retrieves all blocked senders, URLs, SHA-1 hash values, and SHA-256 hash values that the administrator has configured through this API on Cloud App Security to quarantine Exchange Online email messages.

HTTPS Request

GET https://<serviceURL>/v1/remediation/mails

Request Example

GET https://api.tmcas.trendmicro.com/v1/remediation/mails
Authorization: Bearer 1de231142eef3f83928da98dc251fbebb6cafe77

Response

On success, the service sends back an HTTP 200 response and returns a response body in JSON format; otherwise, the service sends back an error message in JSON format with error details. For more information about errors, see API Responses.

Response Example

HTTP/1.1 200
Content-Type: application/json

{
    "code": 0,
    "message": "Get rules successfully.",
    "rules": {
        "senders": ["user@example.com"],
        "urls": ["test.example.com"],
        "filehashes": [
            "d6cdddb37f6a933d6a256bd98b4bc703a448c677",
            "c14bffeecbaf61516893d766e1b525bd920da077",
            "e2cdddb37f6a933d6a256bd98b4bc703a448c677"
        ],
        "file256hashes": [
            "2eb49162d4977bd96d6918a7602b5451adfd2c498c44592574b5741b3b585fc6",
            "233dac1fdc6a5d0347b4da75a112759501abe908c75b8436769fc3c846c40767"
        ]
    }
}

Response Fields

The following table describes the available fields for the response body.
Field
Data Type
Description
code
Integer
Result code of the request. For an HTTP 200 response, the value is fixed to 0
message
String
String describing the result code. For an HTTP 200 response, the value is Get rules successfully.
rules
JSON object
Blocked sender, URL, SHA-1 hash value, and SHA-256 hash value lists configured
senders
JSON array
A list of blocked senders configured
urls
JSON array
A list of blocked URLs configured
filehashes
JSON array
A list of blocked SHA-1 hash values configured
file256hashes
JSON array
A list of blocked SHA-256 hash values configured