HEhere
Manage Branches

Create a Branch

Changed on

Create a branch, which points to a version of the space or to a version of another branch.

post/spaces/{spaceId}/branches

Request

  • Base URL
    /hub (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /hub/spaces/{spaceId}/branches
  • Auth
    • API key in query parameter access_token
    • or HTTP bearer

Path parameters

spaceIdstring required

The unique identifier of the space.

Request body

idstring

The branch ID. It must be unique per space.

baseRefstring

The reference onto which the branch has been created. A reference describes a target branch and a version within that target branch. References have the following syntax:

[<branchName (optional, default: main)>:][<version (optional, default: HEAD)>]

The "main"-branch is the space itself as it has been created in the first place. Defining the branch as part of the reference only becomes necessary if further branches have been created for the space, which should be addressed by the ref.

Samples:

  • main:42 points to version 42 of the "main"-branch
  • myBranch:37 Points to version 37 of the branch with ID "myBranch"
  • 42 points to version 42 of the "main"-branch
  • myBranch:HEAD points to the latest version of the branch with ID "myBranch"
  • HEAD points to the latest version of the "main"-branch
  • myBranch points to the latest version of the branch with ID "myBranch"

Response

A branch response.

idstring

The branch ID. It must be unique per space.

baseRefstring

The reference onto which the branch has been created. A reference describes a target branch and a version within that target branch. References have the following syntax:

[<branchName (optional, default: main)>:][<version (optional, default: HEAD)>]

The "main"-branch is the space itself as it has been created in the first place. Defining the branch as part of the reference only becomes necessary if further branches have been created for the space, which should be addressed by the ref.

Samples:

  • main:42 points to version 42 of the "main"-branch
  • myBranch:37 Points to version 37 of the branch with ID "myBranch"
  • 42 points to version 42 of the "main"-branch
  • myBranch:HEAD points to the latest version of the branch with ID "myBranch"
  • HEAD points to the latest version of the "main"-branch
  • myBranch points to the latest version of the branch with ID "myBranch"

Changes