repos.commits.get

Resolve a branch name, short SHA, or full SHA to a commit and return the same metadata shape used in commit listings. Use this when you need commit details without computing a diff.

Scope: git:read on the repository.

GET /api/repos/{repo_name}/commit

TypeScript

TypeScript

import { Pierre } from '@pierre/sdk';

// The client reads PIERRE_ORG and PIERRE_PRIVATE_KEY.
const pierre = new Pierre();

const commit = await pierre.repos.commits.get({
  repo_name: 'my-demo-repository',
  ref: 'main',
});
console.log(commit);

200

{
  "commit": {
    "author_email": "[e-mail]",
    "author_name": "Jane Doe",
    "committer_date": "2024-01-16T09:05:41Z",
    "committer_email": "[e-mail]",
    "committer_name": "Jane Doe",
    "date": "2024-01-15T14:32:18Z",
    "message": "fix: resolve scrolling issue in dashboard",
    "parent_shas": [
      "f4f9df3b8db66c73f6bf67e8f8f4f14f6522731e"
    ],
    "sha": "b003fc78805954584e1ee364a4ad39d7c79e819a",
    "signature": "-----BEGIN PGP SIGNATURE-----\n...\n-----END PGP SIGNATURE-----\n"
  }
}

Authorizations

Authorization · string · header · required

JWT bearer token signed with your organization's registered signing key. There is no OAuth authorization server; you mint tokens yourself and the token's scopes claim carries the granted permission scopes. Public scopes: git:read (read repository contents), git:write (write branches, commits, tags, and notes), repo:write (create and manage repositories), org:read (list an organization's repositories). Each operation's security requirement names the scopes it requires. See https://code.storage/docs/getting-started/authentication for how to mint tokens.

Path Parameters

repo_name · string · required

The repository name, for example acme/web.

Query Parameters

ref · string

Branch name, tag, full commit SHA, short SHA, or other revision Git can resolve. Provide ref or the deprecated sha.

sha · string

Deprecated: use ref instead. Commit SHA, short SHA, branch name, or other revision Git can resolve.

Response

200

application/json

Commit metadata for the resolved revision.

Commit metadata for a single resolved revision, without diff content.

commit · object · required

Resolved commit metadata.

Show child attributes