Skip to main content

Options

string
required
Branch name (without refs/heads/) that receives the reset commit.
string
required
Commit SHA to reset the branch back to. Commits after this point are undone.
string
required
Provide name and email for the commit author.
string
Commit SHA that must match the current tip. Use to avoid races.
string
Custom message. Defaults to Reset <branch> to "<target subject>".
string
Provide name and email. If omitted, the author identity is reused.
object[]
Ordered per-ref policy rules ({ pattern, ops? }) embedded in the per-call JWT. First match wins. Python: ref_policies. Go: RefPolicies with type storage.RefPolicyList. See the Branch Protection guide.

Response

string
The SHA of the reset commit
string
The SHA of the commit’s tree object
string
The branch that received the reset
number
Size of the pack in bytes
object
Contains branch, oldSha/old_sha (previous tip, 000000... if new), and newSha/new_sha (reset commit)