Sample - GitHub REST API
GET/gists/starred

List starred gists

Lists gists that the authenticated user has starred. Use since to return only gists updated after a specified timestamp, and use page and per_page to paginate the results.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

3 parameters
sincestringoptional
Return only gists updated after this timestamp, in ISO 8601 date-time format.
per_pageintegeroptional
Number of results per page, up to 100. Defaults to 30 when omitted.
Default:30
pageintegeroptional
Page number of the results to fetch. Defaults to 1 when omitted.
Default:1

4 status codes
200Returns an array of starred gist objects, including identifiers, URLs, visibility, descriptions, comment counts, files, and timestamps.
urlstringrequired
forks_urlstringrequired
commits_urlstringrequired
idstringrequired
node_idstringrequired
git_pull_urlstringrequired
git_push_urlstringrequired
html_urlstringrequired
filesobjectrequired
publicbooleanrequired
created_atstringrequired
updated_atstringrequired
descriptionstringrequired
commentsintegerrequired
comments_enabledbooleanoptional
userobjectrequired
A GitHub user.
comments_urlstringrequired
ownerobjectoptional
A GitHub user.
truncatedbooleanoptional
forksarrayoptional
historyarrayoptional
304Returned when the starred gist collection has not changed since the request's conditional cache value.
401Returned when authentication is required but missing or invalid.
messagestringoptional
documentation_urlstringoptional
urlstringoptional
statusstringoptional
403Returned when the authenticated user is forbidden from accessing starred gists.
messagestringoptional
documentation_urlstringoptional
urlstringoptional
statusstringoptional

Error handling

A 401 is returned when authentication is missing or invalid. A 403 is returned when the authenticated user is not permitted to access starred gists; provide a valid since timestamp in ISO 8601 date-time format when using that filter.