---
title: "Create Changelog Version"
method: POST
path: "/v1/changelog/version"
tags: ["changelog"]
---

# Create Changelog Version

`POST /v1/changelog/version`

## Request body

- ChangelogVersionCreate
  - `version` string, required — Version number (e.g., 1.2.3)
  - `release_date` string, date-time, nullable — Release date
  - `entries` ChangelogEntryBatchItem[], required
    - `change_type` 'added' | 'changed' | 'fixed' | 'removed' | 'security' | 'deprecated' | 'improved', required
    - `title` string, required — Short title of the change
    - `description` string, nullable — Detailed description
    - `is_user_facing` boolean — Whether change is user-facing
    - `sort_order` integer — Order within version

## Response `200`

Successful Response

- ChangelogVersionResponse
  - `version` string, required
  - `release_date` string, date-time, nullable, required
  - `changes` object, required

## Other responses

- `422` — Validation Error

---

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