In this guide

List My Gists

Your gists, most recently updated first.

Action referenceRead

What this action does #

First, connect GitHub in Services. Then open Actions → + → GitHub and choose List My Gists.

More about this action

Both public and secret gists, since they are yours either way. File contents are not included in a list — only the file names and metadata. Use Get a Gist for the text.

Needs the Gists account permission, which is granted under Account permissions rather than against any repository.

Inputs to fill in #

Open an input to choose its value. Keep a fixed value with Text, receive it from Shortcuts, ask when the action runs, or use an Earlier Step. Read how input sources work.

Updated After

OptionalText

ISO 8601. Only gists updated at or after this time.

Example value (replace with your own):
2026-09-01T00:00:00Z

Page Size

OptionalWhole number

1–100. GitHub silently clamps anything larger.

Example value (replace with your own):
100

Page

OptionalWhole number

Starts at 1. Bind this to a Shortcuts slot if you want to page from a Repeat loop rather than fetching several pages in one go.

Example value (replace with your own):
1

What comes back #

In the action editor, open Output → Returned Value to choose fields for your shortcut. These are the response fields described by the app; a service may omit an optional field or return an empty list. JSON File contains the full response.

Returned fieldTypeMeaning
idstringThe hash used in every other gist endpoint.
html_urlstringThe page to open or share.
descriptionstringShown as the gist's title. Null when unset.
publicbooleanFalse means unlisted, not private.
commentsintegerWhole-number value.
created_atstringISO 8601.
updated_atstringText value.
truncatedbooleanTrue when a file was too large to include whole.
ownerobjectA group of named values.
owner.loginstringUsername.
owner.idintegerWhole-number value.
owner.html_urlstringTheir profile page.
owner.avatar_urlstringText value.
owner.typestringUser, Organization or Bot.
filesobjectKeyed by file name, so the keys are yours and cannot be listed here. Each value has filename, type, language, size, raw_url and — unless truncated — content.

Run it from Shortcuts #

  1. Give the action a recognizable name and tap Save.
  2. In Apple Shortcuts, add Shortcutify’s Execute Action and select the saved action.
  3. Supply any Param or File slots you bound in the inputs, then run the shortcut.

If the result is unexpected, open Logs in Shortcutify, select the run, and inspect this step’s inputs and response.

This action supports multiple pages of results. Open its Fetch setting to retrieve more pages when one page is not enough. Each page adds a service request.

Advanced reference #

Request, permissions, and identifiers

Request: GET https://api.github.com/gists

Action identifier: github.gists.list.v1

Permissions declared for this action: gists:read. The account’s own access rules also apply.

InputRequest keyLocation
Updated Aftersincequery
Page Sizeper_pagequery
Pagepagequery

GitHub API reference