# Intruder

> 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.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/intruder

## Actions

### 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 (`address`, text, required): The domain, IP address or URL to scan.
- Tags (`tag_names`, list): Tags to give the target, up to 40 characters each.

**Outputs**

- `target` (object): The new target

**Example output**

```json
{
  "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_id`, text, required): The scan's id, from 'List scans' or 'Start scan'.

**Outputs**

- `cancelled` (true/false): Always true once cancelled
- `message` (text): What Intruder said
- `scan_id` (number): The scan cancelled

**Example output**

```json
{
  "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_id`, text, required): The issue. Pick one, or give its id from 'List issues'.
- Occurrence ID (`occurrence_id`, text, required): The occurrence's id, from 'List issue occurrences'.
- Comment (`content`, text, required): The comment, as plain text.

**Outputs**

- `comment` (object): The comment

**Example output**

```json
{
  "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 (`name`, text, required): The schedule's name, shown in Intruder.
- First scan (`first_scan_time`, date and time, required): 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_frequency`, text, required): How often the scan repeats. One of: `daily`, `weekly`, `monthly`, `quarterly`.
- Targets (`target_ids`, list): The targets the schedule scans.
- Tags (`tag_names`, list): Scan every target with any of these tags.
- Scan gently (`throttled`, true/false): Scan more slowly, for fragile systems that struggle under load.
- Web ports only (`web_ports_only`, true/false): Scan only the common web ports, not every port.
- Send results to Drata (`upload_to_drata`, true/false): Upload each scan's results to Drata, if Intruder is connected to it.
- Send results to Vanta (`upload_to_vanta`, true/false): Upload each scan's results to Vanta, if Intruder is connected to it.

**Outputs**

- `first_scan_time` (text): The first scan time sent, on the hour (ISO 8601 UTC); empty if it wasn't changed
- `notice` (text): What Intruder said
- `schedule_id` (number): The scan schedule's id

**Example output**

```json
{
  "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_id`, text, required): The scan schedule. Pick one, or give its id from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `schedule_id` (number): The scan schedule deleted

**Example output**

```json
{
  "deleted": true,
  "schedule_id": 77
}
```

### Delete target

Remove a target from Intruder so it is no longer scanned.

**Inputs**

- Target (`target_id`, text, required): The target. Pick one, or give its id from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `target_id` (number): The target deleted

**Example output**

```json
{
  "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**

- `licenses` (object): The account's licences

**Example output**

```json
{
  "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_id`, text, required): The scan's id, from 'List scans' or 'Start scan'.

**Outputs**

- `scan` (object): The scan

**Example output**

```json
{
  "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_after`, date and time): Only those fixed after this time.
- Fixed before (`remediated_before`, date and time): Only those fixed before this time.
- Severity (`severity`, text): Only this severity. Leave blank for every severity. One of: `critical`, `high`, `medium`, `low`.
- Tags (`tag_names`, list): Only those with any of these tags. Leave blank for all.
- Targets (`target_addresses`, list): Only on these target addresses. Leave blank for every target.
- Leave out deleted targets (`exclude_deleted_targets`, true/false): Leave out what was found only on targets that have since been deleted.
- Page size (`limit`, number): How many to return, 1 to 100. Intruder's default is 25. From 1 to 100.
- Start at (`offset`, number): Where the page starts: the 'next_offset' of an earlier page. At least 0.

**Outputs**

- `count` (number): How many match, across every page
- `has_more` (true/false): Whether another page follows
- `next_offset` (number): Pass as 'Start at' for the next page; 0 on the last one
- `occurrences` (list): The fixed occurrences

**Example output**

```json
{
  "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_id`, text, required): The issue. Pick one, or give its id from 'List issues'.
- First found since (`since`, date and time): Only occurrences first found since this time.
- Snoozed (`snoozed`, text): Only snoozed, or only not snoozed. Leave blank for Intruder's default. One of: `false` (Not snoozed), `true` (Snoozed).
- Tags (`tag_names`, list): Only those with any of these tags. Leave blank for all.
- Targets (`target_addresses`, list): Only on these target addresses. Leave blank for every target.
- Leave out deleted targets (`exclude_deleted_targets`, true/false): Leave out what was found only on targets that have since been deleted.
- Page size (`limit`, number): How many to return, 1 to 100. Intruder's default is 25. From 1 to 100.
- Start at (`offset`, number): Where the page starts: the 'next_offset' of an earlier page. At least 0.

**Outputs**

- `count` (number): How many match, across every page
- `has_more` (true/false): Whether another page follows
- `issue_id` (number): The issue
- `next_offset` (number): Pass as 'Start at' for the next page; 0 on the last one
- `occurrences` (list): The occurrences

**Example output**

```json
{
  "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 (`severity`, text): Only this severity. Leave blank for every severity. One of: `critical`, `high`, `medium`, `low`.
- Exploit likelihood (`exploit_likelihood`, text): 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 (`since`, date and time): Only issues found on a target since this time.
- Snoozed (`snoozed`, text): Only snoozed, or only not snoozed. Leave blank for Intruder's default. One of: `false` (Not snoozed), `true` (Snoozed).
- Tags (`tag_names`, list): Only those with any of these tags. Leave blank for all.
- Targets (`target_addresses`, list): Only on these target addresses. Leave blank for every target.
- Leave out deleted targets (`exclude_deleted_targets`, true/false): Leave out what was found only on targets that have since been deleted.
- Page size (`limit`, number): How many to return, 1 to 100. Intruder's default is 25. From 1 to 100.
- Start at (`offset`, number): Where the page starts: the 'next_offset' of an earlier page. At least 0.

**Outputs**

- `count` (number): How many match, across every page
- `has_more` (true/false): Whether another page follows
- `issues` (list): The issues
- `next_offset` (number): Pass as 'Start at' for the next page; 0 on the last one

**Example output**

```json
{
  "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_names`, list): Only those with any of these tags. Leave blank for all.
- Scans every target (`scan_all_targets`, text): Only schedules that scan every target, or only those that don't. One of: `true` (Yes), `false` (No).

**Outputs**

- `count` (number): How many there are
- `schedules` (list): The scan schedules

**Example output**

```json
{
  "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 (`status`, text): 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_type`, text): 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_period`, text): Only scans that repeat this often. One of: `one_off` (One off), `daily`, `weekly`, `monthly`, `quarterly`.
- Tags (`tag_names`, list): Only scans of a target with any of these tags.
- Page size (`limit`, number): How many to return, 1 to 100. Intruder's default is 25. From 1 to 100.
- Start at (`offset`, number): Where the page starts: the 'next_offset' of an earlier page. At least 0.

**Outputs**

- `count` (number): How many match, across every page
- `has_more` (true/false): Whether another page follows
- `next_offset` (number): Pass as 'Start at' for the next page; 0 on the last one
- `scans` (list): The scans

**Example output**

```json
{
  "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 (`limit`, number): How many to return, 1 to 100. Intruder's default is 25. From 1 to 100.
- Start at (`offset`, number): Where the page starts: the 'next_offset' of an earlier page. At least 0.

**Outputs**

- `count` (number): How many match, across every page
- `has_more` (true/false): Whether another page follows
- `next_offset` (number): Pass as 'Start at' for the next page; 0 on the last one
- `tags` (list): The tags

**Example output**

```json
{
  "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 (`address`, text): Only targets whose address matches this.
- Tags (`tag_names`, list): Only targets with any of these tags.
- Status (`target_status`, text): Only targets in this state. One of: `live`, `unscanned` (Not scanned yet), `unresponsive`, `license_exceeded` (Licence limit reached), `agent_uninstalled` (Agent uninstalled).
- Type (`target_type`, text): Only targets of this type. One of: `external`, `internal`, `cloud`, `container_image` (Container image).
- Last scanned after (`last_scanned_after`, date): Only targets last scanned after this date.
- Last scanned before (`last_scanned_before`, date): Only targets last scanned before this date.
- Order (`ordering`, text): Sort by when each was last scanned. One of: `-last_scanned` (Most recently scanned first), `last_scanned` (Least recently scanned first).
- Page size (`limit`, number): How many to return, 1 to 100. Intruder's default is 25. From 1 to 100.
- Start at (`offset`, number): Where the page starts: the 'next_offset' of an earlier page. At least 0.

**Outputs**

- `count` (number): How many match, across every page
- `has_more` (true/false): Whether another page follows
- `next_offset` (number): Pass as 'Start at' for the next page; 0 on the last one
- `targets` (list): The targets

**Example output**

```json
{
  "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_id`, text, required): The target. Pick one, or give its id from an earlier step.
- Tag (`tag_name`, text, required): The tag to take off.

**Outputs**

- `removed` (true/false): Always true once removed
- `tag_name` (text): The tag taken off
- `target_id` (number): The target

**Example output**

```json
{
  "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_id`, text, required): The issue. Pick one, or give its id from 'List issues'.
- Occurrence ID (`occurrence_id`, text, required): The occurrence's id, from 'List issue occurrences'.
- Reason (`reason`, text, required): Why it is snoozed. One of: `ACCEPT_RISK` (Risk accepted), `FALSE_POSITIVE` (False positive), `MITIGATING_CONTROLS` (Mitigating controls in place).
- Snooze for (`duration_type`, text): Forever, or a number of days, weeks or months. Defaults to forever. One of: `forever`, `day` (Days), `week` (Weeks), `month` (Months).
- How many (`duration`, number): How many days, weeks or months to snooze it for. Only when Snooze for is Days, Weeks or Months. At least 1.
- Comment (`details`, text): A note saying why, kept with the occurrence.

**Outputs**

- `issue_id` (number): The issue
- `message` (text): What Intruder said
- `occurrence_id` (number): The occurrence
- `snoozed` (true/false): Always true once snoozed

**Example output**

```json
{
  "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_addresses`, list): The target addresses to scan.
- Tags (`tag_names`, list): Scan every target with any of these tags.
- Scan every target (`scan_all_targets`, true/false): Scan every target on the account. Leave off when choosing targets or tags.
- Name (`name`, text): A name for the scan, shown in Intruder.
- Scan gently (`throttled`, true/false): Scan more slowly, for fragile systems that struggle under load.
- Web ports only (`web_ports_only`, true/false): Scan only the common web ports, not every port.

**Outputs**

- `scan` (object): The scan started

**Example output**

```json
{
  "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_id`, text, required): The target. Pick one, or give its id from an earlier step.
- Tag (`tag_name`, text, required): The tag to add, up to 40 characters.

**Outputs**

- `tag_name` (text): The tag added
- `target_id` (number): The target tagged

**Example output**

```json
{
  "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_id`, text, required): The scan schedule. Pick one, or give its id from an earlier step.
- Name (`name`, text): A new name. Leave blank to keep it.
- First scan (`first_scan_time`, date 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_frequency`, text): How often it repeats. Leave blank to keep it. One of: `daily`, `weekly`, `monthly`, `quarterly`.
- Targets (`target_ids`, list): The targets it scans, in place of its own. Leave blank to keep them.
- Tags (`tag_names`, list): The tags it scans, in place of its own. Leave blank to keep them.
- Scan gently (`throttled`, text): Scan more slowly. Leave blank to keep it. One of: `true` (Yes), `false` (No).
- Web ports only (`web_ports_only`, text): Scan only the common web ports. Leave blank to keep it. One of: `true` (Yes), `false` (No).
- Send results to Drata (`upload_to_drata`, text): Upload results to Drata. Leave blank to keep it. One of: `true` (Yes), `false` (No).
- Send results to Vanta (`upload_to_vanta`, text): Upload results to Vanta. Leave blank to keep it. One of: `true` (Yes), `false` (No).

**Outputs**

- `first_scan_time` (text): The first scan time sent, on the hour (ISO 8601 UTC); empty if it wasn't changed
- `notice` (text): What Intruder said
- `schedule_id` (number): The scan schedule's id

**Example output**

```json
{
  "first_scan_time": "",
  "notice": "Scan was updated.",
  "schedule_id": 77
}
```
