> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/dsx-exchange/llms.txt.
> For full documentation content, see https://docs.nvidia.com/dsx-exchange/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/dsx-exchange/_mcp/server.

# Subscribe Managed Host State Change

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

**Direction:** Subscribe (receive)

## Channel

```text
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 of the state change.                                                                                                                                                                  |
| `managed_host_state` | [ManagedHostState](/dsx-exchange/schema/nico/schemas#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 ... |

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