---
title: "Creates an application version"
method: POST
path: "/app/{appId}/version"
tags: ["app/version"]
---

# Creates an application version

`POST /app/{appId}/version`

## Path parameters

- `appId` number, required

## Request body

- CreateAppVersion
  - `tools` object[], required — List of tools to include in this version
    - `packageName` string, required — Tool package name
    - `version` string, required — Tool version
  - `changes` string, required — Changelog information for this version

## Response `200`

Successful operation

- AppVersionDef
  - `_id` string, required — Document ID
  - `updatedAt` string, date-time, required — Timestamp when this was last modified
  - `createdAt` string, date-time, required — Timestamp when this was created
  - `appId` number, required — Application ID
  - `version` number, required — Version number
  - `enabled` boolean, required — Whether this version is enabled
  - `changes` string, required — Changelog information for this version

## Other responses

- `400` — Invalid input
- `422` — Validation exception
- `default` — Unexpected error

## Changes

- **2025-06-19** `e514cea423bb` — 2 breaking, 4 info
  - added required request body
  - removed the success response with the status `201`
  - the endpoint scheme security `siweAuth` was removed from the API
  - api tag `app/version` added
  - …2 more

[Change history](https://skmtc.dev/lit-protocol/apis/vincent-registry-api/changes/app/:appId/version/post.md)

---

[API](https://skmtc.dev/lit-protocol/apis/vincent-registry-api.md) · [All operations](https://skmtc.dev/lit-protocol/apis/vincent-registry-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lit-protocol/vincent-registry-api/revisions/e514cea423bb/schema)
