Versions

Create a new version

Creates a new version in the given project. Optionally accepts settings (referenced versions, repository settings, visibility) to fully configure the version in a single call. When the idempotentKey query parameter is provided, returns an existing version with the same key instead of creating a duplicate.

post/projects/{projectId}/versions

Request

Query parameters

idempotentKeystring

Optional idempotency key. If a version with this key already exists in the project, that version is returned instead of creating a new one.

Request body

namestring required
versionNumberstring

Explicit version number to use for this version instead of deriving it from the version name.

visibility'VISIBLE' | 'HIDDEN'

Controls version visibility in lists and pickers. Defaults to VISIBLE.

Example request

{
  "name": "My project",
  "versionNumber": "1.0.7",
  "referencedVersions": [
    {
      "project": {
        "id": "KXPRJ49GQYFQ5RR9KRTPWTRTC39YZ9W"
      },
      "version": {
        "id": "KXPRJ49GQYFQ5RR9KRTPWTRTC39YZ9W"
      }
    }
  ],
  "repositorySettings": [
    {
      "url": "https://github.com/Ketryx/test-project-js"
    }
  ]
}

Response

OK

idstring

Changes

No recorded changes to this operation across all 1 revision of this API.