---
title: "🔒 Создание новой версии продукта."
method: POST
path: "/projects/version/create"
tags: ["Projects: Versions"]
---

# 🔒 Создание новой версии продукта.

`POST /projects/version/create`

## Request

- Base URL: `http://localhost`
- URL: `http://localhost/projects/version/create`
- Auth: one of:
  - API key in header `sid` and API key in header `rts` and API key in header `sig`
  - HTTP bearer

Создание новой версии продукта.

**Access:** `authorized` (10 ) · **Scope:** `write`

**Allows:** `version:create` (все обязательны; ресурс — `productID`)

### TypeScript (copy-paste)

**`POST /projects/version/create`**

<details open><summary><b>Body (Partial)</b></summary>

```typescript
// Patch-body: все поля опциональны (Valid.Patch)
export type ProjectsVersionCreateBody = Partial<Version>

export interface ProjectsVersionCreateBodyFields {
  cID?: string
  projectID?: string
  productID?: string
  ID?: string
  title?: string
  major?: number
  minor?: number
  build?: number | null
  resolvedBugs?: Record<string, any> | null
  notes?: string
  isDone?: boolean
  isPublished?: boolean
  releaseDT?: string | null
  design?: {
  fileUrl?: string | null
} | null
  createDT?: string
  updateDT?: string
  isDeleted?: boolean | null
  deletedTS?: number | null
  /** Unix timestamp in milliseconds */
  updTS?: number
  updUID?: string
}
```

</details>

<details open><summary><b>Response</b></summary>

```typescript
export type ProjectsVersionCreateResponse = IServerResponse<Version>

export interface IServerResponse<T = any> {
  code: number
  data: T
  srvTS: number
  rkey: string
}
```

</details>

> Полный файл типов: [`/docs/types`](/docs/types) · raw: [`/docs/api-types.ts`](/docs/api-types.ts)

## Headers

- `devID` string, uuid, required
- `tz` string, required
- `app` string, required
- `appVer` string, required
- `rKey` string

## Request body

- ProjectsVersionCreateBody: Partial body (Valid.Patch) for `projects/version/create` — все поля опциональны
  - `cID` string, uuid
  - `projectID` string, uuid
  - `productID` string, uuid
  - `ID` string, uuid
  - `title` string
  - `major` integer
  - `minor` integer
  - `build` integer, nullable
  - `resolvedBugs` object, nullable
  - `notes` string
  - `isDone` boolean
  - `isPublished` boolean
  - `releaseDT` string, date-time, nullable
  - `design` object, nullable
    - `fileUrl` string, nullable
  - `createDT` string, date-time
  - `updateDT` string, date-time
  - `isDeleted` boolean, nullable
  - `deletedTS` integer, nullable
  - `updTS` integer: Unix timestamp in milliseconds
  - `updUID` string

## Response `200`

OK — `IServerResponse<Version>`

- object
  - `code` integer, required
  - `data` Version, required: Entity `Version` (table: Version )
    - `cID` string, uuid, required
    - `projectID` string, uuid, required
    - `productID` string, uuid, required
    - `ID` string, uuid, required
    - `title` string, required
    - `major` integer, required
    - `minor` integer, required
    - `build` integer, nullable
    - `resolvedBugs` object, nullable
    - `notes` string, required
    - `isDone` boolean, required
    - `isPublished` boolean, required
    - `releaseDT` string, date-time, nullable
    - `design` object, nullable
      - `fileUrl` string, nullable
    - `createDT` string, date-time, required
    - `updateDT` string, date-time, required
    - `isDeleted` boolean, nullable
    - `deletedTS` integer, nullable
    - `updTS` integer, required: Unix timestamp in milliseconds
    - `updUID` string, required
  - `srvTS` integer, required: Server timestamp (ms)
  - `rkey` string, required: Request key

## Other responses

- `400`: BadRequest / Validation — неверные params/body/headers
- `401`: Unauthorized: Active user session required
- `403`: AccessNotAllowed: Privilege version:create required or the product is archived
- `406`: TimeResync — расхождение rts с сервером
- `422`: UnprocessableContent: Missing productID, or version with same ID or version numbers (major, minor, build) already exists

---

[API](https://skmtc.dev/kosmodrom/apis/kosmodrom-backend-api.md) · [All operations](https://skmtc.dev/kosmodrom/apis/kosmodrom-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kosmodrom/apis/kosmodrom-backend-api/revisions/a143b51ba29a?raw)
