---
title: "Sends a command to an item."
method: POST
path: "/items/{itemname}"
tags: ["items"]
---

# Sends a command to an item.

`POST /items/{itemname}`

## Path parameters

- `itemname` string, required

## Query parameters

- `source` string

## Headers

- `X-OpenHAB-Source` string

## Request body

- object
  - `value` string, required

## Response `200`

OK

## Other responses

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

## Changes

- **2026-03-30** `2fb4a551a7c4` — 2 breaking
  - added the new required request property `value`
  - the request's body type/format changed from `string`/`` to `object`/``
- **2026-02-12** `a3c84e216b33` — 3 info
  - added the new optional `header` request parameter `X-OpenHAB-Source`
  - added the new optional `query` request parameter `source`
  - added the media type `application/json` to the request body
- **2025-08-05** `63300d04d170` — 1 breaking, 2 warning
  - removed the media type `application/json` from the request body
  - 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/post.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)