CH logo® Knowledge Base
Contents Search
   

 

Alerting APIs

Alerting APIs enable programmatic use of the alerting features of Kentik Detect. Alerting APIs are covered in the following topic:

 

 
 top

Manual Mitigation API

Note: Users whose level is Member have no access to the methods of this API.

The Manual Mitigation API enables you to programmatically apply a manual mitigation that is functionally identical to a manual mitigations that has been started from the Alerting page in the Kentik Detect portal (see Manual Mitigation). The Manual Mitigation API is covered in the following topics:

Note: To make calls to this API using cURL, see API Access Via cURL.

 

 
 top  |  section

Manual Mitigation JSON

Calls to the Manual Mitigation API each return an HTTP response body containing a “response” object in JSON. The object is made up of the result field (name:value pair) shown in the following example:

{
  "response": {
    "result": "OK",
  }
}


 

 
 top  |  section

Manual Mitigation Create

This POST method starts a new manual mitigation on a specified IP/CIDR using a specified mitigation platform and method.

Note: To try this call, go to the V5 API Tester.

HTTP Request

The following table shows the path and HTTP request for this call (placeholders in italic):

URL https://api.kentik.com/api/v5/alerts/manual-mitigate
Request POST /api/v5/alerts/manual-mitigate HTTP/1.1
Host: api.kentik.com
X-CH-Auth-API-Token: user_api_token
X-CH-Auth-Email: user@domain.suffix
Content-Type: application/json

The following parameters are passed in a JSON object in the request body:

JSON name Type Description
ipCidr string The IP/CIDR to which you want to apply the mitigation.
Comment string A user-defined string describing the mitigation to others in your organization. (Reserved for future use.)
platformID string A valid ID for a Kentik Detect mitigation platform existing in your organization.
methodId string A valid ID for a Kentik Detect mitigation method existing in your organization.
minutesBeforeAutoStop string A duration after which the mitigation will stop. If specified as “0” the mitigation will continue until stopped manually in the portal (see Stop a Manual Mitigation).

HTTP Response

A successful response to this call includes the following elements:

  • The response headers.
  • The HTTP response code.
  • A single JSON response object indicating that the call was successful.

Note: For a description of the JSON name:value pairs in a response object see Manual Mitigation JSON.

 

In this article: