Hosts

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.

post/api/v1/hosts/{id}/rescan

Request

  • Base URL
    https://app.scanopy.net
  • URL
    https://app.scanopy.net/api/v1/hosts/{id}/rescan
  • Auth
    • API key in header Authorization
    • or API key in cookie session_id

Path parameters

idstring uuid required

Host ID

Response

Rescan session started

errorstring nullable

Not sent on a successful response. Failure messages arrive in an ApiErrorResponse.

successboolean required

Always true on a successful response.

Example response

{
  "data": {
    "warnings": [
      {
        "daemon_version": "0.18.0",
        "last_unsupported_daemon_version": "0.18.0"
      }
    ]
  },
  "meta": {
    "api_version": 1,
    "server_version": "0.19.4"
  }
}

Changes

    • breaking

      added subschema #56 to the // response property oneOf list for the response status

    • warning

      added the new DaemonDroppedSession enum value to the ///// response property for the response status

    • warning

      added the new DaemonOffline enum value to the ///// response property for the response status

    • warning

      added the new SessionSilent enum value to the ///// response property for the response status