List a gist's commits

GET/gists/{uuid}/commits

Lists the commits of a gist's repository, most recent first. Each commit's author is resolved to an Opengist account when one matches the commit email.

Public and unlisted gists are readable by anyone; a private gist resolves only for its owner with a gist:read-capable token, otherwise 404.

Results are a JSON array; pagination is conveyed via the Link and X-* response headers. Unlike the other list endpoints, commits omit X-Total / X-Total-Pages (computing the total would require an extra git call).

Request

Headers

Name	Type	Scopes
`Authorization`optional	`string`

Path parameters

Name	Type	Description
`uuid`required	`string`	The gist's UUID.

Query parameters

Name	Type	Description
`page`	`integer`	Page number, 1-based. (default: 1, min: 1)
`per_page`	`integer`	Items per page. (default: 30, min: 1, max: 100)

Responses

Status	Body	Description
`200`	`GistCommit`[]	A list of commits.
	Headers:`LinkX-PageX-Per-Page`
`404`	`Error`	The requested resource does not exist (or is not visible to the caller).

Request

bash

curl -X GET \
  --url "https://opengist.example.com/api/gists/{uuid}/commits?page=1&per_page=30" \
  -H "Authorization: Bearer og_xxxxxxxx"

Response 200

json

[
  {
    "version": "string",
    "author": {
      "name": "string",
      "email": "string"
    },
    "user": {
      "id": 1,
      "login": "string",
      "username": "string",
      "avatar_url": "https://opengist.example/...",
      "type": "string",
      "created_at": "2024-01-01T00:00:00Z"
    },
    "change_status": {
      "files_changed": 1,
      "additions": 1,
      "deletions": 1,
      "total": 1
    },
    "committed_at": "2024-01-01T00:00:00Z"
  }
]