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

ActionWhat it does
Add targetAdd a domain, IP address or URL for Intruder to scan.
Cancel scanStop a scan that is running.
Comment on occurrenceAdd a comment to one occurrence of an issue, shown with it in Intruder.
Create scan scheduleSet up a scan that repeats daily, weekly, monthly or quarterly on the targets or tags you choose.
Delete scan scheduleDelete a scan schedule so it stops scanning.
Delete targetRemove a target from Intruder so it is no longer scanned.
Get licencesGet how many infrastructure and application licences the Intruder account has, and how many are used and free.
Get scanGet a scan's status, targets and when it started and finished.
List fixed occurrencesList vulnerabilities that have been fixed, with when, for reporting on what was remediated in a period.
List issue occurrencesList where an issue was found: each target and port, how long ago, and whether it is snoozed.
List issuesList the vulnerabilities Intruder has found, by severity, how likely they are to be exploited, tag, target or when they were last found.
List scan schedulesList the repeating scans set up in Intruder, with when each runs next and how its last scan went.
List scansList scans by status, type, schedule or tag.
List tagsList the tags used on the account's targets.
List targetsList the systems Intruder scans, with their status, type, tags and when each was last scanned.
Remove tag from targetTake a tag off a target.
Snooze occurrenceSnooze one occurrence of an issue, for good or for a while, with the reason, such as an accepted risk or a false positive.
Start scanStart a scan now of the targets or tags you choose, or of every target.
Tag targetAdd a tag to a target, such as to group it for scans and filters.
Update scan scheduleChange 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

AddressaddresstextRequired
The domain, IP address or URL to scan.
Tagstag_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 IDscan_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

Issueissue_idtextRequired
The issue. Pick one, or give its id from 'List issues'.
Occurrence IDoccurrence_idtextRequired
The occurrence's id, from 'List issue occurrences'.
CommentcontenttextRequired
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

NamenametextRequired
The schedule's name, shown in Intruder.
First scanfirst_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.
Repeatscan_frequencytextRequired
How often the scan repeats.One of: daily, weekly, monthly, quarterly.
Targetstarget_idslist
The targets the schedule scans.
Tagstag_nameslist
Scan every target with any of these tags.
Scan gentlythrottledtrue/false
Scan more slowly, for fragile systems that struggle under load.
Web ports onlyweb_ports_onlytrue/false
Scan only the common web ports, not every port.
Send results to Drataupload_to_dratatrue/false
Upload each scan's results to Drata, if Intruder is connected to it.
Send results to Vantaupload_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 scheduleschedule_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

Targettarget_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 IDscan_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 afterremediated_afterdate and time
Only those fixed after this time.
Fixed beforeremediated_beforedate and time
Only those fixed before this time.
Severityseveritytext
Only this severity. Leave blank for every severity.One of: critical, high, medium, low.
Tagstag_nameslist
Only those with any of these tags. Leave blank for all.
Targetstarget_addresseslist
Only on these target addresses. Leave blank for every target.
Leave out deleted targetsexclude_deleted_targetstrue/false
Leave out what was found only on targets that have since been deleted.
Page sizelimitnumber
How many to return, 1 to 100. Intruder's default is 25.From 1 to 100.
Start atoffsetnumber
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

Issueissue_idtextRequired
The issue. Pick one, or give its id from 'List issues'.
First found sincesincedate and time
Only occurrences first found since this time.
Snoozedsnoozedtext
Only snoozed, or only not snoozed. Leave blank for Intruder's default.One of: false (Not snoozed), true (Snoozed).
Tagstag_nameslist
Only those with any of these tags. Leave blank for all.
Targetstarget_addresseslist
Only on these target addresses. Leave blank for every target.
Leave out deleted targetsexclude_deleted_targetstrue/false
Leave out what was found only on targets that have since been deleted.
Page sizelimitnumber
How many to return, 1 to 100. Intruder's default is 25.From 1 to 100.
Start atoffsetnumber
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

Severityseveritytext
Only this severity. Leave blank for every severity.One of: critical, high, medium, low.
Exploit likelihoodexploit_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 sincesincedate and time
Only issues found on a target since this time.
Snoozedsnoozedtext
Only snoozed, or only not snoozed. Leave blank for Intruder's default.One of: false (Not snoozed), true (Snoozed).
Tagstag_nameslist
Only those with any of these tags. Leave blank for all.
Targetstarget_addresseslist
Only on these target addresses. Leave blank for every target.
Leave out deleted targetsexclude_deleted_targetstrue/false
Leave out what was found only on targets that have since been deleted.
Page sizelimitnumber
How many to return, 1 to 100. Intruder's default is 25.From 1 to 100.
Start atoffsetnumber
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

Tagstag_nameslist
Only those with any of these tags. Leave blank for all.
Scans every targetscan_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

Statusstatustext
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).
Typescan_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).
Repeatschedule_periodtext
Only scans that repeat this often.One of: one_off (One off), daily, weekly, monthly, quarterly.
Tagstag_nameslist
Only scans of a target with any of these tags.
Page sizelimitnumber
How many to return, 1 to 100. Intruder's default is 25.From 1 to 100.
Start atoffsetnumber
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 sizelimitnumber
How many to return, 1 to 100. Intruder's default is 25.From 1 to 100.
Start atoffsetnumber
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

Addressaddresstext
Only targets whose address matches this.
Tagstag_nameslist
Only targets with any of these tags.
Statustarget_statustext
Only targets in this state.One of: live, unscanned (Not scanned yet), unresponsive, license_exceeded (Licence limit reached), agent_uninstalled (Agent uninstalled).
Typetarget_typetext
Only targets of this type.One of: external, internal, cloud, container_image (Container image).
Last scanned afterlast_scanned_afterdate
Only targets last scanned after this date.
Last scanned beforelast_scanned_beforedate
Only targets last scanned before this date.
Orderorderingtext
Sort by when each was last scanned.One of: -last_scanned (Most recently scanned first), last_scanned (Least recently scanned first).
Page sizelimitnumber
How many to return, 1 to 100. Intruder's default is 25.From 1 to 100.
Start atoffsetnumber
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

Targettarget_idtextRequired
The target. Pick one, or give its id from an earlier step.
Tagtag_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

Issueissue_idtextRequired
The issue. Pick one, or give its id from 'List issues'.
Occurrence IDoccurrence_idtextRequired
The occurrence's id, from 'List issue occurrences'.
ReasonreasontextRequired
Why it is snoozed.One of: ACCEPT_RISK (Risk accepted), FALSE_POSITIVE (False positive), MITIGATING_CONTROLS (Mitigating controls in place).
Snooze forduration_typetext
Forever, or a number of days, weeks or months. Defaults to forever.One of: forever, day (Days), week (Weeks), month (Months).
How manydurationnumber
How many days, weeks or months to snooze it for.Only when Snooze for is Days, Weeks or Months. At least 1.
Commentdetailstext
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

Targetstarget_addresseslist
The target addresses to scan.
Tagstag_nameslist
Scan every target with any of these tags.
Scan every targetscan_all_targetstrue/false
Scan every target on the account. Leave off when choosing targets or tags.
Namenametext
A name for the scan, shown in Intruder.
Scan gentlythrottledtrue/false
Scan more slowly, for fragile systems that struggle under load.
Web ports onlyweb_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

Targettarget_idtextRequired
The target. Pick one, or give its id from an earlier step.
Tagtag_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 scheduleschedule_idtextRequired
The scan schedule. Pick one, or give its id from an earlier step.
Namenametext
A new name. Leave blank to keep it.
First scanfirst_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.
Repeatscan_frequencytext
How often it repeats. Leave blank to keep it.One of: daily, weekly, monthly, quarterly.
Targetstarget_idslist
The targets it scans, in place of its own. Leave blank to keep them.
Tagstag_nameslist
The tags it scans, in place of its own. Leave blank to keep them.
Scan gentlythrottledtext
Scan more slowly. Leave blank to keep it.One of: true (Yes), false (No).
Web ports onlyweb_ports_onlytext
Scan only the common web ports. Leave blank to keep it.One of: true (Yes), false (No).
Send results to Drataupload_to_dratatext
Upload results to Drata. Leave blank to keep it.One of: true (Yes), false (No).
Send results to Vantaupload_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
}

On this page