Intruder
App · 20 actions
Work with your Intruder vulnerability scanning: add, tag and remove targets, start and cancel scans, set up scan schedules, list issues and where they were found, snooze or comment on them, and report on what was fixed and on licences.
Actions
| Action | What it does |
|---|---|
| Add target | Add a domain, IP address or URL for Intruder to scan. |
| Cancel scan | Stop a scan that is running. |
| Comment on occurrence | Add a comment to one occurrence of an issue, shown with it in Intruder. |
| Create scan schedule | Set up a scan that repeats daily, weekly, monthly or quarterly on the targets or tags you choose. |
| Delete scan schedule | Delete a scan schedule so it stops scanning. |
| Delete target | Remove a target from Intruder so it is no longer scanned. |
| Get licences | Get how many infrastructure and application licences the Intruder account has, and how many are used and free. |
| Get scan | Get a scan's status, targets and when it started and finished. |
| List fixed occurrences | List vulnerabilities that have been fixed, with when, for reporting on what was remediated in a period. |
| List issue occurrences | List where an issue was found: each target and port, how long ago, and whether it is snoozed. |
| List issues | List the vulnerabilities Intruder has found, by severity, how likely they are to be exploited, tag, target or when they were last found. |
| List scan schedules | List the repeating scans set up in Intruder, with when each runs next and how its last scan went. |
| List scans | List scans by status, type, schedule or tag. |
| List tags | List the tags used on the account's targets. |
| List targets | List the systems Intruder scans, with their status, type, tags and when each was last scanned. |
| Remove tag from target | Take a tag off a target. |
| Snooze occurrence | Snooze one occurrence of an issue, for good or for a while, with the reason, such as an accepted risk or a false positive. |
| Start scan | Start a scan now of the targets or tags you choose, or of every target. |
| Tag target | Add a tag to a target, such as to group it for scans and filters. |
| Update scan schedule | Change a scan schedule's name, timing, targets, tags or settings. |
Add target
Add a domain, IP address or URL for Intruder to scan. Only add systems you own or are allowed to scan; a scanned target uses a licence.
Inputs
- Address
addresstextRequired - The domain, IP address or URL to scan.
- Tags
tag_nameslist - Tags to give the target, up to 40 characters each.
Outputs
targetobject- The new target
Example output
{
"target": {
"address": "app.example.com",
"display_address": "app.example.com",
"has_api_schemas": false,
"has_authentications": false,
"id": 101,
"last_scanned": "",
"license_type": "infrastructure",
"tags": [
"production"
],
"target_status": "unscanned",
"target_type": "external",
"waf_interference": false,
"waf_provider": ""
}
}Cancel scan
Stop a scan that is running.
Inputs
- Scan ID
scan_idtextRequired - The scan's id, from 'List scans' or 'Start scan'.
Outputs
cancelledtrue/false- Always true once cancelled
messagetext- What Intruder said
scan_idnumber- The scan cancelled
Example output
{
"cancelled": true,
"message": "Scan was cancelled",
"scan_id": 5001
}Comment on occurrence
Add a comment to one occurrence of an issue, shown with it in Intruder.
Inputs
- Issue
issue_idtextRequired - The issue. Pick one, or give its id from 'List issues'.
- Occurrence ID
occurrence_idtextRequired - The occurrence's id, from 'List issue occurrences'.
- Comment
contenttextRequired - The comment, as plain text.
Outputs
commentobject- The comment
Example output
{
"comment": {
"commenter_type": "user",
"content": "Ticket raised to renew the certificate.",
"created_at": "2026-11-10T09:00:00Z",
"edited_at": "",
"id": 41,
"user": "jo@example.com"
}
}Create scan schedule
Set up a scan that repeats daily, weekly, monthly or quarterly on the targets or tags you choose.
Inputs
- Name
nametextRequired - The schedule's name, shown in Intruder.
- First scan
first_scan_timedate and timeRequired - When the first scan starts, in the future. Intruder starts scans on the hour, so a time part way through an hour moves to the next whole hour.
- Repeat
scan_frequencytextRequired - How often the scan repeats.One of:
daily,weekly,monthly,quarterly. - Targets
target_idslist - The targets the schedule scans.
- Tags
tag_nameslist - Scan every target with any of these tags.
- Scan gently
throttledtrue/false - Scan more slowly, for fragile systems that struggle under load.
- Web ports only
web_ports_onlytrue/false - Scan only the common web ports, not every port.
- Send results to Drata
upload_to_dratatrue/false - Upload each scan's results to Drata, if Intruder is connected to it.
- Send results to Vanta
upload_to_vantatrue/false - Upload each scan's results to Vanta, if Intruder is connected to it.
Outputs
first_scan_timetext- The first scan time sent, on the hour (ISO 8601 UTC); empty if it wasn't changed
noticetext- What Intruder said
schedule_idnumber- The scan schedule's id
Example output
{
"first_scan_time": "2026-11-17T03:00:00.000Z",
"notice": "Scan schedule created.",
"schedule_id": 77
}Delete scan schedule
Delete a scan schedule so it stops scanning. Scans it already ran are kept.
Inputs
- Scan schedule
schedule_idtextRequired - The scan schedule. Pick one, or give its id from an earlier step.
Outputs
deletedtrue/false- Always true once deleted
schedule_idnumber- The scan schedule deleted
Example output
{
"deleted": true,
"schedule_id": 77
}Delete target
Remove a target from Intruder so it is no longer scanned.
Inputs
- Target
target_idtextRequired - The target. Pick one, or give its id from an earlier step.
Outputs
deletedtrue/false- Always true once deleted
target_idnumber- The target deleted
Example output
{
"deleted": true,
"target_id": 101
}Get licences
Get how many infrastructure and application licences the Intruder account has, and how many are used and free.
Inputs
None.
Outputs
licensesobject- The account's licences
Example output
{
"licenses": {
"available_application_licenses": 1,
"available_infrastructure_licenses": 7,
"consumed_application_licenses": 1,
"consumed_infrastructure_licenses": 18,
"total_application_licenses": 2,
"total_infrastructure_licenses": 25
}
}Get scan
Get a scan's status, targets and when it started and finished.
Inputs
- Scan ID
scan_idtextRequired - The scan's id, from 'List scans' or 'Start scan'.
Outputs
scanobject- The scan
Example output
{
"scan": {
"completed_time": "2026-11-10T03:42:10Z",
"created_at": "2026-11-10T03:00:00Z",
"id": 5001,
"name": "Weekly external scan",
"scan_type": "assessment_schedule",
"schedule_period": "weekly",
"start_time": "2026-11-10T03:00:05Z",
"status": "completed",
"target_addresses": [
"app.example.com"
],
"throttled": false,
"web_ports_only": false
}
}List fixed occurrences
List vulnerabilities that have been fixed, with when, for reporting on what was remediated in a period.
Inputs
- Fixed after
remediated_afterdate and time - Only those fixed after this time.
- Fixed before
remediated_beforedate and time - Only those fixed before this time.
- Severity
severitytext - Only this severity. Leave blank for every severity.One of:
critical,high,medium,low. - Tags
tag_nameslist - Only those with any of these tags. Leave blank for all.
- Targets
target_addresseslist - Only on these target addresses. Leave blank for every target.
- Leave out deleted targets
exclude_deleted_targetstrue/false - Leave out what was found only on targets that have since been deleted.
- Page size
limitnumber - How many to return, 1 to 100. Intruder's default is 25.From 1 to 100.
- Start at
offsetnumber - Where the page starts: the 'next_offset' of an earlier page.At least 0.
Outputs
countnumber- How many match, across every page
has_moretrue/false- Whether another page follows
next_offsetnumber- Pass as 'Start at' for the next page; 0 on the last one
occurrenceslist- The fixed occurrences
Example output
{
"count": 1,
"has_more": false,
"next_offset": 0,
"occurrences": [
{
"affected_host": "app.example.com",
"affected_port": 22,
"cvss_score": 5.9,
"description": "The SSH server runs an outdated version.",
"display_address": "app.example.com",
"due_date": "2026-12-01",
"exploit_likelihood": "rare",
"extra_info": {},
"first_seen_at": "2026-10-01T03:15:00Z",
"host_state": "live",
"id": 30002,
"occurrence_id": 900002,
"remediated_at": "2026-11-09T03:20:00Z",
"remediation": "Upgrade OpenSSH.",
"severity": "medium",
"tags": [
"production"
],
"target_last_scanned_at": "2026-11-10T03:12:44Z",
"title": "Outdated OpenSSH version"
}
]
}List issue occurrences
List where an issue was found: each target and port, how long ago, and whether it is snoozed.
Inputs
- Issue
issue_idtextRequired - The issue. Pick one, or give its id from 'List issues'.
- First found since
sincedate and time - Only occurrences first found since this time.
- Snoozed
snoozedtext - Only snoozed, or only not snoozed. Leave blank for Intruder's default.One of:
false(Not snoozed),true(Snoozed). - Tags
tag_nameslist - Only those with any of these tags. Leave blank for all.
- Targets
target_addresseslist - Only on these target addresses. Leave blank for every target.
- Leave out deleted targets
exclude_deleted_targetstrue/false - Leave out what was found only on targets that have since been deleted.
- Page size
limitnumber - How many to return, 1 to 100. Intruder's default is 25.From 1 to 100.
- Start at
offsetnumber - Where the page starts: the 'next_offset' of an earlier page.At least 0.
Outputs
countnumber- How many match, across every page
has_moretrue/false- Whether another page follows
issue_idnumber- The issue
next_offsetnumber- Pass as 'Start at' for the next page; 0 on the last one
occurrenceslist- The occurrences
Example output
{
"count": 1,
"has_more": false,
"issue_id": 2001,
"next_offset": 0,
"occurrences": [
{
"age": "9 days",
"cves": [],
"cvss_score": 5.3,
"display_address": "app.example.com",
"exploit_likelihood": "unlikely",
"extra_info": {
"expires": "2026-12-01"
},
"first_seen_at": "2026-11-02T03:15:00Z",
"id": 30001,
"occurrence_id": 900001,
"port": "443",
"protocol": "tcp",
"snooze_details": "",
"snooze_reason": "",
"snooze_until": "",
"snoozed": false,
"target": "app.example.com",
"target_last_scanned_at": "2026-11-10T03:12:44Z"
}
]
}List issues
List the vulnerabilities Intruder has found, by severity, how likely they are to be exploited, tag, target or when they were last found.
Inputs
- Severity
severitytext - Only this severity. Leave blank for every severity.One of:
critical,high,medium,low. - Exploit likelihood
exploit_likelihoodtext - Only issues this likely to be exploited.One of:
known(Known to be exploited),very_likely(Very likely),likely,unlikely,rare,unknown(Unknown (no score)). - Found since
sincedate and time - Only issues found on a target since this time.
- Snoozed
snoozedtext - Only snoozed, or only not snoozed. Leave blank for Intruder's default.One of:
false(Not snoozed),true(Snoozed). - Tags
tag_nameslist - Only those with any of these tags. Leave blank for all.
- Targets
target_addresseslist - Only on these target addresses. Leave blank for every target.
- Leave out deleted targets
exclude_deleted_targetstrue/false - Leave out what was found only on targets that have since been deleted.
- Page size
limitnumber - How many to return, 1 to 100. Intruder's default is 25.From 1 to 100.
- Start at
offsetnumber - Where the page starts: the 'next_offset' of an earlier page.At least 0.
Outputs
countnumber- How many match, across every page
has_moretrue/false- Whether another page follows
issueslist- The issues
next_offsetnumber- Pass as 'Start at' for the next page; 0 on the last one
Example output
{
"count": 1,
"has_more": false,
"issues": [
{
"cvss_score": 5.3,
"description": "The certificate on this service expires within 30 days.",
"exploit_likelihood": "unlikely",
"first_seen_at": "2026-11-02T03:15:00Z",
"id": 2001,
"occurrences": "https://api.intruder.io/v1/issues/2001/occurrences/",
"remediation": "Renew the certificate before it expires.",
"severity": "high",
"snooze_reason": "",
"snooze_until": "",
"snoozed": false,
"title": "TLS certificate expires soon",
"vulnerability_category": "Encryption"
}
],
"next_offset": 0
}List scan schedules
List the repeating scans set up in Intruder, with when each runs next and how its last scan went.
Inputs
- Tags
tag_nameslist - Only those with any of these tags. Leave blank for all.
- Scans every target
scan_all_targetstext - Only schedules that scan every target, or only those that don't.One of:
true(Yes),false(No).
Outputs
countnumber- How many there are
scheduleslist- The scan schedules
Example output
{
"count": 1,
"schedules": [
{
"first_scan_time": "2026-11-03T03:00:00Z",
"id": 77,
"last_scan_end_time": "2026-11-10T03:42:10Z",
"last_scan_start_time": "2026-11-10T03:00:05Z",
"latest_scan_id": 5001,
"latest_scan_status": "published",
"name": "Weekly external scan",
"next_scan_date": "2026-11-17T03:00:00Z",
"scan_all_targets": false,
"schedule_period": "weekly",
"status": "scheduled",
"target_tags": [],
"targets": [
101
],
"throttled": false,
"upload_to_drata": false,
"upload_to_vanta": false,
"web_ports_only": false
}
]
}List scans
List scans by status, type, schedule or tag.
Inputs
- Status
statustext - Only scans in this state.One of:
in_progress(In progress),analysing_results(Analysing results),completed,cancelled,cancelled_no_active_targets(Cancelled: no active targets),cancelled_no_valid_targets(Cancelled: no valid targets). - Type
scan_typetext - Only scans of this type.One of:
assessment_schedule(Scheduled or manual scan),new_service(New service detected),cloudbot_new_target(New cloud target),rapid_remediation(Rapid remediation),advisory(Emerging threat),cloud_security(Cloud security),container_image(Container image). - Repeat
schedule_periodtext - Only scans that repeat this often.One of:
one_off(One off),daily,weekly,monthly,quarterly. - Tags
tag_nameslist - Only scans of a target with any of these tags.
- Page size
limitnumber - How many to return, 1 to 100. Intruder's default is 25.From 1 to 100.
- Start at
offsetnumber - Where the page starts: the 'next_offset' of an earlier page.At least 0.
Outputs
countnumber- How many match, across every page
has_moretrue/false- Whether another page follows
next_offsetnumber- Pass as 'Start at' for the next page; 0 on the last one
scanslist- The scans
Example output
{
"count": 1,
"has_more": false,
"next_offset": 0,
"scans": [
{
"created_at": "2026-11-10T03:00:00Z",
"id": 5001,
"name": "Weekly external scan",
"scan_type": "assessment_schedule",
"schedule_period": "weekly",
"status": "completed"
}
]
}List tags
List the tags used on the account's targets.
Inputs
- Page size
limitnumber - How many to return, 1 to 100. Intruder's default is 25.From 1 to 100.
- Start at
offsetnumber - Where the page starts: the 'next_offset' of an earlier page.At least 0.
Outputs
countnumber- How many match, across every page
has_moretrue/false- Whether another page follows
next_offsetnumber- Pass as 'Start at' for the next page; 0 on the last one
tagslist- The tags
Example output
{
"count": 1,
"has_more": false,
"next_offset": 0,
"tags": [
{
"name": "production"
}
]
}List targets
List the systems Intruder scans, with their status, type, tags and when each was last scanned.
Inputs
- Address
addresstext - Only targets whose address matches this.
- Tags
tag_nameslist - Only targets with any of these tags.
- Status
target_statustext - Only targets in this state.One of:
live,unscanned(Not scanned yet),unresponsive,license_exceeded(Licence limit reached),agent_uninstalled(Agent uninstalled). - Type
target_typetext - Only targets of this type.One of:
external,internal,cloud,container_image(Container image). - Last scanned after
last_scanned_afterdate - Only targets last scanned after this date.
- Last scanned before
last_scanned_beforedate - Only targets last scanned before this date.
- Order
orderingtext - Sort by when each was last scanned.One of:
-last_scanned(Most recently scanned first),last_scanned(Least recently scanned first). - Page size
limitnumber - How many to return, 1 to 100. Intruder's default is 25.From 1 to 100.
- Start at
offsetnumber - Where the page starts: the 'next_offset' of an earlier page.At least 0.
Outputs
countnumber- How many match, across every page
has_moretrue/false- Whether another page follows
next_offsetnumber- Pass as 'Start at' for the next page; 0 on the last one
targetslist- The targets
Example output
{
"count": 1,
"has_more": false,
"next_offset": 0,
"targets": [
{
"address": "app.example.com",
"display_address": "app.example.com",
"has_api_schemas": false,
"has_authentications": false,
"id": 101,
"last_scanned": "2026-11-01T03:12:44Z",
"license_type": "infrastructure",
"tags": [
"production"
],
"target_status": "live",
"target_type": "external",
"waf_interference": false,
"waf_provider": ""
}
]
}Remove tag from target
Take a tag off a target.
Inputs
- Target
target_idtextRequired - The target. Pick one, or give its id from an earlier step.
- Tag
tag_nametextRequired - The tag to take off.
Outputs
removedtrue/false- Always true once removed
tag_nametext- The tag taken off
target_idnumber- The target
Example output
{
"removed": true,
"tag_name": "production",
"target_id": 101
}Snooze occurrence
Snooze one occurrence of an issue, for good or for a while, with the reason, such as an accepted risk or a false positive.
Inputs
- Issue
issue_idtextRequired - The issue. Pick one, or give its id from 'List issues'.
- Occurrence ID
occurrence_idtextRequired - The occurrence's id, from 'List issue occurrences'.
- Reason
reasontextRequired - Why it is snoozed.One of:
ACCEPT_RISK(Risk accepted),FALSE_POSITIVE(False positive),MITIGATING_CONTROLS(Mitigating controls in place). - Snooze for
duration_typetext - Forever, or a number of days, weeks or months. Defaults to forever.One of:
forever,day(Days),week(Weeks),month(Months). - How many
durationnumber - How many days, weeks or months to snooze it for.Only when Snooze for is Days, Weeks or Months. At least 1.
- Comment
detailstext - A note saying why, kept with the occurrence.
Outputs
issue_idnumber- The issue
messagetext- What Intruder said
occurrence_idnumber- The occurrence
snoozedtrue/false- Always true once snoozed
Example output
{
"issue_id": 2001,
"message": "Occurrence was snoozed.",
"occurrence_id": 30001,
"snoozed": true
}Start scan
Start a scan now of the targets or tags you choose, or of every target. Only scan systems you own or are allowed to scan.
Inputs
- Targets
target_addresseslist - The target addresses to scan.
- Tags
tag_nameslist - Scan every target with any of these tags.
- Scan every target
scan_all_targetstrue/false - Scan every target on the account. Leave off when choosing targets or tags.
- Name
nametext - A name for the scan, shown in Intruder.
- Scan gently
throttledtrue/false - Scan more slowly, for fragile systems that struggle under load.
- Web ports only
web_ports_onlytrue/false - Scan only the common web ports, not every port.
Outputs
scanobject- The scan started
Example output
{
"scan": {
"completed_time": "",
"created_at": "2026-11-10T03:00:00Z",
"id": 5001,
"name": "Weekly external scan",
"scan_type": "assessment_schedule",
"schedule_period": "one_off",
"start_time": "2026-11-10T03:00:05Z",
"status": "in_progress",
"target_addresses": [
"app.example.com"
],
"throttled": false,
"web_ports_only": false
}
}Tag target
Add a tag to a target, such as to group it for scans and filters.
Inputs
- Target
target_idtextRequired - The target. Pick one, or give its id from an earlier step.
- Tag
tag_nametextRequired - The tag to add, up to 40 characters.
Outputs
tag_nametext- The tag added
target_idnumber- The target tagged
Example output
{
"tag_name": "production",
"target_id": 101
}Update scan schedule
Change a scan schedule's name, timing, targets, tags or settings. Fields left blank keep what the schedule has.
Inputs
- Scan schedule
schedule_idtextRequired - The scan schedule. Pick one, or give its id from an earlier step.
- Name
nametext - A new name. Leave blank to keep it.
- First scan
first_scan_timedate and time - A new first scan time, in the future; moved to the next whole hour if needed. Leave blank to keep it.
- Repeat
scan_frequencytext - How often it repeats. Leave blank to keep it.One of:
daily,weekly,monthly,quarterly. - Targets
target_idslist - The targets it scans, in place of its own. Leave blank to keep them.
- Tags
tag_nameslist - The tags it scans, in place of its own. Leave blank to keep them.
- Scan gently
throttledtext - Scan more slowly. Leave blank to keep it.One of:
true(Yes),false(No). - Web ports only
web_ports_onlytext - Scan only the common web ports. Leave blank to keep it.One of:
true(Yes),false(No). - Send results to Drata
upload_to_dratatext - Upload results to Drata. Leave blank to keep it.One of:
true(Yes),false(No). - Send results to Vanta
upload_to_vantatext - Upload results to Vanta. Leave blank to keep it.One of:
true(Yes),false(No).
Outputs
first_scan_timetext- The first scan time sent, on the hour (ISO 8601 UTC); empty if it wasn't changed
noticetext- What Intruder said
schedule_idnumber- The scan schedule's id
Example output
{
"first_scan_time": "",
"notice": "Scan was updated.",
"schedule_id": 77
}