---
title: "Creates or updates the pending operational dataset"
method: PUT
path: "/node/dataset/pending"
tags: ["node"]
---

# Creates or updates the pending operational dataset

`PUT /node/dataset/pending`

Creates or updates the pending operational dataset on the current node. Delay needs to be set to let
the pending dataset apply as active dataset in the near future.

## Headers

- `If-None-Match` '*'

## Request body

- PendingDataset
  - `activeDataset` union
    - ActiveDataset
      - `activeTimestamp` Timestamp
        - `seconds` integer — Timestamp seconds
        - `ticks` integer — Timestamp ticks
        - `authoritative` boolean
      - `networkKey` string — Network key, 16 bytes long, formatted as a hexadecimal string
      - `networkName` string — Network name, 16 bytes long
      - `extPanId` string — Extended PAN ID, 8 bytes long, formatted as a hexadecimal string
      - `meshLocalPrefix` string — Mesh local IPv6 prefix
      - `panId` integer — IEEE 802.15.4 PAN ID of the Thread network
      - `channel` integer — IEEE 802.15.4 channel of the Thread network
      - `pskc` string — The pre-shared commissioner key
      - `securityPolicy` SecurityPolicy
        - `rotationTime` integer — Thread key rotation time in hours
        - `obtainNetworkKey` boolean — Obtaining the Network Key for out-of-band commissioning is enabled
        - `nativeCommissioning` boolean — Native Commissioning using PSKc is allowed
        - `routers` boolean — Thread 1.0/1.1.x Routers are enabled
        - `externalCommissioning` boolean — External Commissioner authentication is allowed
        - `commercialCommissioning` boolean — Commercial Commissioning is enabled
        - `autonomousEnrollment` boolean — Autonomous Enrollment is enabled
        - `networkKeyProvisioning` boolean — Network Key Provisioning is enabled
        - `tobleLink` boolean — ToBLE link is enabled
        - `nonCcmRouters` boolean — Non-CCM Routers enabled
      - `channelMask` integer — Channel mask
    - string — Operational dataset as hex-encoded TLVs.
  - `pendingTimestamp` Timestamp
    - `seconds` integer — Timestamp seconds
    - `ticks` integer — Timestamp ticks
    - `authoritative` boolean
  - `delay` integer — Delay timer in milliseconds

## Response `200`

Successfully updated the pending operational dataset.

## Other responses

- `201` — Successfully created the pending operational dataset.
- `400` — Invalid request body, or an `If-None-Match` header value other than `*`.
- `412` — A dataset is already in place and the request carried `If-None-Match: *`. Nothing was written; retry without the header to replace the dataset deliberately, or wait until none is in place.
- `500` — The server encountered an unexpected error. The client SHOULD retry after a longer period of time.

## Changes

- **2026-08-26** `bbe4a10dd414` — 2 info
  - added the new optional `header` request parameter `If-None-Match`
  - added the non-success response with the status `412`
- **2026-04-15** `a426fe5c14e1` — 1 warning, 1 info
  - removed the request property `PendingTimestamp`
  - added the new optional request property `pendingTimestamp`
- **2026-02-25** `8c1be192f42d` — 1 breaking, 1 info
  - removed the success response with the status `204`
  - added the success response with the status `200`
- **2025-09-10** `21e4b0112d12` — 1 breaking, 5 warning, 7 info
  - removed the success response with the status `200`
  - removed the request property `ActiveDataset`
  - removed the request property `Delay`
  - removed the request property `PendingTimestamp/Authoritative`
  - …9 more
- **2023-05-10** `54157cc83c30` — 3 warning, 4 info
  - removed the request property `activeDataset`
  - removed the request property `delay`
  - removed the request property `pendingTimestamp`
  - added the new optional request property `ActiveDataset`
  - …3 more

[Change history](https://skmtc.dev/openthread/apis/swagger-openthread-rest-api/changes/node/dataset/pending/put.md)

---

[API](https://skmtc.dev/openthread/apis/swagger-openthread-rest-api.md) · [All operations](https://skmtc.dev/openthread/apis/swagger-openthread-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openthread/swagger-openthread-rest-api/revisions/c3799941c155/schema)