---
title: "Create or update app version"
method: POST
path: "/app-version"
tags: ["app-version"]
---

# Create or update app version

`POST /app-version`

Creates a new app version or updates existing one for a platform. If version exists for platform, it will be updated.

## Request body

- CreateAppVersionDto
  - `platform` 'android' | 'ios', required — Platform (android or ios)
  - `version` string, required — Current app version (e.g., "1.0.0")
  - `minimum_required_version` string — Minimum required version for force update (optional)
  - `is_force_update` boolean — Force update flag
  - `release_notes` string — Release notes (optional)

## Response `200`

App version created/updated successfully

- AppVersionResponseDto
  - `app_version_id` number, required — App version ID
  - `platform` 'android' | 'ios', required — Platform
  - `version` string, required — Current app version
  - `minimum_required_version` string — Minimum required version
  - `is_force_update` boolean, required — Force update flag
  - `release_notes` string — Release notes
  - `created_at` string, date-time, required — Created at timestamp
  - `updated_at` string, date-time, required — Updated at timestamp

## Other responses

- `400` — Bad Request
- `401` — Unauthorized - Invalid or missing JWT token

---

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