---
title: "Changes to Create an item"
method: POST
path: "/v1/items/"
---

# Changes to Create an item

`POST /v1/items/`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 24 revisions.

- **2026-10-22** `f961bea3a9a4`: 4 breaking, 5 info
- **2026-10-20** `ed6f9d39b4eb`: 1 info
- **2026-10-20** `f02252438dd3`: 6 info
- **2026-10-20** `afc3c2c753ba`: 6 info
- **2026-10-20** `175c7ae12486`: 2 info
- **2026-10-15** `2505c2f21875`: 1 info

## Changes

- **2026-10-22** `f961bea3a9a4`: 4 breaking, 5 info
  - the `default_duration` request property format changed from `int32` to no format
  - the `default_duration/anyOf[subschema #1]/` request property format changed from no format to `int32`
  - the `variants/anyOf[subschema #1]/items/duration` request property format changed from `int32` to no format
  - the `variants/anyOf[subschema #1]/items/duration/anyOf[subschema #1]/` request property format changed from no format to `int32`
  - added the new optional request property `options/anyOf[subschema #1]/items/id`
  - added the new optional request property `price_overrides/anyOf[subschema #1]/items/id`
  - added the new optional request property `variants/anyOf[subschema #1]/items/id`
  - the `oneOf[subschema #1: ProductItem]/taxes/items/percentage` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was removed for the status `201`
  - the `oneOf[subschema #2: ServiceItem]/taxes/items/percentage` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was removed for the status `201`
- **2026-10-20** `ed6f9d39b4eb`: 1 info
  - added the new optional request property `variants/anyOf[subschema #1]/items/location_availability`
- **2026-10-20** `f02252438dd3`: 6 info
  - added the new optional request property `default_cost_price`
  - added the new optional request property `variants/anyOf[subschema #1]/items/cost_price`
  - added the required property `oneOf[subschema #1: ProductItem]/default_cost_price` to the response with the `201` status
  - added the required property `oneOf[subschema #1: ProductItem]/variants/items/cost_price` to the response with the `201` status
  - added the required property `oneOf[subschema #2: ServiceItem]/default_cost_price` to the response with the `201` status
  - added the required property `oneOf[subschema #2: ServiceItem]/variants/items/cost_price` to the response with the `201` status
- **2026-10-20** `afc3c2c753ba`: 6 info
  - added the new optional request property `default_duration`
  - added the new optional request property `variants/anyOf[subschema #1]/items/duration`
  - added the required property `oneOf[subschema #1: ProductItem]/default_duration` to the response with the `201` status
  - added the required property `oneOf[subschema #1: ProductItem]/variants/items/duration` to the response with the `201` status
  - added the required property `oneOf[subschema #2: ServiceItem]/default_duration` to the response with the `201` status
  - added the required property `oneOf[subschema #2: ServiceItem]/variants/items/duration` to the response with the `201` status
- **2026-10-20** `175c7ae12486`: 2 info
  - added the optional property `oneOf[subschema #1: ProductItem]/variants/items/location_availability` to the response with the `201` status
  - added the optional property `oneOf[subschema #2: ServiceItem]/variants/items/location_availability` to the response with the `201` status
- **2026-10-15** `2505c2f21875`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/yoco/apis/yoco-api/docs/v1/items/post.md) - [API](https://skmtc.dev/yoco/apis/yoco-api.md) - [Page](https://skmtc.dev/yoco/apis/yoco-api/changes/v1/items/post)