For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
  • DSX Exchange
    • Architecture
    • Pre-Deployment
    • Deployment
    • Integrator Quickstart
    • Operations
    • Authentication
    • BMS Integration
    • Validated Capabilities
  • Schema
      • Overview
        • Publish Managed Host State Change
        • Subscribe Managed Host State Change
      • Messages
      • Schemas
NVIDIANVIDIA
Developer-friendly docs for your API
Privacy Policy | Your Privacy Choices | Terms of Service | Accessibility | Corporate Policies | Product Security | Contact

Copyright © 2026, NVIDIA Corporation.

LogoLogo
On this page
  • Channel
  • Parameters
  • Message: Managed Host State Change
  • Payload
SchemaNICo Host StateOperations

Publish Managed Host State Change

||View as Markdown|
Previous

Overview

Next

Subscribe Managed Host State Change

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 …
Example payload
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}