/msp/ticket_edit.php
Edit selected tickets in the subscription to update ticket state, change the assignee, and add comments.
Edit remediation tickets in the user’s account. Multiple tickets can be edited at one time in bulk. Many ticket parameters are supported for selecting what tickets you’d like to edit.
Basic HTTP authentication is required. Session based authentication is not supported using this API.
Ticket limit - A maximum of 20,000 tickets can be edited in one ticket_edit.php request. It’s recommended best practice that you choose to schedule batch updates to occur when ticket processing will least impact user productivity. If the ticket_edit.php request identifies more than 20,000 tickets to be edited, then an error is returned.
Permissions - Managers can edit tickets for all IPs in the subscription, Unit Managers can edit tickets for IPs in their own business unit, Scanners and Readers do not have permission to edit tickets.
Click here to view ticket selection parameters. At least one ticket selection parameter must be specified.
The following parameters are used to specify ticket data to be edited. At least one of these parameters must be specified.
|
Parameter |
Required/Optional |
Data Type |
Description |
|---|---|---|---|
|
change_assignee={value} |
Optional |
String |
Used to change the ticket assignee, specified by user login, in all selected tickets. The assignee’s account must have a user role other than Contact, and the hosts associated with the selected tickets must be in the user account. |
|
change_state={value} |
Optional |
Boolean |
Used to change the ticket state/status to the specified state/status in all selected tickets. Valid values: OPEN = Open and Open/Reopened RESOLVED = Resolved IGNORED = Closed/Ignored A ticket that is currently Closed/Fixed or Closed/Ignored cannot be changed to Resolved. |
|
add_comment={value} |
Optional |
String |
Used to add a comment in all selected tickets. The comment text may include a maximum of 2,000 characters (ascii). |
|
reopen_ignored_days={value} |
Optional |
Integer |
Used to reopen Closed/Ignored tickets in a set number of days. Specify the due date in N days, where N is a number of days from today. A valid value is an integer from 1 to 730. When the due date is reached, the ticket state is changed from Closed/Ignored to Open, assuming the issue still exists, and the ticket is marked as overdue. If the issue was resolved at some point while the ticket was in the Closed/Ignored state, then the ticket state is changed from Closed/Ignored to Closed/Fixed. |
API Request
curl -u "USERNAME:PASSWORD" -H "X-Requested-With: Curl" -X POST -d"ticket_numbers=23456&add_comment=Host+patched,+ready+for+re-scan""https://<qualys_base_url>/msp/ticket_edit.php?"API Request
curl -u "USERNAME:PASSWORD" -H "X-Requested-With: Curl" -X POST -d "ips=10.10.10.120&reopen_ignored_days=7""https://<qualys_base_url>/msp/ticket_edit.php?"API Request
curl -u "USERNAME:PASSWORD" -H "X-Requested-With: Curl" -X POST -d"states=OPEN&unmodified_since=2018-01-01&ticket_assignee=qualys_tb&change_assignee=qualys_ac""https://<qualys_base_url>/msp/ticket_edit.php?"API Request
curl -u "USERNAME:PASSWORD" -H "X-Requested-With: Curl" -X POST -d "since_ticket_number=00215555&invalid=1&change_assignee=acme_ac" "https://<qualys_base_url>/msp/ticket_edit.php?"API Request
curl -u "USERNAME:PASSWORD" -H "X-Requested-With: Curl" -X POST -d "states=OPEN&asset_groups=New+York,London&change_state=IGNORED" "https://<qualys_base_url>/msp/ticket_edit.php?"<platform API server>/ticket_edit_output.dtd