---
title: "POST /v1/project-releases"
method: POST
path: "/v1/project-releases"
tags: ["project-releases"]
---

# POST /v1/project-releases

`POST /v1/project-releases`

## Request body

- union
  - object
    - `type` 'ROLLBACK', required
    - `name` string, required
    - `description` string, nullable
    - `selectedFlowsIds` string[], nullable
    - `projectId` string, required
    - `projectReleaseId` string, required
  - object
    - `type` 'PROJECT', required
    - `name` string, required
    - `description` string, nullable
    - `selectedFlowsIds` string[], nullable
    - `projectId` string, required
    - `targetProjectId` string, required
  - object
    - `type` 'GIT', required
    - `name` string, required
    - `description` string, nullable
    - `selectedFlowsIds` string[], nullable
    - `projectId` string, required

## Response `201`

Default Response

- object
  - `id` string, required
  - `created` string, required
  - `updated` string, required
  - `projectId` string, required
  - `name` string, required
  - `description` string, nullable
  - `importedBy` string, nullable
  - `fileId` string, required
  - `type` union, required
    - 'GIT'
    - 'PROJECT'
    - 'ROLLBACK'
  - `importedByUser` object
    - `id` string, required
    - `email` string, required
    - `firstName` string, required
    - `status` union, required
      - 'ACTIVE'
      - 'INACTIVE'
    - `externalId` string, nullable
    - `platformId` string, nullable
    - `platformRole` union, required
      - 'ADMIN'
      - 'MEMBER'
    - `lastName` string, required
    - `created` string, required
    - `updated` string, required

## Changes

- **2025-01-09** `b6ee827ed6ef` — 1 breaking, 1 info
  - removed `subschema #1, subschema #2, subschema #3` from the request body `anyOf` list
  - added `subschema #1, subschema #2, subschema #3` to the request body `anyOf` list
- **2025-01-09** `022d0770190d` — 1 breaking, 1 info
  - removed `subschema #1, subschema #2, subschema #3` from the request body `anyOf` list
  - added `subschema #1, subschema #2, subschema #3` to the request body `anyOf` list
- **2025-01-09** `92e8f2eba0ee` — 1 breaking, 6 info
  - removed `subschema #1, subschema #2, subschema #3` from the request body `anyOf` list
  - the endpoint scheme security `apiKey` was added to the API
  - added `subschema #1, subschema #2, subschema #3` to the request body `anyOf` list
  - added the optional property `importedByUser/externalId` to the response with the `201` status
  - …3 more
- **2024-12-31** `3c05b427e5b5` — 1 info
  - endpoint added
- **2023-12-03** `7b0cc60eed56` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/activeboxes/apis/activeboxes-documentation/changes/v1/project-releases/post.md)

---

[API](https://skmtc.dev/activeboxes/apis/activeboxes-documentation.md) · [All operations](https://skmtc.dev/activeboxes/apis/activeboxes-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/activeboxes/activeboxes-documentation/revisions/12c564515962/schema)