Seems like it's missing from the "Repos" docs for v1, v2, and v3...how do I create a branch using the Github API?
See Question&Answers more detail:osSeems like it's missing from the "Repos" docs for v1, v2, and v3...how do I create a branch using the Github API?
See Question&Answers more detail:osThe V3 API mentions branches in its reference page
The ref in the URL must be formatted as
heads/branch
, not justbranch
.
For example, the call to get the data for a branch namedsc/featureA
would be:
GET /repos/:user/:repo/git/refs/heads/sc/featureA
POST /repos/:user/:repo/git/refs
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 thePOST
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!