Sign in

v51

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-08-01131107332.8 KB
Branches

Create a new branch

Creates a new branch for the artifact. A new branch consists of metadata and a list of versions.

This operation can fail for the following reasons:

  • No artifact with this groupId and artifactId exists (HTTP error 404)
  • A branch with the given branchId already exists (HTTP error 409)
  • A server error occurred (HTTP error 500)
post/groups/{groupId}/artifacts/{artifactId}/branches

Request body

descriptionstring
branchIdstring required

The ID of a single artifact branch.

versionsVersion[]

Example request

{
  "branchId": "1.0.x",
  "description": "The description of the branch."
}

Response

Branch successfully created.

groupIdstring required

An ID of a single artifact group.

artifactIdstring required

The ID of a single artifact.

branchIdstring required

The ID of a single artifact branch.

createdOnstring date-time required
modifiedBystring required
modifiedOnstring date-time required
ownerstring required
descriptionstring
systemDefinedboolean required

Example response

{
  "groupId": "ExampleGroup",
  "artifactId": "ExampleArtifact",
  "branchId": "1.0.x",
  "description": "Just an example branch.",
  "systemDefined": false,
  "createdOn": "2018-02-10T09:30Z",
  "modifiedBy": "user1",
  "modifiedOn": "2020-02-10T09:30Z",
  "owner": "user2"
}