run_instance_scan
Run a ServiceNow Instance Scan through the CI/CD API for saved suites, combos, scoped apps, update sets, point records, or full scans; returns a progress ID and supports async jobs.
Instructions
Start an Instance Scan through the CI/CD API: a saved suite scan (by suite or combo), a suite against scoped apps or update sets, a point scan of one record, or a full scan. Returns the progress id; pass async: true to follow the scan to the end as a job. Requires WRITE_ENABLED=true
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"scan_type": "<scan_type>"
},
"name": "run_instance_scan"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| async | No | Run as a background job and return a job_id at once. Poll it with get_job. Calls that take longer than about 20 seconds switch to a job on their own. | |
| suite | No | Suite name or sys_id (suite, scoped_apps, update_sets) | |
| scan_type | Yes | suite re-runs the saved instance-wide scan of a suite; full runs every active check and can take a long time | |
| combo_sys_id | No | scan_combo sys_id to re-run (combo) | |
| target_table | No | Table of the record to scan (point) | |
| target_sys_id | No | sys_id of the record to scan (point) | |
| app_scope_sys_ids | No | sys_scope sys_ids to scan (scoped_apps) | |
| update_set_sys_ids | No | sys_update_set sys_ids to scan (update_sets) |