Restore commit

POST /api/v1/repos/restore-commit

Create a new commit that resets a branch back to a specific commit SHA.

POST /api/v1/repos/restore-commit
Authorization: Bearer YOUR_JWT_TOKEN
Content-Type: application/x-ndjson

{"metadata":{"target_branch":"main","target_commit_sha":"abc123...","commit_message":"Reset branch","author":{"name":"Docs Bot","email":"[e-mail]"}}}

Request Format

Send a single metadata object.

Metadata Fields

Parameter	Type	Description
target_branch	Required	Branch name to reset (no refs/ prefix).
target_commit_sha	Required	Commit SHA to reset the branch to.
author	Required	Object with name and email.
expected_head_sha	Optional	Guard to ensure the current tip matches before applying.
commit_message	Optional	Commit message for the restore commit.
committer	Optional	Object with name and email.

JWT Requirements

• The JWT must include the repository in the repo claim
• Requires git:write scope

Response

{
  "commit": {
    "commit_sha": "def456...",
    "tree_sha": "7890ab...",
    "target_branch": "main",
    "pack_bytes": 1234
  },
  "result": {
    "branch": "main",
    "old_sha": "abc123...",
    "new_sha": "def456...",
    "success": true,
    "status": "ok",
    "message": ""
  }
}

Error Responses

Status	Description
400 Bad Request	Missing or invalid fields
401 Unauthorized	Invalid JWT or missing authorization header
403 Forbidden	Missing git:write scope
404 Not Found	Repository or commit not found
409 Conflict	Expected head SHA does not match