Rescan host
Starts a one-shot scan of this host's addresses and nothing else, answering "is this host still there, and is its data current?" without sweeping the whole subnet.
The scan runs on the daemon that last discovered this host, which is evidence it can reach the address. Where the daemon has an interface with a MAC on the address's subnet it ARPs the target, which sees a live host even when every port is firewalled. Every other address, on a MAC-less interface (a point-to-point tunnel) or on a subnet the daemon reaches through a router, is probed by TCP. An address that doesn't answer comes back as not found. A loopback address is reached locally and is excluded from the target set.
Daemons at or below last_without_routed_rescan only rescan addresses on
subnets they have an interface on, and the request is refused when the host
has none.
Returns the session, which streams progress over /api/v1/live-updates/stream
like any other scan. A Queued phase means the daemon is busy; it will start
when the running scan finishes.
User API key (Bearer scp_u_...). Create in Platform > API Keys.
In: header
Path Parameters
Host ID
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/api/v1/hosts/497f6eca-6276-4993-bfeb-53cbbbba6f08/rescan"{
"meta": {
"api_version": 1,
"server_version": "0.19.6"
},
"success": true,
"data": {
"daemon_id": "0f0cd6bf-ac90-457b-aa3f-6f24990d5ff6",
"discovery_type": {
"host_id": "eb4e20fc-2b4a-4d0c-811f-48abcf12b89b",
"type": "SelfReport"
},
"phase": "AwaitingSnapshot",
"progress": 0,
"session_id": "1ffd059c-17ea-40a8-8aef-70fd0307db82",
"site_id": "72771e6a-6f5e-4de4-a5b9-1266c4197811",
"credential_results": [
{
"credential_id": "13c40afa-2996-4a0c-b2e9-68fba9462242",
"outcome": {
"hosts": 0,
"type": "Collected",
"hosts_with_guests_listed": [
"d7355285-20ed-4937-93e6-56d490e60d03"
]
}
}
],
"daemon_version": "string",
"discovery_id": "cdd44607-512c-4795-96df-93dabc33c12d",
"error": "string",
"estimated_remaining_secs": 0,
"finished_at": "2019-08-24T14:15:22Z",
"hosts_discovered": 0,
"last_update_at": "2019-08-24T14:15:22Z",
"reason": "Completed",
"scanned": {
"binding_ids": [
"b5aa1d90-55d4-4e37-ab54-062227ec8343"
],
"found_subnet_ids": [
"311dbb38-78e2-42f8-b62c-c104dfb59576"
],
"host_ids": [
"8bbfd9bb-c73d-4ba0-8646-be251d24b410"
],
"interface_ids": [
"513ddd9b-363c-404c-8d2f-e4772a6284ee"
],
"ip_address_ids": [
"c2bc70c8-b7ad-480c-92cd-16dcad15753f"
],
"port_ids": [
"954b3c9b-e9d3-45bb-a4a3-76cf69328728"
],
"service_ids": [
"f7eb01c9-d95f-476e-9338-df56032c0dac"
],
"subnet_ids": [
"942824b1-f36d-4404-96ac-b099828cf934"
],
"vlan_ids": [
"9d54a8f0-0127-444f-984f-03be3c3bb00d"
]
},
"started_at": "2019-08-24T14:15:22Z",
"warnings": [
{
"address": "string",
"code": "InterfaceSetCutShort",
"collected": 0,
"credential_id": "13c40afa-2996-4a0c-b2e9-68fba9462242",
"snmp_version": "V1"
}
]
},
"error": "string"
}{
"meta": {
"api_version": 1,
"server_version": "0.19.6"
},
"success": true,
"code": "string",
"error": "string",
"params": {
"property1": null,
"property2": null
}
}{
"meta": {
"api_version": 1,
"server_version": "0.19.6"
},
"success": true,
"code": "string",
"error": "string",
"params": {
"property1": null,
"property2": null
}
}Product names and logos are trademarks of their respective owners. See credits.
Merge hosts
Merges all IP addresses, ports, and services from the host `other_id` into the host `id`, then deletes `other_id`. Both hosts must be on the same site. ### Merge Behavior - **Interfaces**: Transferred to destination. If an interface with matching subnet+IP or MAC already exists on destination, bindings are remapped to use the existing interface. - **Ports**: Transferred to destination. If a port with the same number and protocol already exists, bindings are remapped to use the existing port. - **Services**: Transferred to destination with deduplication. See [upsert behavior](https://scanopy.net/docs/discovery/#upsert-behavior) for details. ### Restrictions - Cannot merge a host with itself. - Cannot merge away a host that has a daemon - merge into it instead.
Update host
Updates host properties. Children (ip_addresses, ports, services, interfaces) are synced from the fields on this same request body when provided — omit a field to leave that child set untouched. ### Tag Validation - Tags must exist and belong to your organization - Duplicate tag UUIDs are automatically deduplicated - Invalid or cross-organization tag UUIDs return a 400 error