v14

latestOpenAPI 3.0.3BSD 3-Clauseraw.githubusercontent.com2026-08-013939103.6 KB

node

Creates or updates the active operational dataset

Creates or updates the the active operational dataset on the current node. Only allowed if the Thread node is inactive. If the Thread node is active, a pending dataset should be used to update the current active operational dataset.

put/node/dataset/active

Request body

networkKeystring

Network key, 16 bytes long, formatted as a hexadecimal string

networkNamestring

Network name, 16 bytes long

extPanIdstring

Extended PAN ID, 8 bytes long, formatted as a hexadecimal string

meshLocalPrefixstring

Mesh local IPv6 prefix

panIdinteger

IEEE 802.15.4 PAN ID of the Thread network

channelinteger

IEEE 802.15.4 channel of the Thread network

pskcstring

The pre-shared commissioner key

channelMaskinteger

Channel mask

Example request

{
  "activeTimestamp": {
    "seconds": 10
  },
  "networkKey": "08277229F21FB7342D705D3CEFDC042A",
  "networkName": "OpenThread-e445",
  "extPanId": "996D3BEE320097A3",
  "meshLocalPrefix": "fd33:d3b9:89e3:72e4::/64",
  "panId": 58437,
  "channel": 21,
  "pskc": "FD943ECA225A28979B991EFAC1218A72",
  "securityPolicy": {
    "rotationTime": 672,
    "obtainNetworkKey": true,
    "nativeCommissioning": true,
    "routers": true,
    "externalCommissioning": true
  },
  "channelMask": 134215680
}

Response

Successfully updated the active operational dataset.