ScanopyScanopy
Daemons

Test reachability of a daemon URL

Performs a TCP connection test and optionally an HTTP health check to verify that a daemon URL is reachable from the server.

POST
/api/v1/daemons/test-reachability

Authorization

Authorization<token>

User API key (Bearer scp_u_...). Create in Platform > API Keys.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Request to test reachability of a daemon URL.

Response Body

application/json

application/json

curl -X POST "https://example.com/api/v1/daemons/test-reachability" \  -H "Content-Type: application/json" \  -d '{    "url": "string"  }'
{
  "meta": {
    "api_version": 1,
    "server_version": "0.17.14"
  },
  "success": true,
  "data": {
    "reachable": true,
    "error": "string",
    "health": true
  },
  "error": "string"
}
{
  "meta": {
    "api_version": 1,
    "server_version": "0.17.14"
  },
  "success": true,
  "code": "string",
  "error": "string",
  "params": {
    "property1": null,
    "property2": null
  }
}

Retry connection to unreachable daemon

Resets the is_unreachable flag for a daemon that was marked unreachable due to repeated polling failures. The poller will attempt to contact the daemon again on the next cycle.

Update daemon

Edits the server-side daemon record: its name, maintainer, tags, and — for ServerPoll — the url the server dials. Identity and server-managed fields (network, mode, host, key binding, version, liveness) are restored from the existing record by `preserve_immutable_fields`.