Skip to main content
Git notes allow you to attach metadata to commits without modifying the commit itself. Notes are removed from refs/notes/commits by default. Pass ref to delete the note from another notes ref. See Git Notes for notes ref rules and write behavior.

Options

string
required
Commit SHA to remove the note from
string
Notes ref to delete the note from. Accepts short names like reviews, notes/reviews, or full refs like refs/notes/reviews; all are normalized to a full refs/notes/* ref. Defaults to refs/notes/commits. Go: Ref.
string
Author signature (name and email)
string
Expected SHA of the target notes ref for optimistic concurrency control
string
Token TTL. Token TTL in seconds.
object[]
Ordered per-ref policy rules ({ pattern, ops? }) embedded in the per-call JWT. Evaluated against the target notes ref. Python: ref_policies. Go: RefPolicies with type storage.RefPolicyList. See the Branch Protection guide.

Response

string
The commit SHA the note was attached to
string
The canonical notes ref that was updated
string
Previous notes ref commit SHA
string
New notes ref SHA after the operation
object
Operation result with success, status, and optional message