Create a commit
POST {{baseUrl}}/repos/:owner/:repo/git/commits
Creates a new Git commit object.
In this example, the payload of the signature would be:
Signature verification object
The response will include a verification object that describes the result of verifying the commit's signature. The following fields are included in the verification object:
These are the possible values for reason in the verification object:
| Value | Description |
|---|---|
expired_key | The key that made the signature is expired. |
not_signing_key | The signingflag is not among the usage flags in the GPG key that made the signature. |
gpgverify_error | There was an error communicating with the signature verification service. |
gpgverify_unavailable | The signature verification service is currently unavailable. |
unsigned | The object does not include a signature. |
unknown_signature_type | A non-PGP signature was found in the commit. |
no_user | No user was associated with the committer email address in the commit. |
unverified_email | The committer email address in the commit was associated with a user, but the email address is not verified on her/his account. |
bad_email | The committer email address in the commit is not included in the identities of the PGP key that made the signature. |
unknown_key | The key that made the signature has not been registered with any user's account. |
malformed_signature | There was an error parsing the signature. |
invalid | The signature could not be cryptographically verified using the key whose key-id was found in the signature. |
valid | None of the above errors applied, so the signature is considered to be verified. |
Request Body
{"message"=>"<string>", "tree"=>"<string>", "parents"=>["<string>", "<string>"], "author"=>{"name"=>"<string>", "email"=>"<string>", "date"=>"<string>"}, "committer"=>{"name"=>"<string>", "email"=>"<string>", "date"=>"<string>"}, "signature"=>"<string>"}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string |
RESPONSES
status: Created
{"sha":"7638417db6d59f3c431d3e1f261cc637155684cd","node_id":"MDY6Q29tbWl0NzYzODQxN2RiNmQ1OWYzYzQzMWQzZTFmMjYxY2M2MzcxNTU2ODRjZA==","url":"https://api.github.com/repos/octocat/Hello-World/git/commits/7638417db6d59f3c431d3e1f261cc637155684cd","author":{"date":"2014-11-07T22:01:45Z","name":"Monalisa Octocat","email":"octocat@github.com"},"committer":{"date":"2014-11-07T22:01:45Z","name":"Monalisa Octocat","email":"octocat@github.com"},"message":"my commit message","tree":{"url":"https://api.github.com/repos/octocat/Hello-World/git/trees/827efc6d56897b048c772eb4087f854f46256132","sha":"827efc6d56897b048c772eb4087f854f46256132"},"parents":[{"url":"https://api.github.com/repos/octocat/Hello-World/git/commits/7d1b31e74ee336d15cbd21741bc88a537ed063a0","sha":"7d1b31e74ee336d15cbd21741bc88a537ed063a0"}],"verification":{"verified":false,"reason":"unsigned","signature":null,"payload":null}}