Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
API description
Deletes Indicator entities by ID.
Limitations
Rate limitations for this API are 30 calls per minute and 1,500 calls per hour.
Batch size limit of up to 500 Indicator IDs.
Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Get started.
| Permission type | Permission | Permission display name |
|---|---|---|
| Application | Ti.ReadWrite.All | 'Read and write Indicators' |
HTTP request
POST https://api.security.microsoft.com/api/indicators/BatchDelete
Request headers
| Name | Type | Description |
|---|---|---|
| Authorization | String | Bearer {token}. Required. |
Request body
In the request body, supply a JSON object with the following parameters:
| Parameter | Type | Description |
|---|---|---|
| IndicatorIds | List String | A list of the IDs of the indicators to be removed. Required |
Response
If Indicators all existed and were deleted successfully - 204 OK without content.
If indicator IDs list is empty or exceeds size limit - 400 Bad Request.
If any indicator ID is invalid - 400 Bad Request.
If requestor isn't exposed to any indicator's device groups - 403 Forbidden.
If any Indicator ID wasn't found - 404 Not Found.
Example
Request
Here's an example of the request.
POST https://api.security.microsoft.com/api/indicators/BatchDelete
{
"IndicatorIds": [ "1", "2", "5" ]
}