Git Notes

Notes let you attach text to Git objects. Use them to add context like review status, handoff details, or internal decision notes without changing the code itself.

await fetch('/api/v1/repos/notes', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${token}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    sha: commitSha,
    action: 'add',
    note: 'Reviewed. Ready for production.',
  }),
});

Notes work for any Git object SHA you provide. You can read notes back by SHA to retrieve the exact note for a specific commit or object.

"add"    // create or replace a note
"append" // add to an existing note
"remove" // delete the note for a SHA