v56

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-011,4581,08113.3 MB

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

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

refstring required

node_idstring required

urlstring uri required

Example response

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