Subscribe Managed Host State Change

Subscribe to managed host state change events for monitoring, orchestration, and automation purposes.

Direction: Subscribe (receive)

Channel

NICO/v1/machine/{machineId}/state

Parameters

Parameter	Description
`machineId`	Unique identifier for the managed host machine.

Message: Managed Host State Change

Content Type: application/json

Payload

Name	Type	Required	Description
`machine_id`	string	Yes	Unique identifier for the managed host machine.
`timestamp`	string (date-time)	Yes	ISO 8601 timestamp when the state was observed for publishing, including periodic snapshots.
`managed_host_state`	ManagedHostState	Yes	Possible Machine state-machine implementation Possible ManagedHost state-machine implementation Only DPU machine field in DB will contain state. Host will be empty. DPU state field will be used to …

Example payload

{
  "machine_id": "string",
  "timestamp": "2026-05-14T12:00:00Z",
  "managed_host_state": {
    "dpu_states": {
      "states": {
        "key": null
      }
    },
    "state": "dpudiscoveringstate"
  }
}