Skip to main content
Remove a note from a commit. 
DELETE /api/v1/repos/notes
Authorization: Bearer YOUR_JWT_TOKEN
Content-Type: application/json

{
  "sha": "abc123def456789...",
  "action": "remove",
  "author": {
    "name": "Cleanup Bot",
    "email": "cleanup@example.com"
  },
  "expected_ref_sha": "def789abc123..."
}

​
Request Body

​
sha
string
required
Commit SHA to remove the note from
​
action
string
required
Set to "remove" to delete the note
​
author
string
Object with name and email for the notes commit
​
expected_ref_sha
string
Expected notes ref SHA for optimistic concurrency control

​
JWT Requirements

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

​
Response

{
  "sha": "abc123def456789...",
  "target_ref": "refs/notes/commits",
  "base_commit": "previous123...",
  "new_ref_sha": "newref456...",
  "result": {
    "success": true,
    "status": "ok",
    "message": ""
  }
}

​
Response Fields

​
sha
string
The commit SHA the note was attached to
​
target_ref
string
The notes reference (refs/notes/commits)
​
base_commit
string
Previous notes ref commit SHA
​
new_ref_sha
string
New notes ref SHA after the operation
​
result
object
Operation result with success, status, and optional message

​
Error Responses

​
404 Not Found
string
Note doesn’t exist for the specified commit
​
409 Conflict
string
expected_ref_sha doesn’t match current notes ref
​
401 Unauthorized
string
Invalid JWT or missing git:write scope
​
400 Bad Request
string
Missing required fields