Github API - create branch?

The V3 API mentions branches in its reference page

The ref in the URL must be formatted as heads/branch, not just branch.
For example, the call to get the data for a branch named sc/featureA would be:

GET /repos/:user/:repo/git/refs/heads/sc/featureA

Create a Reference

POST /repos/:user/:repo/git/refs

Parameters

ref

String of the name of the fully qualified reference (ie: refs/heads/master). If it doesn’t start with ‘refs’ and have at least two slashes, it will be rejected.

sha

String of the SHA1 value to set this reference to

So it should be possible to create a new branch, by naming a new '/heads' in the ref parameter.

Potherca points out to a working test, using the service of www.hurl.it (which makes HTTP requests)

  • Find the revision you want to branch from.
    Either on Github itself or by doing a GET request from Hurl:

    https://api.github.com/repos/<AUTHOR>/<REPO>/git/refs/heads

  • Copy the revision hash

  • Do a POST request from Hurl to https://api.github.com/repos/<AUTHOR>/<REPO>/git/refs with the following as the POST body :

      {
      "ref": "refs/heads/<NEW-BRANCH-NAME>",
      "sha": "<HASH-TO-BRANCH-FROM>"
  }

    (obviously replacing the <NEW-BRANCH-NAME> with the name your want the new branch to have and the <HASH-TO-BRANCH-FROM> with, you know, the hash of the revision you want to branch from)

    You will need to use HTTP basic and fill in your Github credentials to access the Github API.

  • Press the Send button and your branch will be created!

In 2022, you can also use gh api

gh api \
  --method POST \
  -H "Accept: application/vnd.github.v3+json" \
  /repos/OWNER/REPO/git/refs \
  -f ref='refs/heads/featureA'
 -f sha='aa218f56b14c9653891f9e74264a383fa43fefbd'

Adding to @VonC answer, here is working snippet in python.

import requests
headers = {'Authorization': "Token " + 'YOUR_TOKEN_HERE'}
url = "https://api.github.com/repos/<USERNAME>/<REPO>/git/refs/heads"
branches = requests.get(url, headers=headers).json()
branch, sha = branches[-1]['ref'], branches[-1]['object']['sha']
res = requests.post('https://api.github.com/repos/<USERNAME>/<REPO>/git/refs', json={
    "ref": "refs/heads/newbranch",
    "sha": sha
}, headers=headers)
print(res.content)

This is a common problem for all the students when we create API for creating a branch in GitHub

{
  "message": "Not Found",
  "documentation_url": "https://developer.github.com/v3"
}

For solving this error during create repository in Github.....

  1. First create a personal token in

    Github=>setting=>developerOption=>generatePersonalToken...

                     or

    during gitLogin bu Oauth when you pass client_id that time you pass scope=repo(Because it's allow all the Repository when you used token or anything)

  2. After that: hit the API(get)

    https://api.github.com/repos/<your login name>/<Your Repository Name>/git/refs/heads

  3. You got a response which is like

    Response => {
[
{
    "ref": "refs/heads/<already present branch name for ref>",
    "node_id": "jkdhoOIHOO65464edg66464GNLNLnlnnlnlna==",
    "url": " https://api.github.com/repos/<your login name>/<Your Repository Name>/git/refs/heads/<already present branch name for ref>",
    "object": {
        "sha": "guDSGss85s1KBih546465kkbNNKKbkSGyjes56",
        "type": "commit",
        "url": " https://api.github.com/repos/<your login name>/<Your Repository Name>/git/commits/guDSGss85s1KBih546465kkbNNKKbkSGyjes56"
    }
}
]
}

  4. Complete this process again hit API (Post)

    https://api.github.com/repos/Bhupi2508/Test/git/refs...

    And send data in JSON format like this:

    {
    "ref": "refs/heads/<new branch name>",
    "sha": "4661616ikgohlKIKHBK4634GRGSD66"
}

    THEN YOU CREATE A BRANCH IN GITHUB By APIs

    And the process for Delete Branch hit only DELETE (first) APIs

Tags:

Git

Github

Recent Posts