---
title: "Set current Commissioner state."
method: PUT
path: "/node/commissioner/state"
tags: ["node", "commissioner"]
---

# Set current Commissioner state.

`PUT /node/commissioner/state`

Enable or disable the Commissioner.

## Request body

- string — Can be "enable" or "disable".

## Response `200`

Successful operation.

## Other responses

- `400` — The client sent an invalid request. The client SHOULD perform action(s) to provide valid syntax before retrying the request.
- `409` — Cannot set commissioner state because border router state is not active
- `500` — The server encountered an unexpected error. The client SHOULD retry after a longer period of time.

## Changes

- **2026-02-25** `8c1be192f42d` — 1 breaking
  - removed the success response with the status `204`
- **2025-09-10** `21e4b0112d12` — 2 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `500`
- **2024-12-16** `7d8f31f26205` — 1 info
  - endpoint added
- **2023-05-10** `54157cc83c30` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/openthread/apis/swagger-openthread-rest-api/changes/node/commissioner/state/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)
