Skip to main content
POST
/
scan
/
multiple-ips
Scan Multiple IPs via Schedule Context
curl --request POST \
  --url https://api.altostrat.io/scans/cve/scan/multiple-ips \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "schedule_id": "d4e5f6a7-b8c9-0123-4567-890abcdef012",
  "site_id": "c3d4e5f6-a7b8-9012-3456-7890abcdef01",
  "ips": [
    "192.168.1.101",
    "192.168.1.105"
  ]
}'
{
  "scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "scan_site_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "target_ips": [
    "127.0.0.1"
  ],
  "message": "Scan started successfully"
}

Authorizations

​
Authorization
string
header
required

Authentication token obtained via Altostrat platform login.

Body

application/json

Data required to initiate an immediate scan for a list of IP addresses associated with a specific site and schedule context.

​
schedule_id
string<uuid>
required

The UUID of the Scan Schedule providing context (e.g., credentials, settings).

Example:

"d4e5f6a7-b8c9-0123-4567-890abcdef012"

​
site_id
string<uuid>
required

The UUID of the site associated with the IPs and the schedule.

Example:

"c3d4e5f6-a7b8-9012-3456-7890abcdef01"

​
ips
string<ipv4>[]
required

An array of IPv4 addresses to scan.

Minimum length: 1
Example:
["192.168.1.101", "192.168.1.105"]

Response

Multiple IP scan initiated successfully.

Response confirming the initiation of a scan for multiple specific IPs.

​
scan_id
string<uuid>

The unique ID assigned to the parent scan instance.

​
scan_site_id
string<uuid>

The unique ID assigned to the scan operation for this specific site.

​
target_ips
string<ipv4>[]

The list of IP addresses targeted for this scan.

​
message
string
Example:

"Scan started successfully"

⌘I