Skip to main content
GET
/
api
/
repos
/
{repo_name}
/
commits
List Commits
curl --request GET \
  --url https://api.{cluster}.code.storage/api/repos/{repo_name}/commits \
  --header 'Authorization: Bearer <token>'
{
  "commits": [
    {
      "author_email": "jane@example.com",
      "author_name": "Jane Doe",
      "committer_email": "jane@example.com",
      "committer_name": "Jane Doe",
      "date": "2024-01-15T14:32:18Z",
      "message": "fix: resolve scrolling issue in dashboard",
      "sha": "b003fc78805954584e1ee364a4ad39d7c79e819a"
    }
  ],
  "has_more": true,
  "next_cursor": "20"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
repo_name
string
required

Repository name. Names that contain / or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example pierre/example is sent as pierre%2Fexample. Plain names such as example can be sent as-is. The server URL-decodes the value before resolving the repository.

Query Parameters

​
branch
string

Optional branch name to list commits from. When omitted, the repository default branch is used.

​
path
string

Optional repository-relative path to scope the history to commits that touched that path.

​
cursor
string

Pagination cursor returned by a previous list_commits response.

​
limit
integer
default:20

Maximum number of commits to return. Defaults to 20.

​
ephemeral
boolean

Whether branch should be resolved from the ephemeral namespace.

Response

Commit history ordered from newest to oldest.

Paginated commit history for the repository, optionally filtered by branch.

​
commits
object[]
required

List of commit objects.

​
has_more
boolean
required

Whether more commits exist.

Example:

true

​
next_cursor
string

Opaque cursor for the next page (absent when no more results).

Example:

"20"