Skip to main content
POST
/
api
/
projects
/
{projectId}
/
branches
Create branch
curl --request POST \
  --url https://api.example.com/api/projects/{projectId}/branches \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "baseCommitId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "default": true,
  "projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "baseCommitId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "createdById": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "createdBy": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "email": "<string>",
    "firstName": "<string>",
    "lastName": "<string>"
  },
  "changeRequests": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "<string>",
      "type": "<string>",
      "branchId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "createdAt": "2023-11-07T05:31:56Z"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Personal access token is obtained through your profile

Path Parameters

​
projectId
string<uuid>
required

Project ID

Body

application/json
​
name
string
required

Name for the new branch

​
baseCommitId

Base commit ID to branch from, or "base"/"latest" keywords

Response

200 - application/json

The newly created branch

The newly created branch

​
id
string<uuid>
required

Branch ID

​
name
string
required

Branch name

​
default
boolean
required

Whether this is the default (main) branch

​
projectId
string<uuid>
required

Project ID

​
baseCommitId
string<uuid> | null
required

Base commit ID

​
createdById
string<uuid> | null
required

ID of user who created the branch

​
createdAt
string<date-time>
required

Creation timestamp

​
updatedAt
string<date-time>
required

Last update timestamp

​
createdBy
object

User who created the branch

​
changeRequests
object[]

Pending change requests