git

Create a reference

Creates a reference for your repository. You are unable to create new references for empty repositories, even if the commit SHA-1 hash used exists. Empty repositories are repositories without branches.

post/repos/{owner}/{repo}/git/refs

Request

  • Base URL: https://api.github.com
  • URL: https://api.github.com/repos/{owner}/{repo}/git/refs
  • Auth: none declared

Path parameters

ownerstring required

The account owner of the repository. The name is not case sensitive.

repostring required

The name of the repository without the .git extension. The name is not case sensitive.

Request body

refstring required

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.

shastring required

The SHA1 value for this reference.

Response

Response

refstring required
node_idstring required
urlstring uri required

Example response

{
  "object": {
    "sha": "7638417db6d59f3c431d3e1f261cc637155684cd"
  }
}

Changes

No recorded changes to this operation across all 83 revisions of this API.