Skip to main content
Gist logo
  • Category: developer tools
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 20
  • Triggers: 0
  • Slug: GIST
  • Version: 20261101_00

Tools

Slug: GIST_CHECK_GIST_STARCheck if the authenticated user has starred a specific gist. Returns True if the gist is starred, False if not starred or if the gist doesn’t exist. This is a read-only, idempotent operation that requires authentication but no special permissions.

Input Parameters

string
required
The unique identifier of the gist to check. Can be a short numeric ID (e.g., ‘1305321’) or a longer alphanumeric hash (e.g., ‘aa5a315d61ae9438b18d’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIST_CREATE_GISTTool to create a new gist with one or more files. Use when you need to create a code snippet or text file to share. Note: Do not name your files ‘gistfile’ with a numerical suffix.

Input Parameters

object
required
Names and content for the files that make up the gist. Each key is a filename (do not name files ‘gistfile’ with a numerical suffix), and each value contains the file content.
boolean
Flag indicating whether the gist is public. Defaults to false (private gist).
string
Description of the gist.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIST_CREATE_GIST_COMMENTTool to create a comment on a gist. Use when you need to add a comment to an existing gist.

Input Parameters

string
required
The comment text to add to the gist.
string
required
The unique identifier of the gist to comment on.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIST_DELETE_GISTDelete a gist by ID. The result reports success for a 404 or 304 as well as a successful deletion, and reports a 403 as unsuccessful.

Input Parameters

string
required
The unique identifier of the gist to delete. Can be a short numeric ID (e.g., ‘1305321’) or a longer alphanumeric hash (e.g., ‘aa5a315d61ae9438b18d’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIST_DELETE_GIST_COMMENTDelete a gist comment by gist ID and comment ID. The result reports success for a 404 as well as a successful deletion, and reports a 403 as unsuccessful.

Input Parameters

string
required
The unique identifier of the gist containing the comment. Obtain this from list_gists or other gist operations.
integer
required
The unique identifier of the comment to delete. Obtain this from list_gist_comments or get_gist_comment operations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIST_FORK_GISTTool to fork a gist. Use when you need to create a copy of an existing gist under your own account.

Input Parameters

string
required
The unique identifier of the gist to fork.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIST_GET_GISTRetrieve a gist by ID, including its file metadata and available contents. File contents or the file list may be truncated.

Input Parameters

string
required
The unique identifier of the gist.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIST_GET_GIST_COMMENTTool to get a specific comment on a gist. Use when you need to retrieve details of a particular comment given gist_id and comment_id.

Input Parameters

string
required
The ID of the gist
integer
required
The ID of the comment

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIST_GET_GIST_REVISIONTool to retrieve a specific gist revision. Use when you need details of a past state for an existing gist by commit SHA.

Input Parameters

string
required
The commit SHA of the desired revision.
string
required
The unique identifier of the gist.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIST_LIST_GIST_COMMENTSTool to list comments on a gist. Use after confirming the gist_id to retrieve comments for a specific gist. Example: ‘List comments for gist abc123’.

Input Parameters

integer
Page number to fetch. Default: 1.
string
required
The ID of the gist to list comments for
integer
Results per page (max 100). Default: 30.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIST_LIST_GIST_COMMITSTool to list the commit history of a gist. Use after you have the gist ID to review its revisions.

Input Parameters

integer
Page number of the results to fetch
string
Response media type. Recommended: application/vnd.github+json
string
required
The unique identifier of the gist to list commits for.
integer
Number of results per page (max 100)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIST_LIST_GIST_FORKSList a page of forks for a gist by ID, with optional pagination.

Input Parameters

integer
Page number to fetch. Default: 1
string
required
The ID of the gist to list forks for
integer
Results per page (max 100). Default: 30

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIST_LIST_GISTSList the authenticated user’s gists, with optional update-time filtering and pagination.

Input Parameters

integer
Page number of results to fetch. Default: 1 if not provided.
string
Only show gists last updated after this ISO 8601 timestamp (YYYY-MM-DDTHH:MM:SSZ)
string
Media type for the response. Example: ‘application/vnd.github+json’
integer
Number of results per page (1-100). Default: 30 if not provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIST_LIST_PUBLIC_GISTSTool to list public gists sorted by most recently updated. Use when you need to discover recent public gists. Note: with pagination, you can fetch up to 3000 gists.

Input Parameters

integer
Page number of results to fetch. Default: 1 if not provided.
string
Only show gists last updated after this ISO 8601 timestamp (YYYY-MM-DDTHH:MM:SSZ)
integer
Number of results per page (1-100). Default: 30 if not provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIST_LIST_STARRED_GISTSList a page of the authenticated user’s starred gists, optionally filtered by update time. Select pages to retrieve additional results.

Input Parameters

integer
Page number of the results to fetch
string
Only list gists updated after this ISO 8601 timestamp (YYYY-MM-DDTHH:MM:SSZ)
string
Response media type. Recommended: application/vnd.github+json
integer
Number of results per page (max 100)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIST_LIST_USER_GISTSTool to list public gists for a specified GitHub user. Use when you have a username and need their gists.

Input Parameters

integer
Page number of results to fetch.
string
Only show gists updated after this ISO 8601 timestamp (YYYY-MM-DDTHH:MM:SSZ)
integer
Number of results per page (1-100).
string
required
The handle for the GitHub user account

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIST_STAR_GISTStar a GitHub gist. This operation is idempotent and will succeed even if the gist is already starred.

Input Parameters

string
required
The unique identifier of the gist to star. Can be a short numeric ID (e.g., ‘1305321’) or a longer alphanumeric hash (e.g., ‘aa5a315d61ae9438b18d’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIST_UNSTAR_GISTUnstar a GitHub gist. The operation is idempotent; a not-found response is also reported as success, so success does not establish that the gist existed.

Input Parameters

string
required
The unique identifier of the gist to unstar. Can be a short numeric ID (e.g., ‘1305321’) or a longer alphanumeric hash (e.g., ‘aa5a315d61ae9438b18d’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIST_UPDATE_GISTTool to update a gist’s description and files. Use when you need to modify gist content, rename files, or delete files from a gist.

Input Parameters

object
The gist files to be updated, renamed, or deleted. Each key must match the current filename (including extension) of the targeted gist file. For example: ‘hello.py’. To delete a file, set the value to null. For example: {‘hello.py’: None}. To update content, provide {‘hello.py’: {‘content’: ‘new content’}}. To rename, provide {‘hello.py’: {‘filename’: ‘goodbye.py’}}.
string
required
The unique identifier of the gist to update.
string
The updated description of the gist.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIST_UPDATE_GIST_COMMENTTool to update a Gist comment. Updates an existing comment on a gist. You must be the author of the comment to update it.

Input Parameters

string
required
The updated text for the comment.
string
required
The ID of the Gist to which the comment belongs.
integer
required
The ID of the comment to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not