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