SCscanopy
Discoveries

Start discovery sessions

Changed on

Starts a session for each discovery, as POST /start-session does for one. Sessions start in turn: on a daemon running several, the first is dispatched and the rest queue behind it. The request is refused, and nothing starts, if any discovery is a past run, a rescan, or already running.

post/api/v1/discoveries/bulk-start-session

Request

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

Request body

string[] required

Response

Sessions started, in the order given

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