Watch List Advisory List
For information on the Watch List Advisory List, see the following URL:
https://api.app.secunia.com/api/approve-advisories/
A list of advisories per Watch List awaiting approval before tickets are created.
When creating an Watch List, if you enable the option "Advisories need approval", the Watch List creator will be notified when an advisory is released and needs approval. If the advisory is approved, a ticket is then created if the advisory criticality is greater than the ticket threshold criticality and emails/SMS are sent if the threshold conditions apply.
If the advisory is dismissed, it disappears from the initial list. You can delete the dismissed advisories and you can permanently delete or approve them in case the dismissal was done by mistake.
API Supported Endpoint Actions and Available Methods for Watch List Advisory List APIs include:
| • | Available Methods for Watch List Advisory List |
| • | Available Filters on Watch List Advisory List |
| • | Approve Method for Watch List Advisory List |
| • | Dismiss Method for Watch List Advisory List |
Available Methods for Watch List Advisory List
The following methods are available for the Watch List Advisory List:
|
Method |
Example |
|
get list |
GET <URL> |
|
approve instance |
POST <URL><id>/approve/ |
|
dismiss instance |
POST <URL><id>/dismiss/ |
|
delete instance |
DELETE <URL><id>/ |
Available Filters on Watch List Advisory List
The following filters are available for the Watch List Advisory List:
|
Filter |
Description |
|
asset_list_id (int) |
The Watch list id for which the advisory matches |
|
identifier (string) |
Unique advisory identifier |
|
title (string) |
Case insensitive term search in the advisory title |
|
criticality (int) |
Advisories with a certain criticality. (See criticality filter options on advisories page.) |
|
solution_status (int) |
Advisories with a certain solution status. (See solution status filter options on advisories page.) |
|
released__gte (int) |
Unix timestamp for the release date of the advisory, filter type greater than or equal (seconds) |
|
released__lt (int) |
Unix timestamp for the release date of the advisory, filter type less than (seconds) |
|
dismissed (bool) |
Filters advisories that were previously dismissed and can now be permanently deleted or approved. |
Approve Method for Watch List Advisory List
Approved advisories for an Watch list. Then, if the threshold conditions pass, a ticket is created and notifications are sent.
Dismiss Method for Watch List Advisory List
The advisory is dismissed and removed from the list.