SchemaNICo Host StateOperations

Publish Managed Host State Change

View as Markdown

Publish managed host state change events when a host transitions between states in the lifecycle.

Direction: Publish (send)

Channel

NICO/v1/machine/{machineId}/state

Parameters

ParameterDescription
machineIdUnique identifier for the managed host machine.

Message: Managed Host State Change

Content Type: application/json

Payload

NameTypeRequiredDescription
machine_idstringYesUnique identifier for the managed host machine.
timestampstring (date-time)YesISO 8601 timestamp of the state change.
managed_host_stateManagedHostStateYesPossible 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 …
1{
2  "machine_id": "string",
3  "timestamp": "2026-05-14T12:00:00Z",
4  "managed_host_state": {
5    "dpu_states": {
6      "states": {
7        "key": null
8      }
9    },
10    "state": "dpudiscoveringstate"
11  }
12}