Alerting APIs enable programmatic use of the alerting features of Kentik Detect. Alerting APIs are covered in the following topic:
|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.
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:
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.
The following table shows the path and HTTP request for this call (placeholders in italic):
||POST /api/v5/alerts/manual-mitigate HTTP/1.1
The following parameters are passed in a JSON object in the request body:
||The IP/CIDR to which you want to apply the mitigation.
||A user-defined string describing the mitigation to others in your organization. (Reserved for future use.)
||A valid ID for a Kentik Detect mitigation platform existing in your organization.
||A valid ID for a Kentik Detect mitigation method existing in your organization.
||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).
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.