List public gists for a user | GitHub API (unofficial showcase)

4 parameters

usernamestringrequired

The handle for the GitHub user account whose public gists to list.

sincestringoptional

Return gists updated after this timestamp in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).

per_pageintegeroptional

Number of results per page, up to 100. Defaults to 30 when omitted.

Default:30

pageintegeroptional

Page number of the results to retrieve. Defaults to 1 when omitted.

Default:1

2 status codes

200Returns an array of public gist objects, including each gist's identifier, URLs, files, visibility, description, comment count, 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

422Returned when query validation fails or the endpoint has been spammed.

messagestringrequired

documentation_urlstringrequired

errorsarray<object>optional

Error handling

A 422 is returned when query validation fails or the endpoint has been spammed. The username path parameter identifies the user whose gists you want, since must use ISO 8601 date-time format, and per_page cannot exceed 100.

import { Client } from "@octridev/github";

const client = new Client({
  baseUrl: "https://api.github.com",
});

const result = await client.gists.list({
  username: "octocat",
  since: "example",
  perPage: 20,
  page: 1,
});

[
  {
    "url": "https://api.github.com/gists/aa5a315d61ae9438b18d",
    "forks_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/forks",
    "commits_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/commits",
    "id": "aa5a315d61ae9438b18d",
    "node_id": "MDQ6R2lzdGFhNWEzMTVkNjFhZTk0MzhiMThk",
    "git_pull_url": "https://gist.github.com/aa5a315d61ae9438b18d.git",
    "git_push_url": "https://gist.github.com/aa5a315d61ae9438b18d.git",
    "html_url": "https://gist.github.com/aa5a315d61ae9438b18d",
    "files": {
      "hello_world.rb": {
        "filename": "hello_world.rb",
        "type": "application/x-ruby",
        "language": "Ruby",
        "raw_url": "https://gist.githubusercontent.com/octocat/6cad326836d38bd3a7ae/raw/db9c55113504e46fa076e7df3a04ce592e2e86d8/hello_world.rb",
        "size": 167
      }
    },
    "public": true,
    "created_at": "2010-04-14T02:15:15Z",
    "updated_at": "2011-06-20T11:34:15Z",
    "description": "Hello World Examples",
    "comments": 0,
    "user": null,
    "comments_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/comments/",
    "owner": {
      "login": "octocat",
      "id": 1,
      "node_id": "MDQ6VXNlcjE=",
      "avatar_url": "https://github.com/images/error/octocat_happy.gif",
      "gravatar_id": "",
      "url": "https://api.github.com/users/octocat",
      "html_url": "https://github.com/octocat",
      "followers_url": "https://api.github.com/users/octocat/followers",
      "following_url": "https://api.github.com/users/octocat/following{/other_user}",
      "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
      "organizations_url": "https://api.github.com/users/octocat/orgs",
      "repos_url": "https://api.github.com/users/octocat/repos",
      "events_url": "https://api.github.com/users/octocat/events{/privacy}",
      "received_events_url": "https://api.github.com/users/octocat/received_events",
      "type": "User",
      "site_admin": false
    },
    "truncated": false
  }
]

Request

Response

Errors