Share via


GitHub Gists (Independent Publisher) (Preview)

GitHub Gists enables the authorized user to list, create, update and delete the public gists on GitHub.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Troy Taylor
URL https://www.hitachisolutions.com
Email ttaylor@hitachisolutions.com
Connector Metadata
Publisher Troy Taylor
Website https://docs.github.com/en/rest/gists/gists
Privacy policy https://docs.github.com/en/github/site-policy/github-privacy-statement
Categories Content and Files

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Check for starred gist

Check if a gist is starred.

Create a gist

Allows you to add a new gist with one or more files.

Create gist comment

Create a gist comment.

Delete a gist

Delete a gist.

Delete gist comment

Delete a gist comment.

Fork a gist

Fork a gist.

Get a gist

Retrieve a gist.

Get gist comment

Retrieve a gist comment.

Get gist revision

Retrieve a gist revision.

List gist comments

List all comments for a gist.

List gist commits

Retrieve a list of gist commits.

List gist forks

Retrieve a list of gist forks.

List gists for the authenticated user

Lists the authenticated user's gists or if called anonymously, this endpoint returns all public gists:

List public gists

List public gists sorted by most recently updated to least recently updated.

List starred gists

List the authenticated user's starred gists:

Star gist

Star a gist.

Unstar gist

Unstar a gist.

Update a gist

Allows you to update a gist's description and to update, delete, or rename gist files. Files from the previous version of the gist that aren't explicitly changed during an edit are unchanged.

Update gist comment

Update a gist comment.

Check for starred gist

Check if a gist is starred.

Parameters

Name Key Required Type Description
Gist ID
gist_id True string

The unique identifier of the gist.

Create a gist

Allows you to add a new gist with one or more files.

Parameters

Name Key Required Type Description
Description
description string

Description of the gist

files
files True object

Names and content for the files that make up the gist

Flag
public boolean

Flag indicating whether the gist is public

Returns

Gist Simple

Gist Simple
gist-simple

Create gist comment

Create a gist comment.

Parameters

Name Key Required Type Description
Gist ID
gist_id True string

The unique identifier of the gist.

Text
body True string

The comment text.

Returns

A comment made to a gist.

Gist Comment
gist-comment

Delete a gist

Delete a gist.

Parameters

Name Key Required Type Description
Gist ID
gist_id True string

The unique identifier of the gist.

Delete gist comment

Delete a gist comment.

Parameters

Name Key Required Type Description
Gist ID
gist_id True string

The unique identifier of the gist.

Comment ID
comment_id True integer

The unique identifier of the comment.

Fork a gist

Fork a gist.

Parameters

Name Key Required Type Description
Gist ID
gist_id True string

The unique identifier of the gist.

Returns

Base Gist

Base Gist
base-gist

Get a gist

Retrieve a gist.

Parameters

Name Key Required Type Description
Gist ID
gist_id True string

The unique identifier of the gist.

Returns

Gist Simple

Gist Simple
gist-simple

Get gist comment

Retrieve a gist comment.

Parameters

Name Key Required Type Description
Gist ID
gist_id True string

The unique identifier of the gist.

Comment ID
comment_id True integer

The unique identifier of the comment.

Returns

A comment made to a gist.

Gist Comment
gist-comment

Get gist revision

Retrieve a gist revision.

Parameters

Name Key Required Type Description
Gist ID
gist_id True string

The unique identifier of the gist.

SHA
sha True string

The SHA.

Returns

Gist Simple

Gist Simple
gist-simple

List gist comments

List all comments for a gist.

Parameters

Name Key Required Type Description
Gist ID
gist_id True string

The unique identifier of the gist.

Per Page
per_page integer

The number of results per page (max 100).

Page
page integer

Page number of the results to fetch.

Returns

List gist commits

Retrieve a list of gist commits.

Parameters

Name Key Required Type Description
Gist ID
gist_id True string

The unique identifier of the gist.

Per Page
per_page integer

The number of results per page (max 100).

Page
page integer

Page number of the results to fetch.

Returns

List gist forks

Retrieve a list of gist forks.

Parameters

Name Key Required Type Description
Gist ID
gist_id True string

The unique identifier of the gist.

Per Page
per_page integer

The number of results per page (max 100).

Page
page integer

Page number of the results to fetch.

Returns

List gists for the authenticated user

Lists the authenticated user's gists or if called anonymously, this endpoint returns all public gists:

Parameters

Name Key Required Type Description
Since
since string

Only show notifications updated after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.

Per Page
per_page integer

The number of results per page (max 100).

Page
page integer

Page number of the results to fetch.

Returns

List public gists

List public gists sorted by most recently updated to least recently updated.

Parameters

Name Key Required Type Description
Since
since string

Only show notifications updated after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.

Per Page
per_page integer

The number of results per page (max 100).

Page
page integer

Page number of the results to fetch.

Returns

List starred gists

List the authenticated user's starred gists:

Parameters

Name Key Required Type Description
Since
since string

Only show notifications updated after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.

Per Page
per_page integer

The number of results per page (max 100).

Page
page integer

Page number of the results to fetch.

Returns

Star gist

Star a gist.

Parameters

Name Key Required Type Description
Gist ID
gist_id True string

The unique identifier of the gist.

Unstar gist

Unstar a gist.

Parameters

Name Key Required Type Description
Gist ID
gist_id True string

The unique identifier of the gist.

Update a gist

Allows you to update a gist's description and to update, delete, or rename gist files. Files from the previous version of the gist that aren't explicitly changed during an edit are unchanged.

Parameters

Name Key Required Type Description
Gist ID
gist_id True string

The unique identifier of the gist.

Description
description True string

The description of the gist.

files
files object

The gist files to be updated, renamed, or deleted. Each key must match the current filename (including extension) of the targeted gist file.

Returns

Gist Simple

Gist Simple
gist-simple

Update gist comment

Update a gist comment.

Parameters

Name Key Required Type Description
Gist ID
gist_id True string

The unique identifier of the gist.

Comment ID
comment_id True integer

The unique identifier of the comment.

Text
body True string

The comment text.

Returns

A comment made to a gist.

Gist Comment
gist-comment

Definitions

nullable-simple-user

Simple User

Name Path Type Description
Name
name string

The name.

Email
email string

The email address.

Login
login string

The login.

ID
id integer

The identifier.

Node ID
node_id string

The node identifier.

Avatar URL
avatar_url string

The avatar URL address.

Gravatar ID
gravatar_id string

The Gravatar identifier.

URL
url string

The URL address.

HTML URL
html_url string

The HTML URL address.

Followers URL
followers_url string

The followers URL address.

Following URL
following_url string

The following URL address.

Gists URL
gists_url string

The Gists URL address.

Starred URL
starred_url string

The starred URL address.

Subscriptions URL
subscriptions_url string

The subscriptions URL address.

Organizations URL
organizations_url string

The organizations URL address.

Repos URL
repos_url string

The repos URL address.

Events URL
events_url string

The events URL address.

Received Events URL
received_events_url string

The received events URL address.

Type
type string

The type.

Site Admin
site_admin boolean

The site admin.

Starred At
starred_at string

The starred at.

simple-user

Simple User

Name Path Type Description
Name
name string

The name.

Email
email string

The email address.

Login
login string

The login.

ID
id integer

The identifier.

Node ID
node_id string

The node identifier.

Avatar URL
avatar_url string

The avatar URL address.

Gravatar ID
gravatar_id string

The Gravatar identifier.

URL
url string

The URL address.

HTML URL
html_url string

The HTML URL address.

Followers URL
followers_url string

The followers URL address.

Following URL
following_url string

The following URL address.

Gists URL
gists_url string

The Gists URL address.

Starred URL
starred_url string

The starred URL address.

Subscriptions URL
subscriptions_url string

The subscriptions URL address.

Organizations URL
organizations_url string

The organizations URL address.

Repos URL
repos_url string

The repos URL address.

Events URL
events_url string

The events URL address.

Received Events URL
received_events_url string

The received events URL address.

Type
type string

The type.

Site Admin
site_admin boolean

The site admin.

Starred At
starred_at string

The starred at.

author-association

How the author is associated with the repository.

How the author is associated with the repository.

author_association
string

base-gist

Base Gist

Name Path Type Description
URL
url string

The URL address.

Forks URL
forks_url string

The forks URL address.

Commits URL
commits_url string

The commits URL address.

ID
id string

The identifier.

Node ID
node_id string

The node identifier.

Git Pull URL
git_pull_url string

The Git pull URL address.

Git Push URL
git_push_url string

The Git push URL address.

HTML URL
html_url string

The HTML URL address.

files
files object
Public
public boolean

Whether public.

Created At
created_at string

When created at.

Updated At
updated_at string

When updated at.

Description
description string

The description.

Comments
comments integer

The number of comments.

Comments URL
comments_url string

The comments URL address.

Simple User
owner simple-user

Simple User

Truncated
truncated boolean

Whether truncated.

Forks
forks array of

The forks.

History
history array of

The history.

public-user

Public User

Name Path Type Description
Login
login string

The login.

ID
id integer

The identifier.

Node ID
node_id string

The node identifier.

Avatar URL
avatar_url string

The avatar URL address.

Gravatar ID
gravatar_id string

The Gravatar identifier.

URL
url string

The URL address.

HTML URL
html_url string

The HTML URL address.

Followers URL
followers_url string

The followers URL address.

Following URL
following_url string

The following URL address.

Gists URL
gists_url string

The Gists URL address.

Starred URL
starred_url string

The starred URL address.

Subscriptions URL
subscriptions_url string

The subscriptions URL address.

Organizations URL
organizations_url string

The organizations URL address.

Repos URL
repos_url string

The repos URL address.

Events URL
events_url string

The events URL address.

Received Events URL
received_events_url string

The received events URL address.

Type
type string

The type.

Site Admin
site_admin boolean

The site admin.

Name
name string

The name.

Company
company string

The company.

Blog
blog string

The blog.

Location
location string

The location.

Email
email email

The email address.

Hireable
hireable boolean

Whether hireable.

Bio
bio string

The bio.

Twitter Username
twitter_username string

The Twitter username.

Public Repos
public_repos integer

The number of public repos.

Public Gists
public_gists integer

The number of public Gists.

Followers
followers integer

The number of followers.

Following
following integer

The number following.

Created At
created_at string

When created at.

Updated At
updated_at string

When updated at.

Collaborators
plan.collaborators integer

The number of collaborators.

Name
plan.name string

The name.

Space
plan.space integer

The plan space.

Private Repos
plan.private_repos integer

The number of private repos.

Suspended At
suspended_at string

When suspended at.

Private Gists
private_gists integer

The number of private Gists.

Total Private Repos
total_private_repos integer

The total number of private repos.

Owned Private Repos
owned_private_repos integer

The number of owned private repos.

Disk Usage
disk_usage integer

The disk usage.

Collaborators
collaborators integer

The number of collaborators.

gist-history

Gist History

Name Path Type Description
Version
version string

The version.

Committed At
committed_at string

When committed at.

Total
change_status.total integer

The total.

Additions
change_status.additions integer

The number of additions.

Deletions
change_status.deletions integer

The number of deletions.

URL
url string

The URL address.

gist-simple

Gist Simple

Name Path Type Description
forks
forks array of object
ID
forks.id string

The identifier.

URL
forks.url string

The URL address.

Public User
forks.user public-user

Public User

Created At
forks.created_at string

When created at.

Updated At
forks.updated_at string

When updated at.

history
history array of gist-history
URL
fork_of.url string

The URL address.

Forks URL
fork_of.forks_url string

The forks URL address.

Commits URL
fork_of.commits_url string

The commits URL address.

ID
fork_of.id string

The identifier.

Node ID
fork_of.node_id string

The node identifier.

Git Pull URL
fork_of.git_pull_url string

The Git pull URL address.

Git Push URL
fork_of.git_push_url string

The Git pull URL address.

HTML URL Address
fork_of.html_url string

The HTML URL address.

files
fork_of.files object
Public
fork_of.public boolean

Whether public.

Created At
fork_of.created_at string

When created at.

Updated At
fork_of.updated_at string

When updated at.

Description
fork_of.description string

The description.

Comments
fork_of.comments integer

The comments.

Comments URL
fork_of.comments_url string

The comments URL address.

Simple User
fork_of.owner nullable-simple-user

Simple User

Truncated
fork_of.truncated boolean

Whether truncated.

Forks
fork_of.forks array of

The forks.

History
fork_of.history array of

The history.

URL
url string

The URL address.

Forks URL
forks_url string

The forks URL address.

Commits URL
commits_url string

The commits URL address.

ID
id string

The identifier.

Node ID
node_id string

The node identifier.

Git Pull URL
git_pull_url string

The Git pull URL address.

Git Push URL
git_push_url string

The Git push URL address.

HTML URL
html_url string

The HTML URL address.

files
files object
Public
public boolean

Whether public.

Created At
created_at string

When created at.

Updated At
updated_at string

When updated at.

Description
description string

The description.

Comments
comments integer

The comments.

User
user string

The user.

Comments URL
comments_url string

The comments URL address.

Simple User
owner simple-user

Simple User

Truncated
truncated boolean

Whether truncated.

gist-comment

A comment made to a gist.

Name Path Type Description
ID
id integer

The identifier.

Node ID
node_id string

The node identifier.

URL
url string

The URL address.

Body
body string

The body.

Created At
created_at string

When created at.

Updated At
updated_at string

When updated at.

author_association
author_association author-association

How the author is associated with the repository.

gist-commit

Gist Commit

Name Path Type Description
URL
url string

The URL address.

Version
version string

The version.

Total
change_status.total integer

The total.

Additions
change_status.additions integer

The number of additions.

Deletions
change_status.deletions integer

The number of deletions.

Committed At
committed_at string

When committed at.