In this guide

List Branches

Every branch in a repository.

Action referenceRead

What this action does #

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

More about this action

Alphabetical, protected or not. Protected Only narrows it to the branches a protection rule covers — the ones Delete a Branch will refuse.

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.

Owner

RequiredText

User or organisation.

This input offers a picker for repository from your connected account. You can also supply its value directly.

Example value (replace with your own):
octocat

Repository

RequiredText

Name only, without the owner and without .git.

This input offers a picker for repository from your connected account. You can also supply its value directly.

Example value (replace with your own):
Hello-World

Protected Only

OptionalOn or off

True for only protected branches, false for only unprotected ones.

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
namestringThe branch name.
protectedbooleanTrue or false.
commitobjectA group of named values.
commit.shastringThe latest commit on the branch.

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/repos/{owner}/{repo}/branches

Action identifier: github.branches.list.v1

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

InputRequest keyLocation
Ownerownerpath
Repositoryrepopath
Protected Onlyprotectedquery
Page Sizeper_pagequery
Pagepagequery

GitHub API reference