Branches

Create a new branch

Changed on Oct 31, 2026

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

The document declares no server URL.
Auth
none declared

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"
}

Changes

Oct 31, 2026ff9684af2aad Revision changes
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
Oct 29, 2026f17f5df4e79c Revision changes
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status

Operation history (5 revisions)