Sign in
Daemons
internal

Register a new Daemon

Internal endpoint for daemon self-registration. Creates a host entry and sets up default discovery jobs for the daemon.

post/api/daemons/register

Request body

daemon_idstring uuid required
mode'server_poll' | 'daemon_poll' required

Daemon operating mode that determines the communication pattern.

  • DaemonPoll (formerly "Pull"): Daemon makes outbound connections to the server. The daemon registers itself and polls for work. Best for daemons behind NAT/firewall.

  • ServerPoll (formerly "Push"): Server makes connections to the daemon. Server polls daemon for status and discovery results. Best for DMZ deployments where daemon cannot make outbound connections.

namestring required
network_idstring uuid required
urlstring nullable

URL is ignored by server - kept for backwards compat with old daemons. URL is only set via admin provisioning for ServerPoll daemons.

user_idstring uuid

User responsible for maintaining this daemon (from frontend install command) Optional for backwards compat with old daemons - defaults to nil UUID

versionstring nullable

Daemon software version (optional for backwards compat with old daemons)

Response

Daemon registered successfully

errorstring nullable
successboolean required

Example response

{
  "meta": {
    "api_version": 1,
    "server_version": "0.17.5"
  }
}

Changes