SCscanopy
Hosts

Rescan hosts

Changed on

Rescans several hosts at once. Hosts last found by the same daemon share one rescan, which scans all of their addresses in one session; hosts found by different daemons get one rescan per daemon. Every host is checked as in POST /{id}/rescan before any rescan starts, and the request is refused if any of them can't be rescanned.

Returns one session per daemon.

post/api/v1/hosts/bulk-rescan

Request

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

Request body

string[] required

Response

Rescan sessions started, one per daemon

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

  • c94279effef3Revision changes
    • breaking

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

  • 959e33713b20Revision changes
    • 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