---
title: "Updates the state of an item."
method: PUT
path: "/items/{itemname}/state"
tags: ["items"]
---

# Updates the state of an item.

`PUT /items/{itemname}/state`

## Path parameters

- `itemname` string, required

## Query parameters

- `source` string

## Headers

- `Accept-Language` string
- `X-OpenHAB-Source` string

## Response `202`

Accepted

## Other responses

- `400` — Item state null
- `404` — Item not found

## Changes

- **2026-02-12** `a3c84e216b33` — 2 info
  - added the new optional `header` request parameter `X-OpenHAB-Source`
  - added the new optional `query` request parameter `source`
- **2025-08-05** `63300d04d170` — 2 warning
  - deleted the `header` request parameter `X-OpenHAB-Source`
  - deleted the `query` request parameter `source`

[Change history](https://skmtc.dev/openhab/apis/openhab-rest-api/changes/items/:itemname/state/put.md)

---

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