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.

Authorization

Authorization<token>

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

In: header

Path Parameters

id*string

daemon ID

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

host_id*string

The host this entity belongs to.

mode*DaemonMode

How the daemon connects: it polls the server, or the server polls it.

name*string

Human-facing name for this daemon.

network_id*string

The network this entity belongs to.

tags*array<>

Tags assigned to this entity.

url*string

Address the server dials for a ServerPoll daemon. Editable (a daemon can move); unused and not editable for DaemonPoll, which dials out instead. Base URL the server reaches this daemon on.

user_id*string

User responsible for maintaining this daemon

api_key_id?|

Foreign key to API key used for ServerPoll authentication. NULL for DaemonPoll daemons or those not yet linked to a key.

is_unreachable?boolean

Whether the daemon is unreachable (for ServerPoll circuit breaker). Set to true after repeated polling failures, reset via retry-connection endpoint.

version?|

Daemon software version (semver format)

Response Body

`application/json`

curl -X PUT "https://example.com/api/v1/daemons/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{    "host_id": "eb4e20fc-2b4a-4d0c-811f-48abcf12b89b",    "mode": "server_poll",    "name": "string",    "network_id": "d6797cf4-42b9-4cad-8591-9dd91c3f0fc3",    "tags": [      "a424dc99-d215-4281-ad2d-a3a9bc179925"    ],    "url": "https://daemon.example.com:60073",    "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5"  }'

{
  "meta": {
    "api_version": 1,
    "server_version": "0.17.14"
  },
  "success": true,
  "data": {
    "host_id": "eb4e20fc-2b4a-4d0c-811f-48abcf12b89b",
    "mode": "server_poll",
    "name": "string",
    "network_id": "d6797cf4-42b9-4cad-8591-9dd91c3f0fc3",
    "tags": [
      "a424dc99-d215-4281-ad2d-a3a9bc179925"
    ],
    "url": "https://daemon.example.com:60073",
    "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
    "api_key_id": "b0dd218e-3bcf-4bdb-a1e3-0689d60a8afd",
    "is_unreachable": true,
    "last_seen": "2019-08-24T14:15:22Z",
    "standby": true,
    "standby_cleared_at": "2019-08-24T14:15:22Z",
    "version": "0.17.7",
    "created_at": "2019-08-24T14:15:22Z",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "updated_at": "2019-08-24T14:15:22Z"
  },
  "error": "string"
}

{
  "meta": {
    "api_version": 1,
    "server_version": "0.17.14"
  },
  "success": true,
  "code": "string",
  "error": "string",
  "params": {
    "property1": null,
    "property2": null
  }
}

{
  "meta": {
    "api_version": 1,
    "server_version": "0.17.14"
  },
  "success": true,
  "code": "string",
  "error": "string",
  "params": {
    "property1": null,
    "property2": null
  }
}

Authorization

Path Parameters

Request Body

Response Body

200application/json

400application/json

404application/json

`application/json`

`application/json`

`application/json`