---
title: "POST /api/v1/items"
method: POST
path: "/api/v1/items"
---

# POST /api/v1/items

`POST /api/v1/items`

## Request body

- CreateItemRequest
  - `name` string, required

## Response `200`

service.v1.Service.CreateItem response

- Item
  - `id` string, uuid, required
  - `type` 'ITEM_TYPE_UNSPECIFIED' | 'ITEM_TYPE_BASIC', required
  - `name` string, required
  - `createdAt` string, date-time, required — Datetime when item was created.
  - `mapWithString` object
  - `mapWithInt32` object
  - `mapWithInt64` object
  - `mapWithUint32` object
  - `mapWithUint64` object
  - `mapWithInt32Key` object
  - `mapWithInt64Key` object
  - `mapWithUint32Key` object
  - `mapWithUint64Key` object
  - `mapWithInt32Value` object
  - `mapWithInt64Value` object
  - `mapWithUint32Value` object
  - `mapWithUint64Value` object
  - `mapWithMessageValue` object

## Changes

- **2025-05-26** `6d563160abb6` — 14 info
  - added the optional property `mapWithInt32` to the response with the `200` status
  - added the optional property `mapWithInt32Key` to the response with the `200` status
  - added the optional property `mapWithInt32Value` to the response with the `200` status
  - added the optional property `mapWithInt64` to the response with the `200` status
  - …10 more
- **2023-05-20** `03416220e72f` — 1 breaking, 4 info
  - the request property `name` became required
  - the response property `createdAt` became required for the status `200`
  - the response property `id` became required for the status `200`
  - the response property `name` became required for the status `200`
  - …1 more
- **2023-05-20** `c22a496b7a51` — 5 breaking, 1 info
  - request body became required
  - the response property `createdAt` became optional for the status `200`
  - the response property `id` became optional for the status `200`
  - the response property `name` became optional for the status `200`
  - …2 more
- **2023-05-07** `90df74f89a5e` — 1 info
  - added the required property `createdAt` to the response with the `200` status
- **2023-05-07** `cc660ba01149` — 1 info
  - added the required property `type` to the response with the `200` status

[Full history](https://skmtc.dev/ogen-go/apis/generated-openapi-specification-from-proto-file/changes/api/v1/items/post.md)

---

[API](https://skmtc.dev/ogen-go/apis/generated-openapi-specification-from-proto-file.md) · [All operations](https://skmtc.dev/ogen-go/apis/generated-openapi-specification-from-proto-file/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ogen-go/generated-openapi-specification-from-proto-file/revisions/d7715c41ad8e/schema)