Get a note corresponding to a single commit from a repository

GET

/repos/{owner}/{repo}/git/notes/{sha}

const url = 'https://gitea.com/api/v1/repos/example/example/git/notes/example';
const options = {method: 'GET', headers: {Authorization: 'Basic <credentials>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://gitea.com/api/v1/repos/example/example/git/notes/example \
  --header 'Authorization: Basic <credentials>'

Authorizations

Parameters

Path Parameters

owner

required

string

Owner of the repo

repo

required

string

Name of the repo

sha

required

string

A git ref or commit sha

Query Parameters

verification

boolean

Include verification for every commit (disable for speedup, default ‘true’)

files

boolean

Include a list of affected files for every commit (disable for speedup, default ‘true’)

Responses

200

Note

application/json

Note contains information related to a git note

object

commit

Commit contains information generated from a Git commit.

object

author

User represents a user

object

active

Is user active

boolean

avatar_url

URL to the user’s avatar

string

created

string format: date-time

description

The user’s description

string

email

string format: email

followers_count

User counts

integer format: int64

following_count

integer format: int64

full_name

The user’s full name

string

html_url

URL to the user’s gitea page

string

The user’s id

integer format: int64

is_admin

Is the user an administrator

boolean

language

User locale

string

last_login

string format: date-time

location

The user’s location

string

login

string

login_name

Identifier of the user, provided by the external authenticator (if configured)

string

default: empty

prohibit_login

Is user login prohibited

boolean

restricted

Is user restricted

boolean

source_id

The ID of the user’s Authentication Source

integer format: int64

starred_repos_count

integer format: int64

visibility

User visibility level option: public, limited, private

string

website

The user’s website

string

commit

RepoCommit contains information of a commit in the context of a repository.

object

author

CommitUser contains information of a user in the context of a commit.

object

date

Date is the commit date in string format

string

email

string format: email

name

Name is the person’s name

string

committer

CommitUser contains information of a user in the context of a commit.

object

date

Date is the commit date in string format

string

email

string format: email

name

Name is the person’s name

string

message

Message is the commit message

string

tree

CommitMeta contains meta information of a commit in terms of API.

object

created

string format: date-time

sha

SHA is the commit SHA hash

string

url

URL is the API URL for the commit

string

url

URL is the API URL for the commit

string

verification

PayloadCommitVerification represents the GPG verification of a commit

object

payload

The signed payload content

string

reason

The reason for the verification status

string

signature

The GPG signature of the commit

string

signer

PayloadUser represents the author or committer of a commit

object

email

string format: email

name

Full name of the commit author

string

username

Username of the user

string

verified

Whether the commit signature is verified

boolean

committer

User represents a user

object

active

Is user active

boolean

avatar_url

URL to the user’s avatar

string

created

string format: date-time

description

The user’s description

string

email

string format: email

followers_count

User counts

integer format: int64

following_count

integer format: int64

full_name

The user’s full name

string

html_url

URL to the user’s gitea page

string

The user’s id

integer format: int64

is_admin

Is the user an administrator

boolean

language

User locale

string

last_login

string format: date-time

location

The user’s location

string

login

string

login_name

Identifier of the user, provided by the external authenticator (if configured)

string

default: empty

prohibit_login

Is user login prohibited

boolean

restricted

Is user restricted

boolean

source_id

The ID of the user’s Authentication Source

integer format: int64

starred_repos_count

integer format: int64

visibility

User visibility level option: public, limited, private

string

website

The user’s website

string

created

string format: date-time

files

Files contains information about files affected by the commit

Array<object>

CommitAffectedFiles store information about files affected by the commit

object

filename

Filename is the path of the affected file

string

status

Status indicates how the file was affected (added, modified, deleted)

string

html_url

HTMLURL is the web URL for viewing the commit

string

parents

Parents contains the parent commit information

Array<object>

CommitMeta contains meta information of a commit in terms of API.

object

created

string format: date-time

sha

SHA is the commit SHA hash

string

url

URL is the API URL for the commit

string

sha

SHA is the commit SHA hash

string

stats

CommitStats is statistics for a RepoCommit

object

additions

Additions is the number of lines added

integer format: int64

deletions

Deletions is the number of lines deleted

integer format: int64

total

Total is the total number of lines changed

integer format: int64

url

URL is the API URL for the commit

string

message

The content message of the git note

string

Example

{
  "commit": {
    "author": {
      "login_name": "empty"
    },
    "committer": {
      "login_name": "empty"
    }
  }
}

404

APINotFound is a not found empty response

application/json

422

APIValidationError is error format response related to input validation

application/json

Headers

message

string

url

string