Ticket List
For information on the Ticket List APIs, see the following URL:
https://api.app.secunia.com/api/tickets/
Tickets help you keep track and resolve vulnerabilities identified for your Watch Lists.
API Supported Endpoint Actions and Available Methods for Ticket List APIs include:
| • | Available Methods for Ticket List |
| • | Available Filters on Ticket List |
| • | Create Method Fields for Ticket Lists |
| • | Edit Method Fields for Ticket Lists |
Available Methods for Ticket List
The following are available methods for Ticket List.
|
Method |
Description |
|
get list |
GET <URL> |
|
create instance(s) |
POST <URL> Note:Can create multiple tickets, one per advisory - Watch list pair. |
|
edit instance(s) |
POST <URL>edit/ Note:Can edit multiple tickets. |
Available Filters on Ticket List
The following are available filters for Ticket List.
|
Filter |
Description |
|
assigned_to_id (int) |
Tickets assigned to a specific users, id-username list available at /api/users/kvlist/ |
|
status_id (int) |
Tickets with a certain status; list available at /api/ticket-statuses/ |
|
priority_id (int) |
Tickets with a certain priority; list available at /api/ticket-priorities/ |
|
queue_id (int) |
Tickets on a certain queue; list available at /api/ticket-queues/ |
|
asset_list_id (int) |
Tickets created for a certain Watch list; list available at /api/Watch-lists/ |
|
criticality (int) |
Tickets for advisories with a certain criticality. (See criticality filter options on advisories page.) |
|
created__gte (int) |
Unix timestamp for the ticket create date, filter type greater than or equal (seconds) |
|
created__lt (int) |
Unix timestamp for the ticket create date, filter type less than (seconds) |
|
solution_status (int) |
Solution type for the advisory associated with the ticket (See solution_status filter options on advisories page.) |
|
cvss_score__gte (decimal) |
CVSS Score of the advisory greater than or equal filter, e.g. 8.5 |
|
cvss_score__lte (decimal) |
CVSS Score of the advisory less than or equal filter, e.g. 9.5 |
|
last_updated__gte (int) |
Unix timestamp for the ticket last change date, filter type greater than or equal (seconds) |
|
last_updated__lt (int) |
Unix timestamp for the ticket last change date, filter type less than (seconds) |
Create Method Fields for Ticket Lists
The following are available create method fields for Ticket Lists.
|
Field |
Description |
|
advisory (list of int, optional) |
List of advisory ids for which the tickets should be created. A ticket will be created for each advisory id |
|
advisory_identifier (string, ignored if advisory) |
Unique advisory identifier for which the ticket should be created, Used when the advisory ids list is not present. |
|
status_id (int, optional) |
The status id for the new tickets. Default "Open" |
|
priority_id (int, optional) |
The priority id for the new tickets. Default calculated on advisory criticality |
|
queue_id (int, optional) |
The queue id for the new tickets. Default "Default" |
|
assigned_to_id (int, optional) |
To whom to assign the ticket; id-username list available at /api/users/kvlist/ |
|
asset_list (list of int, optional) |
On which Watch list ids the advisory is matched. A ticket is created for each unique combination of Watch list id, advisory |
|
comment (string, optional) |
Ticket note that should be assigned to the ticket |
Edit Method Fields for Ticket Lists
Allows you to edit multiple tickets (if a field does not exit, the value for that ticket doesn't change):
|
Field |
Description |
|
ticket (list of int) |
The list of ticket ids that need to be changed |
|
status (int, optional) |
The status id for the new tickets |
|
priority (int) |
The priority id for the new tickets |
|
queue (int) |
The queue id for the new tickets |
|
assigned_to (int, optional) |
To whom to assign the ticket; id-username list available at /api/users/kvlist/ |
|
comment (string, optional) |
Ticket note that should be assigned to the ticket |