GitHub

GitHub Gists API

The GitHub Gists API lets you programmatically manage gistslightweight code snippets and notesover HTTP. You can create gists (public or secret/unlisted), read individual gists, list public gists, your own, a users, and those youve starred, fetch raw file contents, view version history and commits, update gists by adding/renaming/removing files or changing descriptions, and delete them. It also supports forking, starring/un-starring and checking star status, plus full CRUD for gist comments.

Documentation GitHub OpenAPI

Operations 20

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /gists List my gists · GitHub List Gists for the Authenticated User #

Ask an LLM

“Which gists have I created?”

“Can I see only the gists I've updated since last week?”

Tell an agent

List my gists.

Show my gists updated since {since}.

POST /gists Create a gist · GitHub Create a Gist #

Ask an LLM

“How do I share a code snippet as a new gist?”

“Can I create a secret gist that holds several files?”

Tell an agent

Create a new gist with files {files}.

Create a gist described as {description} containing {files}, public set to {public}.

GET /gists/public List recent public gists from everyone · GitHub List Public Gists #

Ask an LLM

“What public gists have people shared most recently?”

“Can I browse all public gists posted after a certain date?”

Tell an agent

List the most recent public gists from all users.

Show public gists posted since {since}.

GET /gists/starred List gists I've starred · GitHub List Starred Gists #

Ask an LLM

“Which gists have I starred?”

“Can I find the snippets I bookmarked with a star since a given date?”

Tell an agent

List the gists I've starred.

Show my starred gists updated since {since}.

GET /gists/{gist_id} Get a gist and its files · GitHub Get a Gist #

Ask an LLM

“What files and content are inside a particular gist?”

“Can I fetch the current version of a gist by its ID?”

Tell an agent

Show me gist {gist_id}.

Get the files and contents of gist {gist_id}.

PATCH /gists/{gist_id} Update a gist's description or files · GitHub Update a Gist #

Ask an LLM

“Can I edit the files in a gist I already posted?”

“Is it possible to rename or remove a file inside an existing gist?”

Tell an agent

Change the description of gist {gist_id} to {description}.

Update the files in existing gist {gist_id} to {files}.

DELETE /gists/{gist_id} Delete a gist · GitHub Delete a Gist #

Ask an LLM

“How do I delete a gist I no longer need?”

“Can I remove a gist I posted by mistake?”

Tell an agent destructive · confirm first

Delete gist {gist_id}.

Permanently remove my gist {gist_id}.

GET /gists/{gist_id}/comments List comments on a gist · GitHub List Gist Comments #

Ask an LLM

“What have people commented on a gist?”

“Can I read the full discussion under a gist?”

Tell an agent

List the comments on gist {gist_id}.

Show the discussion under gist {gist_id}.

POST /gists/{gist_id}/comments Comment on a gist · GitHub Create a Gist Comment #

Ask an LLM

“How can I leave a comment on someone's gist?”

“Can I reply to a gist with a note?”

Tell an agent

Comment {body} on gist {gist_id}.

Post a new comment on gist {gist_id} saying {body}.

GET /gists/{gist_id}/comments/{comment_id} Get one gist comment · GitHub Get a Gist Comment #

Ask an LLM

“What does a specific comment on a gist say?”

“Can I fetch a single gist comment by its ID?”

Tell an agent

Show comment {comment_id} on gist {gist_id}.

Get the text of gist {gist_id} comment {comment_id}.

PATCH /gists/{gist_id}/comments/{comment_id} Edit a gist comment · GitHub Update a Gist Comment #

Ask an LLM

“Can I fix a typo in a comment I already posted on a gist?”

“Is editing an existing gist comment supported?”

Tell an agent

Change comment {comment_id} on gist {gist_id} to say {body}.

Edit my existing gist comment {comment_id} on {gist_id} with new text {body}.

DELETE /gists/{gist_id}/comments/{comment_id} Delete a gist comment · GitHub Delete a Gist Comment #

Ask an LLM

“Can I delete a comment I left on a gist?”

“What's the way to remove an unwanted comment from my gist?”

Tell an agent destructive · confirm first

Delete comment {comment_id} from gist {gist_id}.

Remove gist {gist_id} comment {comment_id}.

GET /gists/{gist_id}/commits List a gist's revision history · GitHub List Gist Commits #

Ask an LLM

“How has a gist changed over time — what commits does it have?”

“Can I see who edited a gist and when?”

Tell an agent

List the commits of gist {gist_id}.

Show the revision history of gist {gist_id}.

GET /gists/{gist_id}/forks List forks of a gist · GitHub List Gist Forks #

Ask an LLM

“Who has forked a particular gist?”

“Can I see all the copies people made of my gist?”

Tell an agent

List the forks of gist {gist_id}.

Show everyone who forked gist {gist_id}.

POST /gists/{gist_id}/forks Fork a gist · GitHub Fork a Gist #

Ask an LLM

“How do I make my own copy of someone else's gist?”

“Can I fork a gist so I can edit it separately?”

Tell an agent

Fork gist {gist_id} into my account.

Make my own copy of gist {gist_id}.

GET /gists/{gist_id}/star Check whether I've starred a gist · GitHub Check if a Gist is Starred #

Ask an LLM

“Have I already starred a given gist?”

“Is this gist among my stars?”

Tell an agent

Check whether I've starred gist {gist_id}.

Tell me if gist {gist_id} is in my stars.

PUT /gists/{gist_id}/star Star a gist · GitHub Star a Gist #

Ask an LLM

“Can I star a gist to find it again later?”

“What's the call to bookmark a gist with a star?”

Tell an agent

Star gist {gist_id}.

Add gist {gist_id} to my starred gists.

DELETE /gists/{gist_id}/star Unstar a gist · GitHub Unstar a Gist #

Ask an LLM

“How do I take my star off a gist?”

“Can I remove a gist from my starred list?”

Tell an agent destructive · confirm first

Unstar gist {gist_id}.

Remove gist {gist_id} from my stars.

GET /gists/{gist_id}/{sha} Get a specific revision of a gist · GitHub Get a Gist Revision #

Ask an LLM

“What did a gist look like at an earlier commit?”

“Can I fetch an older version of a gist by its revision SHA?”

Tell an agent

Show gist {gist_id} as it was at revision {sha}.

Get the files of gist {gist_id} at commit {sha}.

GET /users/{username}/gists List another user's public gists · GitHub List Gists for a User #

Ask an LLM

“What public gists has a particular user shared?”

“Can I see someone's gists updated since a certain date?”

Tell an agent

List the public gists of {username}.

Show gists by {username} updated since {since}.

GitHub Gists API

Operations 20

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification