GitHub is a code hosting platform for version control and collaboration, offering Git-based repository management, issue tracking, and continuous integration features
GitHub is a code hosting platform for version control and collaboration, offering Git-based repository management, issue tracking, and continuous integration features On Nagent, GitHub is exposed as a fully-configurable developer tools integration that any agent can call — 867 actions, 46 triggers, and OAuth authentication. No code is required to wire GitHub into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use GitHub to automate the kinds of tasks developer tools teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
GitHub also supports 4 event triggers ("New Workflow Artifact Created", "Branch Changed", "New Branch Created", and more), which lets your Nagent agents react to GitHub activity in real time — for example, kicking off a downstream workflow the moment a relevant event fires.
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire GitHub into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Triggers are the entry points of agents built on Nagent — pick one to fire your agent the moment a GitHub event happens. Webhook triggers run instantly; poll triggers check on an interval you configure. Each shows its configuration parameters and the payload your agent receives.
GITHUB_ARTIFACT_CREATED_TRIGGERTriggers when a new workflow artifact is created in a GitHub repository. Monitors for newly created GitHub Actions workflow artifacts. Optionally filters by artifact name to restrict monitoring to specific artifacts.
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
Optional artifact name filter. When set, only artifacts whose name exactly matches this value will be reported. Leave blank to monitor all artifacts in the repository.
GitHub username or organisation that owns the repository (e.g. 'octocat' or 'microsoft').
Repository name without the .git extension (e.g. 'Hello-World' or 'my-project').
Payload
URL to download the artifact as a zip archive.
Unique numeric identifier of the newly created artifact.
ISO 8601 timestamp of when the artifact was created.
SHA-256 digest of the artifact (only present for artifacts uploaded with upload-artifact v4 or later).
Type of event that occurred.
Whether the artifact has expired and is no longer available.
ISO 8601 timestamp of when the artifact will expire.
Name of the artifact.
GraphQL node ID of the artifact.
Owner of the repository.
Repository name.
Size of the artifact in bytes.
ISO 8601 timestamp of when the artifact was last updated.
API URL for the artifact.
Metadata about the workflow run that produced the artifact.
GITHUB_BRANCH_CHANGED_TRIGGERTriggers when a GitHub branch changes. Monitors a specific branch for: - New commits pushed (head commit SHA changes) - Protection status toggled (branch becomes protected or unprotected) - Protection settings changed, including: required status checks and their enforcement level, admin enforcement, required pull request reviews (dismiss stale reviews, code owner reviews, approving review count, last push approval), required linear history, force push allowance, deletion allowance, conversation resolution, branch locking, and fork syncing.
Configuration
The exact name of the branch to monitor (e.g. 'main' or 'develop'). The name is case-sensitive and must match exactly what is shown in the repository.
Periodic Interval to Check for Updates & Send a Trigger in Minutes
GitHub username or organisation that owns the repository (e.g. 'octocat' or 'microsoft').
Repository name without the .git extension (e.g. 'Hello-World' or 'my-service').
Payload
Name of the monitored branch.
Names of the top-level fields that changed.
Snapshot of the branch's tracked fields after the change.
Type of event that occurred.
The current head commit SHA of the branch.
Owner of the repository.
Snapshot of the branch's tracked fields before the change.
Whether the branch is currently protected.
Repository name.
GITHUB_BRANCH_CREATED_TRIGGERTriggers when a new branch is created in a GitHub repository. Detects newly created branches. Deleted branches do not fire events.
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
The account owner of the repository (GitHub username or organization name). Must contain only alphanumeric characters and hyphens, max 39 characters.
The name of the repository without the .git extension. Must contain only alphanumeric characters, hyphens, underscores, and periods.
Payload
SHA of the HEAD commit on the new branch.
GitHub REST API URL for the HEAD commit on the new branch.
The name of the newly created branch.
Whether the branch has branch-protection rules enabled.
Name of the repository the branch belongs to.
GitHub username or organization that owns the repository.
GITHUB_CHECK_RUN_STATUS_CHANGED_TRIGGERTriggers when a specific GitHub check run changes its status or conclusion. Monitors a single check run for changes to: status (queued, in_progress, completed, etc.), conclusion (success, failure, neutral, cancelled, skipped, timed_out, action_required), started_at, and completed_at.
Configuration
The unique numeric identifier of the check run to monitor. You can obtain it from the check runs list API or from the CI/checks page in the GitHub UI.
Periodic Interval to Check for Updates & Send a Trigger in Minutes
The account owner of the repository (username or organization name). Case-insensitive. Must contain only alphanumeric characters and hyphens.
The name of the repository without the .git extension. Case-insensitive.
Payload
GitHub App that created the check run.
List of field names that changed since the last poll.
The ID of the check suite this check run belongs to.
ISO 8601 timestamp when the check run completed.
The conclusion of a completed check run: success, failure, neutral, cancelled, skipped, timed_out, or action_required.
URL providing detailed information about the check run.
The external identifier for the check run set by the integrator.
The SHA of the commit this check run targets.
The GitHub URL to view this check run.
The unique numeric ID of the check run.
The name of the check run.
The GraphQL node ID of the check run.
Output details for a GitHub check run.
Previous string-serialized values of the changed fields.
The name of the repository the check run belongs to.
The owner of the repository the check run belongs to.
ISO 8601 timestamp when the check run started.
The current status of the check run: queued, in_progress, completed, waiting, requested, or pending.
The REST API URL for this check run.
GITHUB_CHECK_SUITE_STATUS_CHANGED_TRIGGERTriggers when a GitHub check suite changes its status or conclusion for a given ref. Monitors all check suites associated with a git reference (branch, tag, or commit SHA) for changes to status (queued, in_progress, completed, etc.) and conclusion (success, failure, neutral, cancelled, skipped, timed_out, action_required, startup_failure, stale). Optionally filters by GitHub App ID.
Configuration
Optional: Filters check suites by GitHub App ID. Only monitor check suites created by this specific app. If omitted, all check suites for the ref are monitored.
Periodic Interval to Check for Updates & Send a Trigger in Minutes
The account owner of the repository (username or organization name). Case-insensitive. Must contain only alphanumeric characters and hyphens.
The git reference (branch name, tag name, or commit SHA) to monitor check suites for. For example, 'main', 'v1.0.0', or a full commit SHA.
The name of the repository without the .git extension. Case-insensitive.
Payload
GitHub App associated with a check suite.
List of field names that changed since the last poll.
The API URL to retrieve the check runs in this suite.
The overall conclusion of the completed check suite: success, failure, neutral, cancelled, skipped, timed_out, action_required, startup_failure, or stale. Null if not yet completed.
ISO 8601 timestamp when this check suite was created.
The branch name the check suite belongs to.
The SHA of the head commit being checked.
The unique numeric ID of the check suite.
The number of check runs in this check suite.
The GraphQL node ID of the check suite.
Previous string-serialized values of the changed fields.
The git reference (branch/tag/SHA) that was monitored.
The name of the repository this check suite belongs to.
The owner of the repository this check suite belongs to.
The current phase of the check suite lifecycle: queued, in_progress, completed, waiting, requested, or pending.
ISO 8601 timestamp when this check suite was last updated.
The REST API URL for this check suite.
GITHUB_CODE_SCANNING_ALERT_CREATED_TRIGGERTriggers when a new code scanning alert is created in a repository. Fires an event for each newly created code scanning alert detected in the configured repository. Alerts can be filtered by Git reference, scanning tool, state, and severity. The payload includes the alert number, rule details, tool information, state, severity, and the location of the most recent instance.
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
The account owner of the repository (GitHub username or organization name). The name is not case sensitive.
Optional Git reference to filter alerts by. For a branch use 'refs/heads/<branch name>' or just the branch name. For a pull request use 'refs/pull/<number>/merge'. Leave empty to get alerts across all refs (default branch).
The name of the repository without the .git extension. The name is not case sensitive.
Optional filter by alert severity. Possible values: 'critical', 'high', 'medium', 'low', 'warning', 'note', 'error'. Leave empty to include alerts of all severities.
Optional filter by alert state. Possible values: 'open', 'closed', 'dismissed', 'fixed'. Leave empty to include alerts in all states.
Optional name of a code scanning tool to filter alerts by (e.g. 'CodeQL', 'Semgrep'). Leave empty to include alerts from all tools.
Payload
The unique sequential number identifying the alert within the repository.
The REST API URL of the alert resource.
ISO 8601 timestamp when the alert was created.
ISO 8601 timestamp when the alert was dismissed. Null if not dismissed.
Reason for dismissal: 'false positive', "won't fix", or 'used in tests'.
ISO 8601 timestamp when the alert was fixed. Null if not fixed.
The GitHub web URL of the alert.
REST API URL to retrieve all instances of this alert.
Commit SHA where the most recent instance was detected.
Description of the vulnerability from the most recent instance.
File path of the most recent instance location.
The Git ref where the most recent instance was detected.
Start line of the most recent instance location.
State of the most recent instance: 'open', 'dismissed', or 'fixed'.
The name of the repository.
The GitHub username or organization that owns the repository.
The rule that triggered the code scanning alert.
Current state of the alert: 'open', 'closed', 'dismissed', or 'fixed'.
The code scanning tool that generated the alert.
ISO 8601 timestamp when the alert was last updated.
GITHUB_COLLABORATOR_ADDED_TRIGGERTriggers when a new collaborator is added to a GitHub repository. Monitors the full list of collaborators on a repository and fires an event for each newly added collaborator. The payload includes the collaborator's GitHub username, account ID, profile URL, avatar URL, permission flags (pull, triage, push, maintain, admin), and assigned role name.
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
The account owner of the repository (username or organization name). Must contain only alphanumeric characters and hyphens, max 39 characters.
The name of the repository without the .git extension. Must contain only alphanumeric characters, hyphens, underscores, and periods.
Payload
URL of the collaborator's avatar image.
GitHub profile URL of the collaborator.
The unique numeric ID of the collaborator's GitHub account.
The GitHub username of the new collaborator.
GraphQL global node identifier for the collaborator.
Permission flags granted to the collaborator on this repository.
The name of the repository.
The owner of the repository.
The role name assigned to the collaborator (e.g., 'admin', 'maintain', 'write', 'triage', 'read').
Whether the collaborator is a GitHub site administrator.
The type of GitHub account (e.g., 'User', 'Organization').
REST API URL for the collaborator's user resource.
GITHUB_COMMIT_EVENTTriggered when a new commit is pushed to a repository.
Configuration
Owner of the repository
Repository name
Payload
The GitHub username of the commit author
The SHA of the commit
The commit message
The timestamp of the commit
The GitHub URL of the commit
GITHUB_DEPLOYMENT_CREATED_TRIGGERTriggers when a new deployment is created in a GitHub repository. Fires an event for each newly created deployment detected in the configured repository. Deployments can optionally be filtered by target environment. The payload includes the deployment ID, commit SHA, ref, task, environment, creator details, and timestamps.
Configuration
Optional filter: only fire for deployments targeting this environment (e.g. 'production', 'staging', 'Preview'). Leave empty to receive events for all environments.
Periodic Interval to Check for Updates & Send a Trigger in Minutes
GitHub username or organisation that owns the repository (e.g. 'octocat' or 'microsoft').
Repository name without the .git extension (e.g. 'Hello-World' or 'vscode').
Payload
ISO 8601 timestamp when the deployment was created.
Numeric ID of the creator.
GitHub login of the user or bot that created the deployment.
Account type of the creator (e.g. 'User', 'Bot').
Unique numeric identifier for the deployment.
A short description of the deployment.
The name of the environment the deployment targets (e.g. 'production').
Type of event that occurred.
Global Node ID for the deployment.
The original environment of the deployment before any overrides.
Owner of the repository.
Whether this deployment targets the production environment.
The short ref name or full SHA of the deployment's target.
Repository name.
API URL for the repository the deployment belongs to.
The SHA of the commit that was deployed.
API URL to list deployment statuses.
The name of the task that was used for the deployment (e.g. 'deploy').
Whether this is a transient environment (destroyed on inactivity).
ISO 8601 timestamp when the deployment was last updated.
API URL for this deployment resource.
GITHUB_DEPLOYMENT_STATE_CHANGED_TRIGGERTriggers when a specific GitHub deployment's fields change. Monitors the following aspects of a single deployment: - ``environment`` -- the target environment name - ``original_environment`` -- the original environment name before normalization - ``description`` -- the human-readable deployment description - ``task`` -- the deployment task name - ``sha`` -- the commit SHA being deployed - ``ref`` -- the branch, tag, or SHA reference being deployed - ``updated_at`` -- the last-updated timestamp - ``transient_environment`` -- whether the environment is temporary - ``production_environment`` -- whether this is a production deployment When any of these fields change, an event is emitted containing the full current deployment details and a list of which fields changed.
Configuration
The unique numeric identifier of the deployment to monitor. Obtain this from the deployments listing endpoint ``GET /repos/{owner}/{repo}/deployments`` or from your CI/CD output.
Periodic Interval to Check for Updates & Send a Trigger in Minutes
GitHub username or organisation that owns the repository (e.g. 'octocat' or 'my-company').
Repository name without the .git extension (e.g. 'Hello-World' or 'my-project').
Payload
List of field names that changed since the previous poll. Possible values: 'environment', 'original_environment', 'description', 'task', 'sha', 'ref', 'updated_at', 'transient_environment', 'production_environment'. Use this to route your automation — for example, alert only when 'environment' changes to detect environment promotions.
ISO 8601 timestamp when the deployment was created.
Minimal details about the user or bot that created the deployment.
The canonicalised snapshot from the current poll.
Numeric ID of the deployment that changed.
Optional human-readable description of the deployment.
Target environment name (e.g. 'production', 'staging').
Event type identifier.
GraphQL node ID of the deployment.
Original environment name before any normalization.
Owner of the repository.
The canonicalised snapshot from the previous poll.
Whether this is a production environment deployment.
The ref (branch, tag, or SHA) that was deployed.
Repository name.
API URL for the repository.
Commit SHA that was deployed.
API URL for the deployment's status history.
Deployment task name (e.g. 'deploy').
Whether the environment is temporary (e.g. for PR previews).
ISO 8601 timestamp when the deployment was last updated.
API URL of the deployment resource.
GITHUB_DEPLOYMENT_STATUS_CREATEDTriggers when a new deployment status is created for a specific deployment. Fires an event for each newly created deployment status on the monitored deployment. Deployment statuses represent state transitions such as pending, in_progress, success, failure, error, inactive, and queued. The payload includes the status state, creator, environment, description, timestamps, and relevant URLs.
Configuration
The unique numeric ID of the deployment to monitor for new statuses.
Periodic Interval to Check for Updates & Send a Trigger in Minutes
The account owner (user or organization) of the repository.
The name of the repository (without .git extension).
Payload
ISO 8601 timestamp when the deployment status was created.
The user or bot who created this deployment status.
The ID of the deployment this status belongs to.
API URL for the associated deployment.
A short description of the status (max 140 characters).
The environment this deployment status targets.
The URL for accessing the deployment environment.
Event type identifier for this trigger.
Unique numeric ID of the deployment status.
The URL to view the full output from the deployment.
GraphQL node identifier for the deployment status.
The name of the repository.
The owner of the repository.
API URL for the repository this deployment status belongs to.
The state of the deployment status. One of: error, failure, inactive, pending, success, queued, in_progress.
The target URL associated with this status, typically pointing to the deployment output or logs.
ISO 8601 timestamp when the deployment status was last updated.
API URL for this deployment status resource.
GITHUB_FOLLOWER_EVENTTriggers when new followers are detected on your GitHub account.
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
Payload
Username of the github follower
GITHUB_GIT_REFERENCE_CREATED_TRIGGERTriggers when a new Git reference (branch or tag) matching a specified prefix is created in a repository. Fires an event for each newly created branch or tag whose name matches the configured prefix. Use ``ref_prefix`` to control what is monitored: - ``heads/`` to watch all branches - ``heads/feature/`` to watch only feature branches - ``tags/`` to watch all tags - ``tags/v`` to watch tags starting with 'v' The payload includes the full reference name, node ID, the SHA and type of the Git object the reference points to, and the reference API URL.
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
GitHub username or organisation that owns the repository (e.g. 'octocat' or 'microsoft').
Partial Git reference path prefix to match, without the 'refs/' prefix. Use 'heads/' to match branches (e.g. 'heads/feature/') or 'tags/' to match tags (e.g. 'tags/v'). Only references whose full name starts with 'refs/{ref_prefix}' will be monitored.
Repository name without the .git extension (e.g. 'Hello-World' or 'my-project').
Payload
Type of event that occurred.
The global node ID for the reference.
The SHA-1 hash of the Git object this reference points to.
The type of Git object (typically 'commit').
The API URL for the referenced Git object.
Owner of the repository.
The full Git reference name (e.g. 'refs/heads/feature-a' or 'refs/tags/v1.0').
The API URL for accessing this reference.
Repository name.
GITHUB_ISSUE_ADDED_EVENTTriggered when a new issue is added to the repository.
Configuration
Owner of the repository
Repository name
Payload
The action that was performed on the issue
The timestamp when the issue was created
The GitHub username of the user who created the issue
A detailed description of the issue
The unique ID assigned to the issue
The unique number assigned to the issue
The title of the issue
The GitHub URL of the issue
GITHUB_ISSUE_ASSIGNED_TO_ME_TRIGGERTriggers when a new issue is assigned to the authenticated user. Fires an event for each GitHub issue that is newly assigned to the authenticated user. Pull requests are automatically excluded -- only true issues are emitted. Issues can optionally be filtered by labels and state. The payload includes the issue number, title, body, state, labels, assignees, creator, repository details, and timestamps.
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
A comma-separated list of label names to filter issues by. Only issues with ALL the specified labels will trigger events. Leave empty to receive all newly assigned issues regardless of labels.
Filter issues by state. Use 'open' to only receive open issues, 'closed' for closed issues, or 'all' for both.
Payload
GitHub users assigned to this issue.
The body text / description of the issue.
ISO 8601 timestamp when the issue was closed, if applicable.
Number of comments on the issue.
ISO 8601 timestamp when the issue was created.
The GitHub URL to view this issue.
The unique numeric ID of the issue.
Labels attached to the issue.
The issue number within the repository.
Minimal repository information attached to an issue.
The state of the issue: 'open' or 'closed'.
The title of the issue.
ISO 8601 timestamp when the issue was last updated.
The REST API URL for this issue.
The user who created the issue.
GITHUB_ISSUE_COMMENT_CHANGED_TRIGGERTriggers when a specific GitHub issue comment changes. Monitors the following fields for changes: - ``body`` -- the text content of the comment (detects edits) - ``updated_at`` -- the last-updated timestamp - ``reactions_*`` -- all individual reaction counts (thumbs up/down, laugh, confused, heart, hooray, eyes, rocket) and the total count When a change is detected, the payload includes the full current comment data plus a ``changed_fields`` list indicating exactly which fields were modified.
Configuration
The unique numeric identifier of the issue comment to monitor. You can obtain this from the comment's URL or via the GitHub API.
Periodic Interval to Check for Updates & Send a Trigger in Minutes
GitHub username or organisation that owns the repository (e.g. 'octocat' or 'microsoft').
Repository name without the .git extension (e.g. 'Hello-World' or 'vscode').
Payload
How the author is associated with the repository. Possible values: COLLABORATOR, CONTRIBUTOR, FIRST_TIMER, FIRST_TIME_CONTRIBUTOR, MANNEQUIN, MEMBER, NONE, OWNER.
Current body (text) of the issue comment.
List of canonicalised field names that changed since the previous poll. Possible values: 'body', 'updated_at', 'reactions_total_count', 'reactions_plus_one', 'reactions_minus_one', 'reactions_laugh', 'reactions_confused', 'reactions_heart', 'reactions_hooray', 'reactions_eyes', 'reactions_rocket'.
Unique numeric ID of the issue comment.
ISO 8601 timestamp when the comment was created.
The canonicalised snapshot from the current poll.
Event type identifier.
Web URL to view the comment on GitHub.
GitHub API URL for the parent issue.
GraphQL node identifier of the comment.
Owner of the repository.
The canonicalised snapshot from the previous poll.
Reaction counts for the issue comment.
Repository name.
ISO 8601 timestamp when the comment was last updated.
GitHub API URL for the issue comment.
Condensed representation of the comment author.
GITHUB_ISSUE_COMMENT_CREATED_TRIGGERTriggers when a new comment is added to a specific GitHub issue. Only genuinely new comments are emitted; edits to existing comments do not produce duplicate events. The payload includes the comment ID, text body, author details, timestamps, and direct links to the comment on GitHub.
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
The number that identifies the issue to monitor for new comments (e.g. 42). You can find it in the issue URL (github.com/owner/repo/issues/42).
GitHub username or organisation that owns the repository (e.g. 'octocat' or 'microsoft').
Repository name without the .git extension (e.g. 'Hello-World' or 'vscode').
Payload
The comment author's relationship to the repository. Possible values: COLLABORATOR, CONTRIBUTOR, FIRST_TIMER, FIRST_TIME_CONTRIBUTOR, MANNEQUIN, MEMBER, NONE, OWNER.
The text content of the comment.
Unique identifier of the issue comment.
ISO 8601 timestamp when the comment was created.
Web URL to view the comment on GitHub.
The issue number this comment belongs to.
GitHub API URL for the parent issue.
GraphQL node ID of the comment.
Owner of the repository.
Repository name.
ISO 8601 timestamp when the comment was last updated.
GitHub API URL for the comment.
GitHub user information associated with a comment.
GITHUB_ISSUE_CREATED_TRIGGERTriggers when a new issue is created in a GitHub repository. Pull requests are automatically excluded -- only true issues produce events. Results can be filtered by labels, assignee, creator, and mentioned user. The payload includes the issue number, title, body, state, labels, assignees, comment count, creator details, timestamps, and direct links to the issue on GitHub.
Configuration
Filter issues assigned to a specific GitHub username. Use 'none' for unassigned issues, '*' for any assigned issue. Leave empty to receive issues regardless of assignee.
Filter issues created by a specific GitHub username. Leave empty to receive issues from any creator.
Periodic Interval to Check for Updates & Send a Trigger in Minutes
A comma-separated list of label names to filter issues by. Only issues with ALL the specified labels will trigger events. Leave empty to receive all new issues regardless of labels.
Filter issues where the given GitHub username is mentioned. Leave empty to receive all new issues.
The account owner of the repository (username or organization name). Must contain only alphanumeric characters and hyphens, max 39 characters.
The name of the repository without the .git extension. Must contain only alphanumeric characters, hyphens, underscores, and periods.
Issue state to monitor: 'open', 'closed', or 'all'. Defaults to 'open'.
Payload
GitHub users assigned to this issue.
The body text / description of the issue.
ISO 8601 timestamp when the issue was closed, if applicable.
Number of comments on the issue.
ISO 8601 timestamp when the issue was created.
The GitHub URL to view this issue.
The unique numeric ID of the issue.
True if this item is actually a pull request. GitHub's issues API also returns pull requests; this flag distinguishes them.
Labels attached to the issue.
The issue number within the repository.
The name of the repository the issue belongs to.
The owner of the repository the issue belongs to.
The state of the issue: 'open' or 'closed'.
The title of the issue.
ISO 8601 timestamp when the issue was last updated.
The REST API URL for this issue.
The user who created the issue.
GITHUB_ISSUE_EVENT_OCCURRED_TRIGGERTriggers when a new issue event occurs in a GitHub repository. Covers all issue timeline events such as issues being closed, reopened, assigned, unassigned, labeled, unlabeled, milestoned, demilestoned, renamed, locked, or unlocked. Events can optionally be filtered by type. The payload includes the event type, timestamp, the actor who triggered the event, the affected issue details, and any associated commit references.
Configuration
Comma-separated list of event types to filter (e.g., 'closed,labeled,assigned'). Leave empty to receive all issue events. Common values: closed, reopened, assigned, unassigned, labeled, unlabeled, milestoned, demilestoned, renamed, locked, unlocked.
Periodic Interval to Check for Updates & Send a Trigger in Minutes
The account owner of the repository (username or organization name). Must contain only alphanumeric characters and hyphens, max 39 characters.
The name of the repository without the .git extension. Must contain only alphanumeric characters, hyphens, underscores, and periods.
Payload
Minimal GitHub user information for the event actor.
SHA of the commit that referenced this issue, if applicable.
API URL for the associated commit, if applicable.
ISO 8601 timestamp when the event was created.
The type of event (e.g., closed, reopened, assigned, unassigned, labeled, unlabeled, milestoned, demilestoned, renamed, locked, unlocked).
The unique numeric ID of the issue event.
Minimal issue information embedded in the event.
GraphQL global node identifier of the event.
The name of the repository the event belongs to.
The owner of the repository the event belongs to.
The REST API URL for this event.
GITHUB_ISSUE_LABEL_CHANGED_TRIGGERTriggers when the labels on a specific GitHub issue change. Fires whenever a label is added to, removed from, or has its metadata (color, description) modified on the monitored issue. The payload includes: - ``current_labels`` -- the full set of labels currently on the issue - ``added_labels`` -- labels that were newly added - ``removed_label_names`` -- names of labels that were removed - ``changed_label_names`` -- labels whose metadata changed without being added or removed
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
The unique number of the GitHub issue to monitor for label changes. You can find this number in the issue's URL: https://github.com/{owner}/{repo}/issues/{issue_number}
The account owner of the repository (username or organization name). This is not case-sensitive. For example: 'octocat' or 'my-organization'.
The name of the repository without the `.git` extension. This is not case-sensitive.
Payload
Labels that were added to the issue since the previous poll.
Names of labels whose metadata (color, description) changed since the previous poll without being added/removed.
The full current set of labels on the issue after the change.
Event type identifier.
The number of the issue whose labels changed.
The account owner of the repository (username or org).
Names of labels that were removed from the issue since the previous poll.
The repository name.
GITHUB_ISSUE_STATE_CHANGED_TRIGGERTriggers when a specific GitHub issue changes any of its tracked properties. Monitored properties: state (open/closed), state_reason, title, body, assignees, labels, milestone, lock status, active_lock_reason, comment count, and closed_at timestamp. When a change is detected, the payload includes the full current issue details, the list of changed field names, and their previous values.
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
The identifying number of the issue to monitor. This is the number shown next to the issue title (e.g., #42) or visible in the issue URL.
The account owner of the repository (username or organization name). Must contain only alphanumeric characters and hyphens, max 39 characters.
The name of the repository without the .git extension. Must contain only alphanumeric characters, hyphens, underscores, and periods.
Payload
The reason the issue is locked, if locked.
GitHub users currently assigned to this issue.
The current body text / description of the issue.
List of field names that changed since the last poll.
ISO 8601 timestamp when the issue was closed, if applicable.
Number of comments on the issue.
ISO 8601 timestamp when the issue was created.
The GitHub URL to view this issue.
The unique numeric ID of the issue.
Labels currently attached to the issue.
Whether the issue is locked.
The issue number within the repository.
Previous string-serialized values of the changed fields.
The name of the repository the issue belongs to.
The owner of the repository the issue belongs to.
The current state of the issue: 'open' or 'closed'.
The reason for the current state. Possible values: completed, reopened, not_planned, duplicate, or null.
The current title of the issue.
ISO 8601 timestamp when the issue was last updated.
The REST API URL for this issue.
The user who created the issue.
GITHUB_ISSUE_UPDATED_TRIGGERTriggers when an existing issue is updated in a GitHub repository. Monitors issues for any changes such as title edits, body edits, label changes, assignee changes, state transitions (opening, closing, reopening), milestone updates, and comment additions. Only pre-existing issues that receive updates are emitted; newly created issues are excluded. Pull requests are also excluded -- only true issues fire events.
Configuration
Filter issues assigned to a specific GitHub username. Use 'none' for unassigned issues, '*' for any assigned issue. Leave empty to receive issues regardless of assignee.
Periodic Interval to Check for Updates & Send a Trigger in Minutes
A comma-separated list of label names to filter issues by. Only issues with ALL the specified labels will trigger events. Leave empty to receive events for all issues regardless of labels.
The account owner of the repository (username or organization name). Must contain only alphanumeric characters and hyphens, max 39 characters.
The name of the repository without the .git extension. Must contain only alphanumeric characters, hyphens, underscores, and periods.
Filter by issue state. Use 'open' for open issues only, 'closed' for closed issues, or 'all' for both. Defaults to 'all' so updates to any issue (e.g., closing an issue) are captured.
Payload
GitHub users assigned to this issue.
The body text / description of the issue.
ISO 8601 timestamp when the issue was closed, if applicable.
Number of comments on the issue.
ISO 8601 timestamp when the issue was created.
The GitHub URL to view this issue.
The unique numeric ID of the issue.
Labels attached to the issue.
The issue number within the repository.
The name of the repository the issue belongs to.
The owner of the repository the issue belongs to.
The state of the issue: 'open' or 'closed'.
Reason for the current state (completed, not_planned, reopened, or null).
The title of the issue.
ISO 8601 timestamp when the issue was last updated.
The REST API URL for this issue.
The user who created the issue.
GITHUB_LABEL_ADDED_EVENTTriggered when a new label is added to a pull request.
Configuration
Owner of the repository
Repository name
Payload
The action that was performed on the label
The name of the label that was added
The timestamp when the label was added
The GitHub username of the user who added the label
The unique number assigned to the pull request
The title of the pull request
The GitHub URL of the pull request
GITHUB_NEW_STARGAZER_ADDED_TRIGGERTriggers when a new user stars a GitHub repository. Emits an event for each new stargazer detected on the monitored repository.
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
GitHub username or organisation that owns the repository (e.g. 'octocat' or 'microsoft').
Repository name without the .git extension (e.g. 'Hello-World' or 'vscode').
Payload
GitHub API URL for the stargazer's user resource.
URL to the stargazer's avatar image.
Type of event that occurred.
GitHub profile URL of the stargazer.
GitHub username of the user who starred the repository.
Owner of the repository.
Repository name.
Whether the stargazer is a GitHub site administrator.
Unique numeric identifier for the user who starred the repository.
Type of the GitHub account (e.g. 'User' or 'Organization').
GITHUB_PR_REVIEW_COMMENT_CREATED_TRIGGERTriggers when a new inline review comment is added to a specific GitHub pull request. Monitors all review comments across all reviews on the specified pull request and emits an event for each newly created comment. Edits to existing comments do not fire new events.
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
GitHub username or organisation that owns the repository (e.g. 'octocat' or 'microsoft').
The number that identifies the pull request to monitor (e.g. 42). You can find it in the PR URL (github.com/owner/repo/pull/42).
Repository name without the .git extension (e.g. 'Hello-World' or 'vscode').
Payload
The comment author's relationship to the repository. Possible values: COLLABORATOR, CONTRIBUTOR, FIRST_TIMER, FIRST_TIME_CONTRIBUTOR, MANNEQUIN, MEMBER, NONE, OWNER.
The text content of the review comment.
Unique identifier of the review comment.
The SHA of the commit to which the comment applies.
ISO 8601 timestamp when the comment was created.
The diff hunk of the file that the comment refers to.
Web URL to view the comment on GitHub.
The comment ID this comment replies to, if any.
The line of the blob to which the comment applies. The last line of the range for a multi-line comment.
GraphQL node ID of the comment.
The SHA of the original commit to which the comment applies.
The original line index in the diff.
The original first line of the range for a multi-line comment.
Owner of the repository.
The relative path of the file to which the comment applies.
The pull request number this comment belongs to.
The ID of the pull request review the comment belongs to, if any.
GitHub API URL for the parent pull request.
Repository name.
The side of the diff to which the comment applies (LEFT or RIGHT).
The first line of the range for a multi-line comment.
The side of the diff where the multi-line comment range starts (LEFT or RIGHT).
The level at which the comment is targeted: 'line' or 'file'.
ISO 8601 timestamp when the comment was last updated.
GitHub API URL for the review comment.
GitHub user information associated with a pull request review comment.
GITHUB_PULL_REQUEST_COMMIT_ADDED_TRIGGERTriggers when a new commit is pushed to a specific pull request. Monitors all commits on the specified pull request and emits an event for each newly added commit. This covers force-pushes and additional commits pushed to the PR's head branch.
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
The account owner of the repository (username or organization name). Case-insensitive.
The number of the pull request to monitor for new commits.
The name of the repository without the .git extension. Case-insensitive.
Payload
Minimal GitHub user info (author or committer).
API URL for comments on this commit.
Detailed metadata embedded in the commit object.
Minimal GitHub user info (author or committer).
GitHub URL to view the commit.
The GraphQL node ID of the commit.
Parent commits of this commit.
The pull request number this commit belongs to.
The name of the repository (from config).
The owner of the repository (from config).
The commit SHA.
API URL for this commit.
GITHUB_PULL_REQUEST_CREATEDTriggers when a new pull request is created in GitHub, matching the optional configured filters. Emits an event for each newly created pull request. Supports filtering by repository, owner/organisation, author, assignee, label, state, base branch, head branch, and draft status.
Configuration
Only emit events for pull requests assigned to this GitHub username. Use '@me' to match the authenticated user.
Only emit events for pull requests created by this GitHub username. Must be a valid GitHub login (alphanumeric + hyphens only, max 39 chars).
Only emit events for pull requests targeting this base branch (e.g., 'main' or 'develop').
Only emit events for pull requests whose source branch matches this name (e.g., 'feature/login').
Periodic Interval to Check for Updates & Send a Trigger in Minutes
Filter by draft status. Set to True to receive events only for draft PRs, False for non-draft PRs, or leave blank to receive both.
Only emit events for pull requests that carry this label name (e.g., 'bug', 'enhancement').
Restrict the search to all repositories belonging to a GitHub user or organisation (e.g., 'facebook' or 'microsoft'). Ignored when 'repo' is also provided.
Restrict the search to a specific repository. Must be in 'owner/repo' format (e.g., 'facebook/react'). Leave blank to search across all repositories accessible to the account.
Pull request state to monitor: 'open', 'closed', or 'all'. Defaults to 'open'.
Payload
GitHub profile URL of the pull request author.
GitHub username of the pull request author.
Body/description of the pull request in markdown format.
ISO 8601 timestamp when the pull request was closed, null if open.
Number of comments on the pull request.
ISO 8601 timestamp when the pull request was created.
Whether the pull request is marked as a draft.
Event type identifier for this trigger.
GitHub web interface URL to view the pull request.
Names of the labels attached to this pull request.
ISO 8601 timestamp when the pull request was merged, null if not merged.
GraphQL node identifier for the pull request.
Pull request number within the repository.
Unique numeric identifier of the pull request (as string).
GitHub API URL for the repository the pull request belongs to.
State of the pull request: 'open' or 'closed'.
Title of the pull request.
ISO 8601 timestamp when the pull request was last updated.
GITHUB_PULL_REQUEST_EVENTTriggered when a pull request is opened, closed, or synchronized.
Configuration
Owner of the repository
Repository name
Payload
The action that was performed on the pull request
The timestamp when the pull request was created
The GitHub username of the user who created the pull request
A detailed description of the pull request
The unique number assigned to the pull request
The title of the pull request
The GitHub URL of the pull request
GITHUB_PULL_REQUEST_REVIEWERS_CHANGED_TRIGGERTriggers when the list of requested reviewers (users or teams) for a pull request changes — for example when a reviewer is added, removed, or re-requested. The payload includes the full current reviewer list (users and teams with details), which reviewers were added, which were removed, and the previous reviewer list for reference.
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
GitHub username or organisation that owns the repository (e.g. 'octocat' or 'microsoft').
The numeric identifier of the pull request to monitor (e.g. 42). You can find this in the pull request URL.
Repository name without the .git extension (e.g. 'Hello-World' or 'my-project').
Payload
Sorted list of team slugs currently requested to review.
Full details of teams currently requested to review.
Sorted list of GitHub user logins currently requested to review.
Full details of users currently requested to review.
Event type identifier.
Owner of the repository.
Sorted list of team slugs from the previous poll.
Sorted list of user logins from the previous poll.
The numeric identifier of the pull request.
Repository name.
Team slugs that were newly added as requested reviewers.
Team slugs that were removed from requested reviewers.
User logins that were newly added as requested reviewers.
User logins that were removed from requested reviewers.
GITHUB_PULL_REQUEST_REVIEW_SUBMITTED_TRIGGERTriggers when a new review is submitted for a GitHub pull request. Emits an event for each newly submitted review on the monitored pull request, covering all review types: APPROVED, CHANGES_REQUESTED, COMMENTED, and DISMISSED.
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
GitHub username or organisation that owns the repository (e.g. 'octocat' or 'microsoft').
The number of the pull request to monitor for new reviews.
Repository name without the .git extension (e.g. 'Hello-World' or 'vscode').
Payload
How the reviewer is associated with the repository (e.g. COLLABORATOR, CONTRIBUTOR, MEMBER, NONE, OWNER).
The body text of the review.
The commit SHA that was reviewed.
Type of event that occurred.
Web URL for the review.
GraphQL node identifier of the review.
Owner of the repository.
The number of the pull request being reviewed.
API URL for the associated pull request.
Repository name.
Unique numeric identifier of the review.
Minimal representation of the reviewer user.
State of the review. Possible values: APPROVED, CHANGES_REQUESTED, COMMENTED, DISMISSED, PENDING.
ISO 8601 timestamp of when the review was submitted.
GITHUB_PULL_REQUEST_STATE_CHANGED_TRIGGERTriggers when a specific GitHub pull request changes any of these tracked properties: state (open/closed), title, body, draft status, lock status, merge status, assignees, labels, requested reviewers, or milestone. The payload includes the full current PR details, the list of changed field names, and their previous values.
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
The account owner of the repository (username or organization name). Must contain only alphanumeric characters and hyphens, max 39 characters.
The identifying number of the pull request to monitor. This is the number shown next to the PR title (e.g., #42) or visible in the pull request URL.
The name of the repository without the .git extension. Must contain only alphanumeric characters, hyphens, underscores, and periods.
Payload
The reason the pull request is locked, if locked.
GitHub users currently assigned to this pull request.
The current body / description of the pull request.
List of field names that changed since the last poll.
ISO 8601 timestamp when the pull request was closed, if applicable.
ISO 8601 timestamp when the pull request was created.
Whether the pull request is a draft.
The GitHub URL to view this pull request.
The unique numeric ID of the pull request.
Labels currently attached to the pull request.
Whether the pull request is locked.
SHA of the merge commit, if merged.
Whether the pull request has been merged.
ISO 8601 timestamp when the pull request was merged, if applicable.
Minimal GitHub user information attached to a pull request.
The milestone title associated with the pull request, if any.
The PR number within the repository.
Previous string-serialized values of the changed fields.
The name of the repository the pull request belongs to.
The owner of the repository the pull request belongs to.
GitHub users whose review is currently requested.
The current state of the pull request: 'open' or 'closed'.
The current title of the pull request.
ISO 8601 timestamp when the pull request was last updated.
The REST API URL for this pull request.
The user who created the pull request.
GITHUB_PULL_REQUEST_UPDATEDTriggers when an existing pull request is updated in a GitHub repository. Updates include title edits, description changes, label changes, assignee changes, reviewer requests, draft status changes, base branch changes, being closed, merged, or reopened. Only pre-existing PRs that receive an update will fire the trigger; newly created PRs are excluded. Supports optional filters: state, base branch, head branch, author, label, and draft status.
Configuration
Only emit events for pull requests authored by this GitHub username. Leave blank to watch PRs from any author.
Only emit events for pull requests targeting this base branch (the branch being merged into). Leave blank to watch all base branches.
Filter by draft status. Set to True to only watch draft PRs, False for non-draft PRs, or leave blank (None) to watch both.
Only emit events for pull requests coming from this head branch (the branch being merged). Supports the 'user:branch' format to filter across forks. Leave blank to watch all head branches.
Periodic Interval to Check for Updates & Send a Trigger in Minutes
Only emit events for pull requests carrying this exact label name. Leave blank to watch PRs regardless of labels.
The account owner of the repository (GitHub username or organization name). Do not include the repository name here.
The name of the repository to watch for updated pull requests. Do not include the owner prefix.
Filter pull requests by state. Use 'open' for open PRs only, 'closed' for closed (merged or unmerged) PRs, or 'all' to catch updates to PRs in any state (e.g., a PR being merged or closed). Defaults to 'all'.
Payload
List of GitHub users currently assigned to the pull request.
Author's relationship to the repository: COLLABORATOR, CONTRIBUTOR, FIRST_TIMER, FIRST_TIME_CONTRIBUTOR, MANNEQUIN, MEMBER, NONE, or OWNER.
Branch information (head or base) for a pull request.
The description / body of the pull request in markdown format.
ISO 8601 timestamp when the pull request was closed, null if still open.
ISO 8601 timestamp when the pull request was created.
Whether the pull request is marked as a draft.
Event type identifier for this trigger.
Branch information (head or base) for a pull request.
GitHub web interface URL to view the pull request.
The unique numeric ID of the pull request across all of GitHub.
Labels attached to the pull request.
Whether the pull request conversation is locked.
SHA of the merge commit. Present before merging as a test-merge SHA; set to the actual merge commit SHA after merge.
ISO 8601 timestamp when the pull request was merged, null if not merged.
The pull request number within the repository.
The name of the repository.
The owner (user or organization) of the repository.
List of users requested to review the pull request.
Current state of the pull request: 'open' or 'closed'.
The title of the pull request.
ISO 8601 timestamp when the pull request was last updated.
GitHub REST API URL for this pull request.
GitHub user information attached to a pull request.
GITHUB_README_CHANGED_TRIGGERTriggers when the README file in a specific repository directory changes. Monitors the README in a configurable directory and branch/tag/commit. The payload includes the current README metadata (filename, path, SHA, size, URLs), the previous and current git blob SHAs, and a list of which tracked fields changed.
Configuration
The directory path within the repository whose README to monitor. Use '.' or leave blank to monitor the root README. For a subdirectory, provide the relative path (e.g. 'docs' or 'src/api').
Periodic Interval to Check for Updates & Send a Trigger in Minutes
GitHub username or organisation that owns the repository (e.g. 'octocat' or 'microsoft').
Optional Git ref (branch, tag, or commit SHA) to read the README from. Leave blank to use the repository's default branch.
Repository name without the .git extension (e.g. 'Hello-World' or 'my-project').
Payload
List of tracked field names that changed since the previous poll. Possible values: 'sha', 'size', 'name', 'path'.
The git blob SHA observed in the current poll (after the change).
The canonicalised snapshot from the current poll.
Directory path that was monitored.
URL to download the raw README content.
Encoding used for the README content (typically 'base64').
Event type identifier.
GitHub API URL to the underlying git blob.
URL to view the README on GitHub.
Filename of the README (e.g. 'README.md').
Owner of the repository.
Full path of the README within the repository.
The git blob SHA observed in the previous poll (before the change).
The canonicalised snapshot from the previous poll.
Repository name.
Current git blob SHA of the README content.
Current size of the README file in bytes.
GitHub API URL for the README resource.
GITHUB_RELEASE_ASSET_ADDED_TRIGGERTriggers when a new asset is added to a specific GitHub release. Monitors a single release (identified by release ID) for newly uploaded assets such as binaries, archives, or checksum files. One event is emitted per new asset, containing full asset metadata.
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
The GitHub username or organization name that owns the repository (e.g. 'octocat' or 'my-organization').
The unique numeric identifier of the release to monitor for new assets. You can obtain this by listing releases for the repository.
The name of the repository that contains the release to monitor (without the .git extension, e.g. 'Hello-World').
Payload
Unique numeric identifier of the newly added release asset.
Direct download URL for the asset accessible in a browser.
MIME type of the asset (e.g. 'application/zip', 'text/plain').
ISO 8601 timestamp of when the asset was created.
SHA256 hash of the asset file for integrity verification.
Number of times the asset has been downloaded.
Event type identifier for this trigger.
An optional label providing additional context for the asset.
The file name of the asset.
GraphQL node identifier for the release asset.
The GitHub username or organization that owns the repository.
The numeric ID of the release this asset belongs to.
The name of the repository containing this release.
Size of the asset file in bytes.
State of the release asset (e.g. 'uploaded' or 'open').
ISO 8601 timestamp of when the asset was last updated.
Numeric GitHub user ID of the uploader.
GitHub login (username) of the user who uploaded the asset.
GitHub REST API URL for this release asset.
GITHUB_RELEASE_STATE_CHANGED_TRIGGERTriggers when a specific GitHub release (identified by tag name) changes. Monitors the release title, body/notes, draft flag, prerelease flag, published timestamp, target branch/commit, and the set of attached assets. The payload includes the full current release details, a list of which fields changed, and the previous values for comparison.
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
GitHub username or organisation that owns the repository (e.g. 'octocat' or 'microsoft').
Repository name without the .git extension (e.g. 'Hello-World' or 'my-project').
The exact Git tag name of the release to monitor (e.g. 'v1.0.0'). This identifies the specific release by its tag.
Payload
Current list of release assets.
Current release body/notes in markdown format.
List of field names that changed since the previous poll. Possible values: 'name', 'body', 'draft', 'prerelease', 'published_at', 'target_commitish', 'asset_ids'.
The canonicalised snapshot from the current poll.
Whether the release is currently a draft.
Event type identifier.
Web URL to view the release on GitHub.
Current release name/title.
Owner of the repository.
Whether the release is currently marked as a prerelease.
The canonicalised snapshot from the previous poll.
ISO 8601 timestamp when the release was published (null for drafts).
Numeric ID of the release that changed.
Repository name.
Git tag name for the release.
The branch or commit SHA the release tag points to.
GITHUB_REPOSITORY_CONTENT_CHANGED_TRIGGERTriggers when the content of a file or directory in a GitHub repository changes. Monitors a specified path within a repository on a given branch or tag. For a single file, fires ``content_changed`` when the file is modified. For a directory, fires ``content_changed``, ``content_added``, or ``content_removed`` for modified, new, or deleted entries respectively. content.
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
GitHub username or organisation that owns the repository (e.g. 'octocat' or 'microsoft').
Path to the file or directory to monitor within the repository. Use an empty string (default) to monitor the root directory. For a specific file use its full path (e.g. 'README.md', 'src/main.py'). For a directory use its path (e.g. 'src', 'docs/api').
The git reference (branch name, tag name, or commit SHA) to monitor. If omitted the repository's default branch is used.
Repository name without the .git extension (e.g. 'Hello-World' or 'my-project').
Payload
Type of change: 'content_changed', 'content_added', or 'content_removed'.
Metadata snapshot of the content item that changed, was added, or was removed.
The file or directory path being monitored.
Owner of the repository.
SHA of the item before the change. Non-empty only for 'content_changed' events.
The git reference (branch/tag/SHA) that was monitored. Empty string means the repository's default branch was used.
Repository name.
GITHUB_REPOSITORY_NOTIFICATION_RECEIVED_TRIGGERTriggers when a new or newly updated notification thread appears for a specific GitHub repository. Monitors notifications for issues, pull requests, commits, releases, check suites, security alerts, and other repository activity. Supports filtering by read/unread status and by direct participation. Requires a Personal Access Token (classic) with the ``notifications``
Configuration
If true, also return notifications that have already been marked as read. Default (false) shows only unread notifications.
Periodic Interval to Check for Updates & Send a Trigger in Minutes
The account owner of the repository (username or organization). Not case sensitive.
If true, only return notifications where the authenticated user is directly participating or mentioned.
The name of the repository (without the .git extension). Not case sensitive.
Payload
Notification thread ID.
ISO 8601 timestamp of when the thread was last read, or null.
Reason the authenticated user received the notification (e.g., subscribed, mentioned, author, assign, review_requested, comment, ci_activity, security_alert, state_change, team_mention).
Repository the notification belongs to.
Subject of the notification thread.
API URL for managing the thread subscription.
Whether the notification thread is unread.
ISO 8601 timestamp of when the notification thread was last updated.
API URL for this notification thread.
GITHUB_REPOSITORY_TAG_CREATED_TRIGGERTriggers when a new tag is created in a GitHub repository. Monitors the repository's tags and fires an event for each newly created tag. The payload includes the tag name, the commit SHA and URL it points to, and archive download URLs.
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
GitHub username or organisation that owns the repository (e.g. 'octocat' or 'microsoft').
Repository name without the .git extension (e.g. 'Hello-World' or 'my-project').
Payload
The SHA of the commit the tag points to.
The API URL of the commit the tag points to.
Type of event that occurred.
The GraphQL node ID of the tag reference.
Owner of the repository.
Repository name.
The name of the newly created tag.
URL to download a tarball archive of the repository at this tag.
URL to download a zipball archive of the repository at this tag.
GITHUB_SECRET_SCANNING_ALERT_DETECTED_TRIGGERTriggers when a new secret scanning alert is detected in a GitHub repository. Monitors open secret scanning alerts and fires an event for each newly detected alert. Supports filtering by secret type (e.g., personal access tokens, AWS keys) and by token validity status (active, inactive, unknown). The payload includes the alert number, secret type, validity status, resolution state, timestamps, URLs, and flags for push protection bypass, public exposure, and multi-repo detection.
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
The account owner of the repository. The name is not case sensitive.
The name of the repository without the .git extension. The name is not case sensitive.
Comma-separated list of secret types to filter by (e.g., 'github_personal_access_token,aws_access_key_id'). Leave empty to monitor all secret types.
Filter by token validity status: 'active' (token still valid), 'inactive' (token revoked/expired), or 'unknown'. Leave empty to monitor all validity states.
Payload
The ISO 8601 timestamp when the alert was created.
The GitHub web URL for the alert.
The REST API URL for the locations where the secret was detected.
Whether the secret was found in multiple repositories.
The security alert number identifier.
Whether the secret was found publicly exposed.
Whether push protection was bypassed for this secret.
The ISO 8601 timestamp when push protection was bypassed.
The resolution when the alert is resolved: 'false_positive', 'wont_fix', 'revoked', 'pattern_edited', 'pattern_deleted', or 'used_in_tests'.
The ISO 8601 timestamp when the alert was resolved, if applicable.
The type of secret that was detected (e.g., 'github_personal_access_token', 'aws_access_key_id').
The human-readable display name of the secret type.
The state of the alert: 'open' or 'resolved'.
The ISO 8601 timestamp when the alert was last updated.
The REST API URL for the alert.
The validity status of the detected token: 'active', 'inactive', or 'unknown'.
GITHUB_STAR_ADDED_EVENTTriggered when a new star is added to the repository.
Configuration
Owner of the repository
Repository name
Payload
The action that was performed on the star
The unique ID assigned to the repository
The name of the repository
The GitHub URL of the repository
The timestamp when the star was added
The GitHub username of the user who added the star
GITHUB_WORKFLOW_ADDED_TRIGGERTriggers when a new GitHub Actions workflow is added to a repository. Monitors a repository's GitHub Actions workflows and fires an event for each newly added workflow. The payload includes the workflow's name, file path, state, creation and update timestamps, and URLs for the API, web interface, and status badge.
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
The GitHub username or organization name that owns the repository (e.g. 'octocat' or 'my-organization').
The name of the repository to monitor for new workflows (without the .git extension, e.g. 'Hello-World').
Payload
URL for the workflow status badge image.
ISO 8601 timestamp of when the workflow was created.
ISO 8601 timestamp of when the workflow was deleted, or null if not deleted.
Type of event that occurred.
GitHub web interface URL where the workflow can be viewed.
The name of the workflow as defined in the workflow file.
GraphQL node identifier for the workflow.
The GitHub username or organization that owns the repository.
The path to the workflow file within the repository (e.g. '.github/workflows/ci.yaml').
The name of the repository the workflow was added to.
Current state of the workflow. Possible values: active, deleted, disabled_fork, disabled_inactivity, disabled_manually.
ISO 8601 timestamp of when the workflow was last updated.
API endpoint URL for accessing this specific workflow.
Unique numeric identifier of the newly added workflow.
GITHUB_WORKFLOW_JOB_ADDED_TRIGGERTriggers when a new job appears in a specific GitHub Actions workflow run. This is useful for detecting matrix-expanded jobs that are added after the initial workflow run creation, or any other scenario where jobs are dynamically added to an existing run.
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
GitHub username or organisation that owns the repository (e.g. 'octocat' or 'microsoft'). Not case-sensitive.
Repository name without the .git extension (e.g. 'Hello-World' or 'my-project'). Not case-sensitive.
The unique identifier of the workflow run to monitor. You can find this in the URL of the workflow run page on GitHub (e.g. https://github.com/owner/repo/actions/runs/123456789).
Payload
The API URL of the check run associated with this job.
ISO 8601 timestamp of when the job completed.
The outcome of the job after completion (e.g. success, failure). Null if the job has not concluded.
ISO 8601 timestamp of when the job was created.
Type of event that occurred.
The branch name associated with this job.
The SHA of the commit being built in this job.
The GitHub URL to view the job in the browser.
The unique identifier of the job.
The display name of the job.
The API URL to retrieve details about this job.
Runner labels used to identify the type of runner for this job.
The GraphQL node identifier for this job.
Owner of the repository.
Repository name.
The attempt number of the associated workflow run, starting at 1.
The workflow run ID this job belongs to.
The API URL of the workflow run.
The identifier of the runner group executing this job.
The name of the runner group executing this job.
The identifier of the runner executing this job.
The name of the runner executing this job.
ISO 8601 timestamp of when the job started.
The current lifecycle phase of the job (e.g. queued, in_progress, completed).
The individual steps that make up this job.
The name of the workflow this job is part of.
GITHUB_WORKFLOW_JOB_STATE_CHANGEDTriggers when the status, conclusion, timestamps, runner assignment, or step details of a specific GitHub Actions workflow job change between polls. The payload includes the full current job state, a list of which fields changed, and the previous status/conclusion values for easy comparison.
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
The unique numerical identifier of the GitHub Actions workflow job to monitor. You can find the job ID from the GitHub Actions UI URL or via the List Jobs for a Workflow Run API.
The account owner of the repository (GitHub username or organization name). Do not include the repository name here.
The name of the repository that contains the workflow job to watch. Do not include the owner prefix.
Payload
List of field names that changed compared to the previous snapshot. Empty on the very first event (initial state capture is skipped).
GitHub REST API URL for the check run.
ISO 8601 timestamp when the job finished. Null if still running.
Outcome of the job after completion: success, failure, neutral, cancelled, skipped, timed_out, or action_required. Null while running.
ISO 8601 timestamp when the job was created.
Event type identifier for this trigger.
Branch the job ran on.
SHA of the commit being run.
GitHub web UI URL to view this job.
Unique numeric identifier of the workflow job.
Runner labels from the runs-on attribute.
Name of the job.
Owner of the repository.
Previous job conclusion before this change.
Previous job status before this change.
Repository name.
Attempt number of the parent workflow run.
ID of the parent workflow run.
ID of the runner group. Null while queued.
Name of the runner group. Null while queued.
ID of the runner executing the job. Null while queued.
Name of the runner executing the job. Null while queued.
ISO 8601 timestamp when the job started.
Current status of the job: queued, in_progress, or completed.
Current step details for the job.
GitHub REST API URL for this job.
Name of the workflow.
GITHUB_WORKFLOW_RUN_ARTIFACT_ADDEDTriggers when a new artifact is uploaded to a specific GitHub Actions workflow run. Monitors a single workflow run for newly added artifacts such as build outputs, test results, or coverage reports. Each new artifact detected fires a separate event.
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
Account owner of the repository (GitHub username or organization name).
Repository name without the .git extension.
Unique identifier of the workflow run to monitor for new artifacts.
Payload
Direct URL to download the artifact archive as a ZIP file.
Timestamp when the artifact was created.
SHA256 digest of the artifact (available for upload-artifact v4+).
Whether or not the artifact has expired.
Timestamp when the artifact will expire.
Unique identifier for the artifact.
The name of the artifact.
GraphQL node identifier for the artifact.
The size in bytes of the artifact.
Timestamp when the artifact was last updated.
API URL for accessing the artifact.
Metadata about the workflow run that created the artifact.
GITHUB_WORKFLOW_RUN_CREATEDTriggers when a new workflow run is created in a GitHub repository. Monitors the repository for any new workflow runs and fires an event for each one. Optional filters allow narrowing to a specific branch, actor, or event type.
Configuration
Filter workflow runs triggered by a specific GitHub user login. Leave blank to monitor runs triggered by any user.
Filter workflow runs to a specific branch name. Leave blank to monitor runs on all branches.
Filter workflow runs triggered by a specific event type (e.g. 'push', 'pull_request', 'schedule'). Leave blank to monitor runs triggered by any event.
Periodic Interval to Check for Updates & Send a Trigger in Minutes
The account owner of the repository (GitHub username or organization name). Do not include the repository name here.
The name of the repository to watch for new workflow runs. Do not include the owner prefix.
Payload
GitHub user who triggered the workflow run.
Conclusion of the workflow run (null if not completed).
ISO 8601 timestamp when the workflow run was created.
Event-specific title associated with the run or the value of run-name if set in the workflow file.
Name of the event that triggered the workflow run.
Event type identifier for this trigger.
Name of the branch that triggered the workflow run.
SHA of the commit that triggered the workflow run.
GitHub web UI URL to view the workflow run.
API URL to retrieve jobs for this workflow run.
API URL to download logs for this workflow run.
Name of the workflow run.
GraphQL node ID for the workflow run.
Owner of the repository.
Path to the workflow file in the repository.
Repository name.
Attempt number of this run (increments with re-runs).
Unique numeric identifier of the workflow run.
Sequential run number for this workflow.
ISO 8601 timestamp when the workflow run actually started execution.
Current status of the workflow run.
ISO 8601 timestamp when the workflow run was last updated.
GitHub REST API URL for this workflow run.
ID of the workflow definition.
GITHUB_WORKFLOW_RUN_STATE_CHANGED_TRIGGERTriggers when a GitHub Actions workflow run's status or conclusion changes. Monitors a single workflow run and fires an event whenever it transitions between states (e.g., queued to in_progress, or in_progress to completed) or when its conclusion is set (e.g., success, failure, cancelled).
Configuration
Periodic Interval to Check for Updates & Send a Trigger in Minutes
GitHub username or organisation that owns the repository (e.g. 'octocat' or 'microsoft').
Repository name without the .git extension (e.g. 'Hello-World' or 'my-project').
The unique numeric identifier of the workflow run to monitor. You can find this in the URL of a workflow run on GitHub: https://github.com/{owner}/{repo}/actions/runs/{run_id}
Payload
List of state field names that changed since the previous poll. Possible values: 'status', 'conclusion'.
Current conclusion of the workflow run. One of: success, failure, neutral, cancelled, skipped, timed_out, action_required, or null if not yet completed.
Timestamp when the workflow run was created (ISO 8601).
The canonicalised state snapshot from the current poll.
Display title of the workflow run.
The event that triggered the workflow run.
Event type identifier.
Name of the branch the workflow ran on.
SHA of the head commit that triggered the workflow run.
URL to view the workflow run on GitHub.
Name of the workflow.
Owner of the repository.
The conclusion observed in the previous poll (before the change).
The canonicalised state snapshot from the previous poll.
The status observed in the previous poll (before the change).
Repository name.
Attempt number of the run (1 for first attempt).
Unique identifier of the workflow run.
Auto-incrementing run number for the workflow.
Timestamp when the workflow run started (ISO 8601).
Current status of the workflow run. One of: queued, in_progress, completed, waiting, requested, pending.
Timestamp when the workflow run was last updated (ISO 8601).
Every operation an agent can call against GitHub, with input parameters and output schema. Drop these into any step of an agent built in Helix.
GITHUB_ABORT_REPOSITORY_MIGRATIONTool to abort a repository migration that is queued or in progress. Use when you need to cancel an ongoing migration operation.
Input parameters
The ID of the repository migration to abort. This is the migration ID returned when a migration was queued (e.g., 'RM_kgDOABCDEF').
A unique identifier for the client performing the mutation. This can be used to track the mutation in logs or for idempotency purposes.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ACCEPT_REPOSITORY_INVITATIONAccepts a PENDING repository invitation that has been issued to the authenticated user.
Input parameters
Unique identifier of the repository invitation sent TO the authenticated user. Get this ID by listing your pending invitations using the 'List repository invitations for the authenticated user' action.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_APP_ACCESS_RESTRICTIONSAdds GitHub Apps to the list of apps allowed to push to a protected branch. The branch must already have protection rules with restrictions enabled. This endpoint only works for organization repositories, not personal repositories. Apps must be installed on the repository with 'contents' write permissions.
Input parameters
The list of GitHub App slugs with push access to grant. Apps must be installed on the repository and have 'contents' write permissions. The app slug is the URL-friendly name of the GitHub App (e.g., 'github-actions', 'dependabot').
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The organization name that owns the repository. This field is not case-sensitive. Note: This endpoint only works for organization-owned repositories.
The name of the branch to which restrictions will be applied. Wildcard characters (e.g., '*') are not allowed in the branch name when using this REST API endpoint. For operations involving wildcard branch names, consult the GitHub GraphQL API.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_A_REPOSITORY_COLLABORATORAdds a GitHub user as a repository collaborator, or updates their permission if already a collaborator; `permission` applies to organization-owned repositories (personal ones default to 'push' and ignore this field), and an invitation may be created or permissions updated directly.
Input parameters
The name of the repository, without the `.git` extension. This name is not case sensitive.
The account owner of the repository. This name is not case sensitive.
The GitHub handle for the user account to add as a collaborator. Cannot be the same as the repository owner, as owners are automatically collaborators.
Permission level for the collaborator. For organization-owned repositories, valid values are `pull` (read-only), `triage` (manage issues/PRs), `push` (read/write), `maintain` (manage most settings), `admin` (full control), or a custom repository role name if defined by the owning organization. This parameter is ignored for personal repositories, which grant `push` access.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_ASSIGNEES_TO_AN_ISSUEAdds assignees to a GitHub issue. This action only adds users - it does not remove existing assignees. Changes are silently ignored if the authenticated user lacks push access to the repository.
Input parameters
The name of the repository, without the `.git` extension. This field is not case sensitive.
The username of the account or the organization name that owns the repository. This field is not case sensitive.
A list of GitHub usernames to add as assignees to the issue. Up to 10 assignees total can be on an issue. NOTE: This endpoint ADDS assignees - it does not replace existing ones. Users already assigned are kept. To remove assignees, use the 'remove_assignees_from_an_issue' action instead. The authenticated user must have push access to the repository; otherwise changes are silently ignored.
The unique number identifying the issue within the repository. Must be a positive integer (GitHub issue numbers start at 1).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_EMAIL_ADDRESS_FOR_AUTHENTICATED_USERAdds one or more email addresses (which will be initially unverified) to the authenticated user's GitHub account; use this to associate new emails, noting an email verified for another account will error, while an existing email for the current user is accepted.
Input parameters
Array of email addresses to add to the authenticated user account. Must contain at least one email address.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_FIELD_TO_USER_PROJECTTool to add a custom field to a user-owned GitHub Projects V2 project. Use when you need to add fields like status, priority, or custom data to organize project items.
Input parameters
The name of the field to create.
The handle for the GitHub user account.
The data type of the field. Use 'single_select' for dropdown fields, 'iteration' for sprint fields, or other types for simple fields.
The project's number.
Options for single select fields. Required when data_type is 'single_select'.
Configuration for iteration fields.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_ITEM_TO_USER_PROJECTTool to add an issue or pull request to a user-owned GitHub project. Use when you need to add existing repository items to a project board.
Input parameters
The unique identifier of the issue or pull request to add to the project. Required if owner, repo, and number are not provided.
The repository name. Required with owner and number if id is not provided.
The type of item to add to the project. Must be either Issue or PullRequest.
The repository owner login. Required with repo and number if id is not provided.
The issue or pull request number. Required with owner and repo if id is not provided.
The handle for the GitHub user account.
The project's number.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_LABELS_TO_AN_ISSUEAdds labels (provided in the request body) to a repository issue; labels that do not already exist are created.
Input parameters
Repository name, without the `.git` extension (case-insensitive).
Username or organization name owning the repository (case-insensitive).
Array of label names to add to the issue. Labels that don't exist will be created automatically.
Positive integer that uniquely identifies the issue within the repository. Must be >= 1.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_ORG_RUNNER_LABELSAdds new custom labels to an existing self-hosted runner for an organization; existing labels are not removed, and duplicates are not added.
Input parameters
The organization's name (case-insensitive).
A list of custom label names to add to the self-hosted runner. Previously applied labels are not removed.
Unique identifier of the self-hosted runner.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_OR_UPDATE_TEAM_MEMBERSHIP_FOR_USERAdds a GitHub user to a team or updates their role (member or maintainer), inviting them to the organization if not already a member; idempotent, returning current details if no change is made.
Input parameters
The name of the GitHub organization. This name is not case-sensitive.
The role to assign to the user within the team. A 'maintainer' has broader permissions than a 'member', such as managing team members and settings.
The GitHub username of the user to add or whose membership to update.
The slug (URL-friendly version) of the team's name. Must be lowercase with hyphens instead of spaces (e.g., 'my-team' not 'My Team'). Spaces will be automatically converted to hyphens and text will be lowercased.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_OR_UPDATE_TEAM_PROJECT_PERMISSIONSAdds a classic project to a team or updates the team's permission on it. This endpoint grants or updates permissions for a team on a specific classic project (not Projects V2). The authenticated user must have admin permissions for the project. Both the team and project must belong to the same organization. Requirements: - The project must be a classic project (not GitHub Projects V2) - The authenticated user must have admin permissions on the project - The team and project must be in the same organization - Requires 'admin:org' scope for the authentication token Returns HTTP 204 No Content on success, 403 if project is not an org project, or 404 if the organization, team, or project is not found.
Input parameters
The organization name (login) that owns both the team and the classic project. Case-insensitive.
The team's URL-friendly slug identifier within the organization. Found in the team's URL path.
Permission level to grant the team: 'read' (view only), 'write' (view and edit), or 'admin' (full control including settings). If omitted, uses the team's default permission.
The unique numeric ID of the classic project. This is NOT the project number displayed in the UI.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_OR_UPDATE_TEAM_REPOSITORY_PERMISSIONSSets or updates a team's permission level for a repository within an organization; the team must be a member of the organization.
Input parameters
Organization name where the team exists (case-insensitive). This is the organization that owns the team, not necessarily the repository owner.
Repository name, without the `.git` extension (case-insensitive).
Account owner of the repository (case-insensitive). This is the user or organization that owns the repository. In most cases, this should match the 'org' parameter value.
The team's slug (URL-friendly name).
Permission level to grant the team. Valid values: 'pull' (read-only), 'triage' (manage issues/PRs), 'push' (read/write), 'maintain' (manage repo settings plus push), 'admin' (full control). Custom repository role names are also supported if defined by the organization.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_PROJECT_COLLABORATORAdds a specified GitHub user as a collaborator to an existing organization project with a given permission level. Note: This endpoint is for organization projects (classic). You must be an organization owner or a project admin to add a collaborator. Classic projects are being deprecated in favor of the new Projects experience.
Input parameters
The GitHub username of the user to be added as a collaborator.
Permission level for the collaborator on the project.
The unique identifier of the organization project.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_REPOSITORY_TO_APP_INSTALLATIONAdds a repository to a GitHub App installation, granting the app access; requires authenticated user to have admin rights for the repository and access to the installation.
Input parameters
The unique identifier of the repository to add to the installation. The authenticated user must have admin permissions for this repository.
The unique identifier of the GitHub App installation to which the repository will be added. This installation must be accessible to the authenticated user.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_REPO_TO_ORG_SECRET_WITH_SELECTED_ACCESSAdds a repository to an existing organization-level GitHub Actions secret that is configured for 'selected' repository access.
Input parameters
The name of the GitHub organization. This field is not case-sensitive.
The name of the organization secret to which the repository will be added.
The unique identifier of the repository to be granted access to the organization secret.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_REPO_TO_ORG_SECRET_WITH_SELECTED_VISIBILITYGrants an existing repository access to an existing organization-level Dependabot secret when the secret's visibility is set to 'selected'; the repository must belong to the organization, and the call succeeds without change if access already exists.
Input parameters
The organization's unique handle/name (case-insensitive).
Name of the Dependabot secret; must be alphanumeric or underscore, no spaces (lowercase auto-converts to uppercase).
Unique ID of the repository to be granted access to the secret.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_RUNNER_LABELSAdds and appends custom labels to a self-hosted repository runner, which must be registered and active.
Input parameters
Name of the repository, without the `.git` extension. Case-insensitive.
Username or organization name of the repository owner. Case-insensitive.
Custom label names to add. Appended to existing labels. Names are case-insensitive. Empty list means no changes.
Unique ID of the self-hosted runner.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_SELECTED_REPOSITORY_TO_ORGANIZATION_SECRETAdds a repository to an organization secret's access list when the secret's visibility is 'selected'; this operation is idempotent.
Input parameters
The name of the organization. This name is not case sensitive.
The name of the secret. Secret names can only contain alphanumeric characters (\[A-Z\], \[a-z\], \[0-9\]) or underscores (_). Spaces are not allowed. Secret names cannot start with GITHUB_ and must be less than 255 characters.
The unique identifier of the repository to add to the secret's access list.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_SELECTED_REPOSITORY_TO_ORGANIZATION_VARIABLEGrants a repository access to an organization-level GitHub Actions variable, if that variable's visibility is set to 'selected_repositories'.
Input parameters
Name of the GitHub organization (case-insensitive).
Name of the existing organization-level GitHub Actions variable.
Unique identifier of the repository to grant access.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_SELECTED_REPOSITORY_TO_USER_SECRETGrants a specified repository access to an authenticated user's existing Codespaces secret, enabling Codespaces created for that repository to use the secret.
Input parameters
Name of the user-level Codespaces secret to which repository access is added; this secret must already exist for the authenticated user.
The unique identifier of the repository to be granted access to the specified user-level Codespaces secret.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_SOCIAL_ACCOUNTS_FOR_AUTHENTICATED_USERAdds one or more social media links (which must be valid, full URLs for platforms supported by GitHub) to the authenticated user's public GitHub profile.
Input parameters
Full URLs for social media profiles to add to the user's GitHub profile; these will be displayed publicly.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_STATUS_CHECK_CONTEXTSAdds status check contexts to a protected branch's required status checks. This action appends new status check contexts to the existing list of required status checks for a protected branch. The branch must already have branch protection enabled with status checks configured. Note: The 'contexts' parameter is deprecated by GitHub in favor of 'checks' array. For new implementations, consider using update_status_check_protection with the 'checks' parameter instead.
Input parameters
The name of the repository, without the `.git` extension. This name is not case sensitive.
The account owner of the repository. This name is not case sensitive.
The name of the branch to which status check contexts will be added. Branch names cannot contain wildcard characters. To use wildcard characters in branch names, refer to the GraphQL API.
The status check contexts to add to the protected branch. These are the names of CI/CD jobs or other checks that must pass before merging. Can be provided as a single string or a list of strings. Examples: 'ci/test', 'linter', 'continuous-integration/travis-ci'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_SUB_ISSUETool to add a sub-issue to a parent GitHub issue using GraphQL. Use when you need to establish a parent-child relationship between issues. Requires the 'sub_issues' GraphQL feature to be enabled.
Input parameters
The global node ID of the parent issue (e.g., 'I_kwDOABCDEFGH'). This is the GraphQL global identifier returned by GitHub's API.
The global node ID of the sub-issue to link to the parent issue. Either sub_issue_id or sub_issue_url must be provided.
The URL of the sub-issue to link to the parent issue. Either sub_issue_id or sub_issue_url must be provided.
If true, replaces the existing parent issue if the sub-issue already has one. If false or omitted, the mutation will fail if the sub-issue already has a parent.
A unique identifier for the client performing the mutation. Used to ensure idempotency of mutations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_TEAM_ACCESS_RESTRICTIONSAdds teams to the list of teams with push access to a protected branch. This action grants additional teams push access to a protected branch. Unlike 'Set team access restrictions' (PUT), this action adds to the existing list rather than replacing it entirely. Prerequisites: - The repository must be owned by an organization (not a personal account) - The branch must have protection rules enabled - The branch protection must have restrictions configured - The teams must exist in the organization and have repository access
Input parameters
The name of the repository, without the `.git` extension. This value is not case-sensitive.
The organization name that owns the repository. Team access restrictions only work for organization-owned repositories, not personal repositories. This value is not case-sensitive.
The list of team slugs to add push access to the protected branch. A team slug is the URL-friendly version of the team name (lowercase, hyphens instead of spaces). The teams must already have access to the repository. This adds teams to the existing list (does not replace the entire list).
The name of the protected branch to add team restrictions to. The branch must already have branch protection enabled with restrictions configured. Wildcard characters are not supported. For wildcard branch protection, use the GitHub GraphQL API.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_USER_ACCESS_RESTRICTIONSAdds users to the list of people allowed to push to a protected branch in an organization repository. Important notes: - This action only works on organization-owned repositories (not personal repos) - The branch must already have protection rules with restrictions enabled - Users must have write access to the repository to be added - The combined total of users, apps, and teams is limited to 100 items
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository (must be an organization for user restrictions). This name is not case-sensitive.
The list of user logins to grant push access to the protected branch. Users must have write access to the repository. An empty list will remove all user restrictions.
The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, refer to the GitHub GraphQL API documentation.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ADD_USERS_TO_CODESPACES_ACCESS_FOR_ORGANIZATIONAdds organization members to the list of users granted Codespaces access billed to the organization. IMPORTANT: This endpoint requires the organization's Codespaces billing access to be set to 'selected_members' mode. If not already configured, use the GITHUB_MANAGE_ACCESS_CONTROL_FOR_ORGANIZATION_CODESPACES action first to set visibility to 'selected_members'.
Input parameters
Organization's name (case-insensitive).
Usernames of organization members to be granted Codespaces access billed to the organization. These users must be members of the specified organization.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_API_ROOTRetrieves a map of all top-level GitHub REST API resource URLs and their templates.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_APPROVE_WORKFLOW_RUN_FOR_FORK_PULL_REQUESTApproves a workflow run from a forked repository's pull request; call this when such a run requires manual approval due to workflow configuration.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The unique identifier of the workflow run requiring approval.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ASSIGN_ORGANIZATION_ROLE_TO_TEAMAssigns an existing organization-level role (identified by `role_id`) to a team (identified by `team_slug`) within a GitHub organization (`org`), provided the organization, team, and role already exist.
Input parameters
The name of the GitHub organization. This field is case-insensitive.
Unique identifier of the organization role to assign to the team (obtainable by listing organization roles).
The slug (URL-friendly version) of the team's name.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ASSIGN_ORGANIZATION_ROLE_TO_USERAssigns a specific organization role to a user who is a member or an outside collaborator in a GitHub organization, using a valid role ID.
Input parameters
The organization's name. This is not case-sensitive.
The unique integer identifier for the organization role. This ID can be obtained by listing the organization's roles.
The GitHub username of the user to whom the role will be assigned.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_AUTH_USER_DOCKER_CONFLICT_PACKAGES_LISTList Docker packages with migration conflicts for the authenticated user. This endpoint lists all Docker packages owned by the authenticated user that encountered namespace conflicts during the Docker-to-GitHub Container Registry (GHCR) migration. Conflicts occur when a package with the same name exists in both the legacy Docker registry and GHCR. IMPORTANT: The Docker registry for GitHub Packages was deprecated on Feb 24, 2025. This endpoint may return a 400 error with message 'Package migration for docker is no longer supported' as the migration period has ended. In this case, the action returns an informative response instead of failing. Use case: Identifying packages that require manual migration to GHCR. Required scope: read:packages (for OAuth and personal access tokens).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_BLOCK_USERBlocks an existing individual GitHub user (not an organization or your own account), preventing them from interacting with your account and repositories.
Input parameters
The GitHub username (handle) of the user to block. Case-insensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_BLOCK_USER_FROM_ORGANIZATIONBlocks a GitHub user from an organization, preventing their contributions, collaboration, and forking of the organization's repositories. Requires admin or 'Blocking users' organization permission (write access).
Input parameters
The organization name (case-insensitive). You must have admin or 'Blocking users' permission in this organization.
The GitHub username (handle) of the account to block from the organization.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CANCEL_GITHUB_PAGES_DEPLOYMENTCancels an existing, ongoing or queued GitHub Pages deployment for a repository using its `pages_deployment_id`.
Input parameters
Repository name, excluding the `.git` extension. Not case-sensitive.
Username or organization that owns the repository. Not case-sensitive.
Unique numerical ID of the GitHub Pages deployment (not the commit SHA).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CANCEL_SPONSORSHIPTool to cancel an active GitHub sponsorship using GraphQL. Use when you need to terminate a sponsorship relationship between a sponsor and a sponsorable entity. Either sponsor ID/login and sponsorable ID/login must be provided.
Input parameters
The global node ID of the user or organization acting as sponsor (e.g., 'U_kgDOABCDEF'). Required if sponsor_login is not provided.
The username of the sponsoring user or organization. Required if sponsor_id is not provided.
The global node ID of the user or organization receiving the sponsorship (e.g., 'U_kgDOMNOPQR'). Required if sponsorable_login is not provided.
The username of the sponsored user or organization. Required if sponsorable_id is not provided.
A unique identifier for the client performing the mutation. Used to ensure idempotency of mutations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CANCEL_WORKFLOW_RUNCancels a workflow run in a GitHub repository if it is in a cancellable state (e.g., 'in_progress' or 'queued'). Returns 202 Accepted on success.
Input parameters
The name of the repository, without the `.git` extension (not case-sensitive).
The account owner of the repository (not case-sensitive).
Unique identifier of the workflow run.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CHECK_IF_GIST_IS_STARREDChecks if a gist is starred by the authenticated user. Returns `is_starred: true` if the gist is starred (HTTP 204), or `is_starred: false` if not starred (HTTP 404). Use this to verify star status before starring/unstarring a gist.
Input parameters
The unique identifier (ID) of the gist to check. Can be found in the URL of the gist (e.g., 'https://gist.github.com/{user}/{gist_id}').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CHECK_IF_PULL_REQUEST_HAS_BEEN_MERGEDChecks if a specified GitHub pull request has been merged, indicated by a 204 HTTP status (merged) or 404 (not merged/found).
Input parameters
The name of the repository, without the `.git` extension (not case sensitive).
The account owner of the repository (not case sensitive).
The number that identifies the pull request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CHECK_IF_USER_CAN_BE_ASSIGNEDVerifies if a GitHub user can be assigned to issues in a repository; assignability is confirmed by an HTTP 204 (No Content) response, resulting in an empty 'data' field in the response.
Input parameters
The name of the repository, without the `.git` extension. This name is not case sensitive.
The account owner of the repository (e.g., a GitHub username or organization name). This name is not case sensitive.
The GitHub username of the user to check for assignability. This name is not case sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CHECK_IF_USER_CAN_BE_ASSIGNED_TO_ISSUEChecks if a specified GitHub user can be assigned to a given issue within a repository.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username of the account owning the repository. This field is not case-sensitive.
The GitHub username of the user to check for assignment permissions.
The unique number identifying the issue within the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CHECK_IF_USER_FOLLOWS_ANOTHER_USERChecks if a GitHub user `username` follows `target_user`; returns a 204 HTTP status if true, 404 if not or if users are invalid.
Input parameters
The GitHub username of the user to check.
The GitHub username of the user to verify if they are followed by the `username`.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CHECK_IF_USER_IS_BLOCKED_BY_AUTHENTICATED_USERChecks if the specified GitHub user is blocked by the authenticated user; a 204 No Content response indicates the user is blocked, while a 404 Not Found indicates they are not.
Input parameters
The GitHub username (handle) of the user.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CHECK_IF_USER_IS_BLOCKED_BY_ORGANIZATIONChecks if a GitHub user is blocked by an organization. Returns is_blocked=True if the user is blocked (HTTP 204), or is_blocked=False if not blocked (HTTP 404). Requires 'Blocking users' organization permission (read access).
Input parameters
The organization name (case-insensitive). Must be an organization where you have 'Blocking users' permission (read access).
The GitHub username (handle) to check if blocked by the organization.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CHECK_IF_USER_IS_REPOSITORY_COLLABORATORChecks if a user is a collaborator on a specified GitHub repository, returning a 204 status if they are, or a 404 status if they are not or if the repository/user does not exist.
Input parameters
The name of the repository, without the `.git` extension. This name is not case sensitive.
The account owner of the repository, typically a GitHub username or an organization name. This name is not case sensitive.
The GitHub username of the user whose collaborator status is being checked. This name is not case sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CHECK_PERSON_FOLLOWED_BY_AUTH_USERChecks if the authenticated GitHub user follows a target GitHub user. Returns a structured response with is_following=True when following (HTTP 204), or is_following=False when not following (HTTP 404).
Input parameters
The GitHub username (e.g., 'octocat') of the person to check. This is the user's handle on GitHub.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CHECK_PRIVATE_VULNERABILITY_REPORTING_STATUSChecks if private vulnerability reporting is enabled for the specified repository.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CHECK_PUBLIC_ORGANIZATION_MEMBERSHIP_FOR_USERTool to check if a user is a public member of an organization. Use when you need to verify public organization membership status.
Input parameters
The organization name. The name is not case sensitive.
The handle for the GitHub user account.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CHECK_TEAM_PERMISSIONS_FOR_A_PROJECTChecks if a team has 'read', 'write', or 'admin' permissions for an organization's specific classic project, returning the project's details if access is confirmed.
Input parameters
The name of the organization. This is case-insensitive.
The slug (short name) of the team.
The unique identifier of the project (classic).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CHECK_TEAM_PERMISSIONS_FOR_A_REPOSITORYChecks a team's permissions for a specific repository within an organization, including permissions inherited from parent teams.
Input parameters
The name of the organization. This field is not case-sensitive.
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The organization that owns the repository. For this GitHub API endpoint, this value must be the same as the `org` parameter. This field is not case-sensitive.
The URL-friendly slug for the team name. It is unique within the organization and typically all lowercase with hyphens instead of spaces.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CHECK_TOKENChecks if a GitHub App or OAuth access_token is valid for the specified client_id and retrieves its details, typically to verify its active status and grants. NOTE: This endpoint requires Basic Authentication using the OAuth App's client_id as username and client_secret as password. The access_token parameter must be an OAuth token issued by the specified OAuth App.
Input parameters
The unique client ID of your GitHub OAuth App (must match the app that issued the token being checked).
The OAuth access token issued by your OAuth App that you want to validate. Returns 404 if the token is invalid or not issued by this client_id.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CLEAR_PROJECT_V2_ITEM_FIELD_VALUETool to clear the value of a field for an item in a GitHub Project V2. Use when you need to remove or reset a field value (text, number, date, assignees, labels, single-select, iteration, or milestone fields).
Input parameters
The global node ID of the project item to update (e.g., 'PVTI_lAHOCNqc1s4BN3oqzgldG_w'). This identifies the specific item within the project whose field value will be cleared.
The global node ID of the field to clear (e.g., 'PVTSSF_lAHOCNqc1s4BN3oqzg8vTnA'). Currently supports text, number, date, assignees, labels, single-select, iteration and milestone fields.
The global node ID of the Project (e.g., 'PVT_kwHOCNqc1s4BN3oq'). This identifies the project containing the item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CLEAR_REPOSITORY_CACHE_BY_KEYDeletes GitHub Actions caches from a repository matching a specific `key` and an optional Git `ref`, used to manage storage or clear outdated/corrupted caches; the action succeeds even if no matching caches are found to delete.
Input parameters
The exact cache key used to identify specific caches for deletion. This key is often dynamically generated in workflows using expressions (e.g., `${{ runner.os }}-npm-${{ hashFiles('**/package-lock.json') }}`).
The full Git reference for narrowing down the cache deletion. For example, to target caches for a specific branch, use `refs/heads/<branch_name>`. To target caches for a pull request, use `refs/pull/<pull_number>/merge`. If omitted, caches matching the key across all refs are considered.
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CLEAR_SELF_HOSTED_RUNNER_ORG_LABELSRemoves all custom labels from a self-hosted runner for an organization; default labels (e.g., 'self-hosted', 'linux', 'x64') will remain.
Input parameters
The name of the GitHub organization that owns the self-hosted runner (case-insensitive).
Unique numeric identifier of the self-hosted runner. Can be obtained from listing runners for the organization.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_COMMIT_MULTIPLE_FILESTool to atomically create, update, or delete multiple files in a GitHub repository as a single commit. Uses Git Data APIs to avoid SHA mismatch conflicts that occur with the Contents API when multiple files are modified in parallel. Use when you need to make multi-file changes reliably. BRANCH CREATION: When committing to a new branch (e.g., 'fix/my-fix' or 'feature/new-feature'), you MUST provide 'base_branch' (typically 'main' or 'master') to create the branch from. If the branch already exists, base_branch is not needed. This action handles race conditions automatically: if the branch is updated by another commit between fetching the HEAD and updating the reference (resulting in a 422 'not a fast forward' error), the action will retry by refetching the HEAD and rebasing changes. Use max_retries to control this behavior.
Input parameters
Repository name (without .git extension)
Force update the branch reference. WARNING: Use with caution as this can overwrite commits. Only use this when you intentionally want to overwrite the branch history.
Repository owner (username or organization name)
Git author or committer information.
Target branch name to commit to. If this branch doesn't exist, you MUST provide 'base_branch' to create it. For new feature branches (e.g., 'fix/my-fix', 'feature/new-feature'), always set base_branch='main' (or your default branch).
List of file paths to delete from the repository. Files must exist in the repository; attempting to delete non-existent files will result in an error. Ensure paths are exact with no leading/trailing whitespace.
Commit message describing the changes
List of files to create or update. Each entry requires path, content, and optional encoding (utf-8 or base64)
Git author or committer information.
REQUIRED when committing to a new branch that doesn't exist yet. Specifies the existing branch to create the new branch from (e.g., 'main' or 'master'). Not needed if 'branch' already exists in the repository.
Maximum number of retries when encountering race conditions (422 'not a fast forward' errors). The action will refetch the HEAD and rebase changes on each retry. Set to 0 to disable retries.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_COMPARE_TWO_COMMITSCompares two commit points (commits, branches, tags, or SHAs) within a repository or across forks, using `BASE...HEAD` or `OWNER:REF...OWNER:REF` format for the `basehead` parameter.
Input parameters
Page number of the results to fetch, for pagination when the number of differences (commits or files) is large.
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
A string specifying the base and head references to compare, in the format `BASE...HEAD`. `BASE` and `HEAD` can be branch names (e.g., `main...develop`), tag names (e.g., `v1.0.0...v1.1.0`), or commit SHAs (abbreviated or full 40-character format). Both abbreviated and full SHAs are accepted; full 40-character SHAs are recommended for reliability in large repositories. Both references must exist in the specified repository. To compare branches across forks in the same network, use the format `OWNER:REF...OWNER:REF` (e.g., `octocat:main...another-user:main`). Do NOT pass GitHub URLs - only plain reference strings like 'main...develop' are accepted.
Number of results (e.g., files or commits) to return per page, with a maximum of 100, for pagination.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CONFIGURE_JIT_RUNNER_FOR_ORGGenerates a JIT configuration for a GitHub organization's new self-hosted runner to run a single job then unregister; requires admin:org scope and the runner_group_id must exist in the organization.
Input parameters
Name of the GitHub organization (case-insensitive).
Desired name for the new self-hosted runner, visible in the GitHub UI.
Custom labels to assign to the new self-hosted runner, used by GitHub Actions to route jobs. **Minimum items**: 1. **Maximum items**: 100.
Path to the working directory on the runner machine where jobs will execute, relative to the runner's installation directory.
ID of the runner group to assign the new self-hosted runner. Must exist in the organization. You can get runner group IDs by calling the 'List self-hosted runner groups for an organization' endpoint (GET /orgs/{org}/actions/runner-groups).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CONFIGURE_OIDC_SUBJECT_CLAIM_TEMPLATESets or updates the OIDC subject claim customization template for an existing GitHub organization by specifying which claims (e.g., 'repo', 'actor') form the OIDC token's subject (`sub`). This action customizes which claim keys are included in the OIDC subject claim for the specified organization. It allows for fine-tuning the content of the subject claim based on organizational needs.
Input parameters
The GitHub organization name (case-insensitive).
Array of unique strings, each a valid claim key (e.g., 'repo', 'actor'; alphanumeric/underscores only), to include in the OIDC subject claim (`sub`).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CONVERT_ORG_MEMBER_TO_OUTSIDE_COLLABORATORConverts an existing organization member, who is not an owner, to an outside collaborator, restricting their access to explicitly granted repositories.
Input parameters
The organization name (case-insensitive).
If true, performs the conversion asynchronously (API returns a 202 status when the job is successfully queued).
The GitHub username of the member to convert.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_BLOBCreates a Git blob in a repository, requiring content and encoding ('utf-8' or 'base64'). Requires write access to the repository.
Input parameters
The name of the repository, without the '.git' extension. This field is not case-sensitive. The repository must exist and you must have write access to it.
The username or organization name that owns the repository. This field is not case-sensitive. You must have write access to the repository.
The content to be stored in the new blob.
The encoding for the 'content'; "utf-8" or "base64".
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_CHECK_RUNCreates a new check run for a specific commit in a repository, used by external services to report status, detailed feedback, annotations, and images directly within the GitHub UI. NOTE: This endpoint requires GitHub App authentication - OAuth tokens and personal access tokens cannot create check runs.
Input parameters
The name of the check to be displayed in the GitHub UI. For example, "Code Coverage" or "Linter".
The name of the repository, without the `.git` extension. This name is not case sensitive.
The account owner of the repository. This name is not case sensitive.
The current status of the check run. Only GitHub Actions can set `status` to `waiting`, `pending`, or `requested`.
A list of up to three action objects defining interactive buttons displayed on GitHub after the check run completes. Each object needs a `label` (button text), `identifier` (unique ID for the action), and `description` (tooltip). Clicking a button sends a `check_run.requested_action` webhook to your app.
The SHA of the commit for which the check run is created.
**Required if `completed_at` is provided or if `status` is `completed`**. Specifies the final outcome of the check (e.g., 'success', 'failure'). Note: Setting `conclusion` automatically sets `status` to `completed`. GitHub alone can set a conclusion to `stale`.
The ISO 8601 timestamp (YYYY-MM-DDTHH:MM:SSZ) indicating when the check run began.
The URL of the integrator's site providing full details of the check. If omitted, the GitHub App's homepage is used. This URL is available from the check's UI.
A unique identifier for the check run on the integrator's system. This helps in correlating check runs between GitHub and the external system.
The ISO 8601 timestamp (YYYY-MM-DDTHH:MM:SSZ) indicating when the check run finished. **Required if `status` is `completed`**.
Detailed textual information about the check run's output. Supports Markdown. **Maximum length**: 65,535 characters.
A descriptive title for the output of the check run, displayed in the GitHub UI. For example, 'Linter Scan Summary'.
A list of image objects to display in the check run's output in the GitHub UI. Each object requires `alt` (alternative text), `image_url` (URL of the image), and an optional `caption`.
A summary of the check run's findings. Supports Markdown. **Maximum length**: 65,535 characters.
A list of annotation objects detailing issues at specific code locations. Annotations are visible in the 'Checks' and 'Files changed' tabs of a pull request. Each annotation object should specify `path`, `start_line`, `end_line`, `annotation_level` ('notice', 'warning', or 'failure'), and `message`. Optional fields include `start_column`, `end_column`, `title`, and `raw_details`. Up to 50 annotations per API request; for more, use subsequent 'Update a check run' calls. GitHub Actions limits are 10 warnings and 10 errors per step.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_CHECK_SUITECreates a new check suite for a specific commit (`head_sha`) in an original repository (not a fork). IMPORTANT: This endpoint requires a GitHub App installation access token - OAuth tokens and classic personal access tokens cannot use this endpoint. GitHub dispatches a `check_suite` webhook event with the `requested` action upon success.
Input parameters
Repository name, without the `.git` extension (case-insensitive).
Account owner of the repository (case-insensitive).
SHA of the commit for which to create the check suite, typically the head commit of a branch.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_CODESPACE_FOR_THE_AUTHENTICATED_USERCreates a GitHub Codespace for the authenticated user, requiring a JSON request body with either `repository_id` (integer) or a `pull_request` object (containing `pull_request_number` (integer) and `repository_id` (integer)). This action allows users to set up a development environment quickly by creating a codespace from a specified repository or pull request.
Input parameters
Git ref (branch, tag, or commit SHA) to use for the codespace.
ID of the repository to create the codespace from.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_CODESPACE_FROM_A_PULL_REQUESTCreates a GitHub Codespace for an open pull request in a Codespaces-enabled repository, with options to customize its configuration.
Input parameters
Geographic area for this codespace (e.g., `UsEast`, `EuropeWest`); supersedes `location`. If unspecified, typically IP-derived.
The name of the repository, without the `.git` extension. This is case-insensitive.
The username of the account that owns the repository. This is case-insensitive.
Machine type for this codespace (e.g., `standardLinux`). Varies by CPU, RAM, storage. Uses default if unspecified.
Requested geographic location (e.g., `EastUs`, `WestEurope`). This parameter is deprecated; use `geo`. If unspecified, location may be IP-derived.
Client's public IP address for location auto-detection if proxied and `geo` or `location` are not specified.
The unique number identifying the pull request.
Custom name for the codespace.
Path to a `devcontainer.json` file in the repository that defines the development environment.
Working directory for the codespace upon opening. Defaults to the repository root if unspecified.
Minutes of inactivity after which the codespace is automatically stopped. A default timeout applies if unspecified.
Retention period in minutes (0-43200, i.e., up to 30 days) for a stopped codespace. 0 means immediate deletion.
Set to `true` to prevent GitHub from requesting additional repository permissions defined in `devcontainer.json`. Defaults to `false` (permissions will be requested).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_CODESPACE_IN_A_REPOSITORYCreates a GitHub Codespace for the authenticated user in a specified repository, which must be accessible and use a valid `devcontainer.json` if `devcontainer_path` is specified.
Input parameters
Geographic area for the codespace, replacing `location`; determined by user IP if not specified.
Git reference (e.g., branch name) for the codespace; uses repository's default branch if not provided.
Name of the repository, without the `.git` extension; not case-sensitive.
Username or organization name owning the repository; not case-sensitive.
Machine type (CPU, RAM, storage). See 'List available machine types for a repository' action for options; uses a default type if not specified.
Requested AWS region (best-effort, may differ); determined by user IP if not provided. Deprecated: use `geo`.
IP address to infer preferred region if `location` and `geo` are unspecified; useful for proxied requests.
Custom display name for the codespace; a default name is generated if not provided.
Path to a `devcontainer.json` in the repository; uses `.devcontainer/devcontainer.json` or `devcontainer.json` at root if not specified.
Directory to use as default when codespace opens; uses repository root if not specified.
Minutes of inactivity before codespace auto-stops; uses a default timeout if not specified.
Minutes an idle (stopped) codespace is retained before auto-deletion (0-43200, i.e., up to 30 days); uses a default period if not specified.
If `true`, opts out of granting multi-repository permissions from `devcontainer.json`. If unspecified or `false`, permissions are granted if requested.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_COMMITCreates a new commit in a GitHub repository; the `tree` SHA and any `parents` SHAs must already exist in the repository.
Input parameters
Name of the repository, without the `.git` extension (case-insensitive).
SHA of the tree object for this commit; must exist in the repository.
Account owner of the repository (case-insensitive).
The commit message.
SHAs of parent commits; all must exist in the repository. Omit or provide an empty list for a root commit.
ASCII-armored detached PGP signature over the commit data. GitHub adds this to the `gpgsig` header if provided.
Timestamp (ISO 8601: `YYYY-MM-DDTHH:MM:SSZ`) when the commit was authored.
Name of the commit's author. Defaults to authenticated user if not provided.
Email of the commit's author. Defaults to authenticated user if not provided.
Timestamp (ISO 8601: `YYYY-MM-DDTHH:MM:SSZ`) when the commit was committed. Defaults to `author_date` or current time.
Name of the committer. Defaults to author's name or authenticated user if not provided.
Email of the committer. Defaults to author's email or authenticated user if not provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_COMMIT_COMMENTCreates a comment on a specific commit, or on a specific line if `path` and `position` are provided.
Input parameters
The text content of the comment.
**Deprecated:** Use `position` instead. Line number in the file to comment on. `position` takes precedence if both are provided.
Relative path of the file to comment on. If specified, `position` is also required.
The name of the repository, without the `.git` extension.
The username or organization name that owns the repository.
Line number in the diff's patch to comment on, relative to the commit's changes. Required if `path` is specified.
The SHA identifier of the commit to comment on.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_COMMIT_STATUSSets a commit's status (e.g., error, failure, pending, success from CI/CD) for a given SHA; max 1000 statuses per SHA/context.
Input parameters
SHA hash of the commit.
Repository name, without the `.git` extension (case-insensitive).
Username or organization name of the repository owner (case-insensitive).
State of the commit status, indicating check outcome or phase.
Label to differentiate this status from other systems (e.g., 'ci/jenkins'); case-insensitive.
URL linking to the source of the status (e.g., CI build log), displayed in GitHub UI.
Human-readable description of the status, displayed in GitHub UI.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_CUSTOM_ORGANIZATION_ROLECreates a custom role with defined permissions within a GitHub organization.
Input parameters
Name of the GitHub organization (case-insensitive) where the custom role will be created.
Unique name for the custom role.
Optional short description of the custom role's purpose or permissions.
List of fine-grained permission strings defining actions granted by this role. Use the List Organization Fine-Grained Permissions action to get available permissions for your organization.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_DEPLOY_KEYCreates a deploy key for a repository; the repository must exist and be accessible, and the provided key must be a valid public SSH key.
Input parameters
The full public SSH key. Ensure this is the public key, not the private key.
The name of the repository, without the `.git` extension. This is not case sensitive.
The username of the account that owns the repository. This is not case sensitive.
A descriptive name for the new deploy key. If not provided, a default name will be generated.
If `true`, the deploy key will only have read access. If `false` (default), the key will have read and write access. Write access grants significant privileges.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_DEPLOYMENTCreates a GitHub deployment for an existing repository, targeting a specific ref (branch, tag, or SHA) that must also exist within the repository.
Input parameters
The ref to deploy. This can be a branch name, a tag name, or a commit SHA.
The name of the repository, without the `.git` extension. This name is not case-sensitive. The repository must exist and the authenticated user must have write access to it.
Specifies a task to execute, e.g., `deploy` or `deploy:migrations`.
The account owner of the repository. This name is not case-sensitive. The repository must exist and the authenticated user must have access to it.
A JSON string payload providing additional information that a deployment system might need, customizable based on the deployment process.
Attempts to automatically merge the default branch into the requested ref if the ref is behind the default branch. Set to `false` to disable.
A short description of the deployment. Maximum length of 1000 characters.
Name for the target deployment environment (e.g., `production`, `staging`, `qa`).
A list of status check contexts to verify against commit status checks before creating the deployment. If omitted or `null`, GitHub verifies all unique contexts. Pass an empty list `\[\]` to bypass all checks.
Specifies if the given environment is specific to this deployment and will no longer exist at some point in the future (e.g., a staging environment for a pull request). Set to `true` if the environment is temporary.
Specifies if the given environment is one that end-users directly interact with.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_DEPLOYMENT_BRANCH_POLICYCreates a deployment branch or tag policy for an existing environment in a GitHub repository, using a Ruby File.fnmatch pattern (where `*` doesn't match `/`) to specify which branches or tags are deployable.
Input parameters
Name pattern for deployable branches/tags (Ruby File.fnmatch syntax; `*` won't match `/`, e.g., `release/*/*` for `release/feature/login`). Refer to \[Ruby File.fnmatch documentation\](https://ruby-doc.org/core-2.5.1/File.html#method-c-fnmatch).
Name of the repository, without the `.git` extension (not case sensitive).
Whether the policy targets a Git branch or a tag.
Account owner of the repository (not case sensitive).
Name of the target environment; URL-encode special characters (e.g., `/` as `%2F`).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_DEPLOYMENT_STATUSCreates a status for an existing deployment, updating its operational state, associated URLs, and description.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
State of the status. Setting a transient deployment to `inactive` shows it as `destroyed` in GitHub.
URL for deployment output. Preferred over `target_url`; setting this also sets `target_url` to the same value.
URL for deployment status updates or output. `log_url` is generally preferred.
Short description of the status (max 140 characters).
Name for the target deployment environment (e.g., `production`, `staging`). If unset, uses environment from previous status or deployment.
If true, sets prior successful, non-transient, non-production deployments in the same repository and environment to `inactive`.
The unique identifier of the deployment for which to create a status.
URL for accessing the target deployment environment.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_DISCUSSIONCreates a new discussion post on a specific team's page within an organization.
Input parameters
Name of the organization (not case-sensitive).
Main content of the discussion post, typically in markdown.
Title of the discussion post.
If `true`, post is private (visible only to team members, org owners, and team maintainers); `false` makes it public to all organization members.
URL-friendly version of the team name (slug).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_DISCUSSION_COMMENTCreates a new comment on an existing team discussion within a GitHub organization.
Input parameters
The name of the organization. This name is not case-sensitive.
The content of the discussion comment. Supports GitHub Flavored Markdown.
The slug (URL-friendly version) of the team name.
The unique number identifying the discussion within the team.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_FORKCreates a fork of an accessible repository, optionally into a specific organization, with a new name, or copying only the default branch.
Input parameters
The desired name for the newly created fork. If not provided, the new fork will have the same name as the original repository.
The name of the repository, without the `.git` extension. This field is not case sensitive.
The username or organization name that owns the repository. This field is not case sensitive.
The GitHub organization name to fork the repository into. If not specified, the fork will be created in the authenticated user's account.
Specifies whether to fork only the default branch of the repository. If `True`, only the default branch is copied. If `False` or not specified, all branches are copied.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_GISTCreates a new gist on GitHub with provided files, an optional description, and public/secret visibility.
Input parameters
JSON string representing content for the gist's files. Dictionary where keys are filenames and values are objects, each having a `content` key with the file's raw string data.
Indicates if the gist is public (`true`) or secret (`false`).
Optional description for the gist.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_GIST_COMMENTCreates a new comment on a specified GitHub gist.
Input parameters
The text of the comment to be posted on the gist.
The unique identifier of the gist.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_GITHUB_APP_FROM_A_MANIFESTUse this action to complete the GitHub App Manifest flow (step 3 of 3) by exchanging the temporary authorization `code` for the app's full configuration, including credentials and private key. The code is provided via redirect URL after creating the app through GitHub's web interface and must be used within 1 hour.
Input parameters
The temporary authorization code provided by GitHub during the app manifest flow (received as a query parameter in the redirect URL). This single-use code must be exchanged within 1 hour of generation to retrieve the app's configuration including credentials and private key.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_GITHUB_PAGES_DEPLOYMENTCreates a GitHub Pages deployment for a repository using a specified artifact and OIDC token, provided GitHub Pages is enabled and the artifact (containing static assets) is accessible.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The account owner of the repository (e.g., a GitHub username or organization name). This field is not case-sensitive.
OIDC token from GitHub Actions for deployment authorization, typically from `secrets.GITHUB_TOKEN` with `id-token: write` permission.
Identifier of a GitHub Actions artifact (e.g., .zip or .tar) with static assets for deployment. Artifact must belong to the repository. Either this or `artifact_url` is required.
Target environment for this GitHub Pages deployment. Defaults to `github-pages`.
URL of a GitHub Actions artifact (e.g., .zip or .tar) with static assets for deployment. Artifact must belong to the repository. Either this or `artifact_id` is required.
Unique string identifying the build version for this deployment, typically the Git commit SHA. Defaults to `GITHUB_SHA`.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_GITHUB_PAGES_SITEConfigures or updates GitHub Pages for a repository, setting build type and source; ensure a Pages workflow exists for 'workflow' `build_type`, or `source_branch` exists for 'legacy' or unspecified `build_type`. This action allows users to effectively manage their GitHub Pages site settings, specifying how the site is built and where the source files are located.
Input parameters
The name of the repository, without the '.git' extension. This field is case-insensitive.
The username or organization name that owns the repository. This field is case-insensitive.
Build process for the Pages site: 'legacy' (traditional GitHub Pages build) or 'workflow' (GitHub Actions). If omitted and `source_branch` is provided, defaults to 'legacy'. When 'workflow', `source_branch` and `source_path` are ignored.
Directory within `source_branch` for site source files (e.g., '/' for root, '/docs'). Ignored if `build_type` is 'workflow'.
The branch for GitHub Pages source (e.g., 'main', 'gh-pages'). Required if `build_type` is 'legacy' or not specified. It is ignored if `build_type` is 'workflow'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_LABELCreates a new label in a specified GitHub repository, provided the repository exists and the user has write permissions.
Input parameters
The name of the label. Emoji can be added to label names, using either native emoji or colon-style markup. For example, typing `:strawberry:` will render the emoji !\[:strawberry:\](https://github.githubassets.com/images/icons/emoji/unicode/1f353.png ":strawberry:"). For a full list of available emoji and codes, see the "\[Emoji cheat sheet\](https://github.com/ikatyang/emoji-cheat-sheet)."
The name of the repository, without the `.git` extension. This is not case sensitive.
The hexadecimal color code for the label (e.g., `f29513`), without the leading `#`. Required parameter.
The username of the account that owns the repository. This is not case sensitive.
A short description of the label. Maximum 100 characters.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_MILESTONECreates a milestone in a GitHub repository for tracking progress on issues or pull requests; requires repository existence and user write permissions.
Input parameters
Repository name, without the `.git` extension (case-insensitive).
Username of the repository owner (case-insensitive).
State of the milestone.
Title for the new milestone.
Due date for the milestone (ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`).
Detailed description of the milestone.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_AN_AUTOLINK_REFERENCE_FOR_A_REPOSITORYCreates a repository autolink to automatically convert text references (e.g., 'TICKET-123') into hyperlinks, using a unique `key_prefix` and a `url_template` that includes `<num>`.
Input parameters
The name of the repository, without the `.git` extension. The name is not case-sensitive.
The account owner of the repository. This can be a username or an organization name. The name is not case-sensitive.
Prefix that triggers the autolink (e.g., 'JIRA-'). When followed by an identifier, it's converted into a link. Must be non-empty and not contain spaces.
URL template for the autolink, using `<num>` as a placeholder for the reference identifier (e.g., 'https://example.atlassian.net/browse/<num>'). Behavior of `<num>` is determined by `is_alphanumeric`.
Specifies if the `<num>` placeholder in `url_template` matches alphanumeric characters (`A-Z` (case-insensitive), `0-9`, and `-`) or only numeric characters (`0-9`).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_AN_ENVIRONMENT_VARIABLECreates an encrypted environment variable for a pre-existing environment within a GitHub repository; will fail if the variable name already exists.
Input parameters
The name of the environment variable to create (e.g., `API_KEY`).
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
The value of the environment variable (e.g., `your_secret_token`). This value will be encrypted.
The name of the environment for which to create the variable. The name must be URL encoded if it contains special characters (e.g., slashes `/` must be replaced with `%2F`).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_AN_ISSUECreates a new issue in a GitHub repository, requiring the repository to exist and have issues enabled; specific fields like assignees, milestone, or labels may require push access.
Input parameters
The detailed textual contents of the new issue.
The name of the repository, without the `.git` extension (case-insensitive). The repository must exist, be accessible, and have issues enabled.
The GitHub account owner of the repository (case-insensitive). The repository must exist and be accessible to the authenticated user.
The title for the new issue.
Array of label names to associate with this issue (generally case-insensitive). NOTE: Only users with push access can set labels; they are silently dropped otherwise. Pass an empty list to clear all labels.
Login for the user to whom this issue should be assigned. NOTE: Only users with push access can set the assignee; it is silently dropped otherwise. **This field is deprecated in favor of `assignees`.**
GitHub login names for users to assign to this issue. NOTE: Only users with push access can set assignees; they are silently dropped otherwise.
The ID of the milestone to associate this issue with (e.g., "5"). NOTE: Only users with push access can set the milestone; it is silently dropped otherwise.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_AN_ISSUE_COMMENTCreates a new comment on an existing GitHub issue or pull request within the specified repository.
Input parameters
Comment content in GitHub Flavored Markdown.
Name of the repository (without `.git` extension); not case-sensitive.
Account owner of the repository (username or organization); not case-sensitive.
Number identifying the issue or pull request for the comment.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_AN_ORGANIZATION_PROJECTCreates a new classic project board within a specified GitHub organization. Note: This action uses GitHub's Projects (classic) REST API. The classic projects feature may be disabled in some organizations, and GitHub recommends migrating to Projects V2 (accessible via GraphQL API) for new projects. Requirements: - The authenticated user must be an organization member with project creation permissions - Classic projects must be enabled for the organization - Requires 'repo' and 'admin:org' or 'write:org' scopes
Input parameters
Name of the organization (not case-sensitive).
Body or description for the new project.
Name for the new project.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_AN_ORGANIZATION_REPOSITORYCreates a new repository within a specified GitHub organization, with options for detailed configuration including visibility, features, merge strategies, initial commit, and templates.
Input parameters
Name of the organization where the repository will be created (case-insensitive).
Name of the new repository.
Whether the repository is private. `visibility` takes precedence if both are set.
ID of the team to grant access to this repository within the organization.
Enable wiki for this repository.
URL for the repository's homepage.
Create an initial commit with an empty README.
Enable issues for this repository.
Repository visibility: 'public' (visible to everyone) or 'private' (visible to collaborators).
Short description of the repository.
Make this repository a template repository.
Enable projects for this repository. Fails if organization has disabled repository projects and this is true.
Enable downloads for this repository (deprecated).
Allow auto-merge on pull requests.
License template keyword (e.g., "mit", "apache-2.0"). See \[GitHub license documentation\](https://docs.github.com/articles/licensing-a-repository/#searching-github-by-license-type) for options.
JSON string containing custom properties for the repository as a key-value object. Example: '{"project_lead": "octocat", "status": "alpha"}'
Allow merging pull requests with a merge commit.
Allow rebase-merging pull requests.
Allow squash-merging pull requests.
Name of the .gitignore template to apply (e.g., "Python", "Node"). Refer to the \[GitHub gitignore template list\](https://github.com/github/gitignore).
Default title for merge commits: 'PR_TITLE' or 'MERGE_MESSAGE'.
Default message for merge commits: 'PR_TITLE', 'PR_BODY', or 'BLANK'.
Automatically delete head branches when pull requests are merged. Requires organization owner privileges if true.
Default title for squash merge commits: 'PR_TITLE' or 'COMMIT_OR_PR_TITLE'.
Default message for squash merge commits: 'PR_BODY', 'COMMIT_MESSAGES', or 'BLANK'.
DEPRECATED: Use `squash_merge_commit_title`. Default to pull request title for squash-merge commits.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_AN_ORGANIZATION_VARIABLECreates a new, uniquely named GitHub Actions variable for an organization, with configurable repository access visibility (all, private, or selected).
Input parameters
The name of the GitHub organization. This name is not case-sensitive.
The name of the organization variable. Must be unique at the organization level.
The value of the organization variable.
Controls which repositories in the organization can access the variable. Accepted values are 'all' (all repositories), 'private' (only private repositories), or 'selected' (specific repositories designated by `selected_repository_ids`).
A list of repository integer IDs that can access this organization variable. This field is required and only applicable when `visibility` is set to 'selected'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_AN_ORGANIZATION_WEBHOOKCreates a webhook for a GitHub organization to deliver event notifications to a configured URL.
Input parameters
The name of the GitHub organization. This name is not case-sensitive.
The name of the webhook. Must be "web" for organization webhooks. Defaults to "web".
Boolean indicating if the webhook is active. `true` sends notifications, `false` does not. Defaults to `true`.
List of event names to trigger the webhook. Use `\['*'\]` for all events. Defaults to `\['push'\]` if not specified. See GitHub docs for event types.
Required. The target URL for webhook payload delivery. This URL is a mandatory part of the webhook's `config` object and will receive POST requests for subscribed events.
Optional secret for generating an HMAC hex digest for payload verification (X-Hub-Signature-256 header). If provided, this is used as the key.
Password for basic authentication if the webhook endpoint (`config_url`) requires it, corresponding to `config_username`.
Username for basic authentication if the webhook endpoint (`config_url`) requires it. Use only if your endpoint is protected by basic auth.
The media type for serializing webhook payloads. Supported: `json`, `form`. GitHub API defaults to `form` if this field is not set or is `None`.
Controls SSL certificate verification for `config_url`. '1' disables verification (not recommended), '0' enables. GitHub API defaults to '0' (verification enabled) if this field is not set or is `None`.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_PROJECT_CARDCreates a project card in a GitHub project column (classic projects only). DEPRECATION NOTICE: GitHub Projects (classic) was sunset on August 23, 2024. This API only works with existing classic project columns. New classic projects cannot be created. Consider using GitHub Projects V2 (GraphQL API) instead. The request body must contain either: - `note`: A text note for the card - OR `content_id` AND `content_type`: To associate an issue or pull request
Input parameters
The text content for the card. Use this to create a note-only card. Either 'note' OR both 'content_id' and 'content_type' must be provided.
The unique identifier of the project column where the card will be created. This value is used as a path parameter in the API request URL (e.g., `/projects/columns/{column_id}/cards`).
The unique identifier of the issue or pull request to associate with this card. Required when content_type is specified. Get this from the issue/PR details (it's the numeric ID, not the issue number).
Type of content to associate with the card.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_PROJECT_COLUMNCreates a new column in a GitHub project (classic). DEPRECATION NOTICE: GitHub Classic Projects (V1) and its REST API were sunset on April 1, 2025. This action will return a 404 error on GitHub.com. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/
Input parameters
The name for the new project column.
The unique identifier of the target GitHub project (classic) where the new column will be created.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_PULL_REQUESTCreates a pull request in a GitHub repository, requiring existing `base` and `head` branches; `title` or `issue` must be provided.
Input parameters
The name of the branch you want the changes pulled into. This must be an existing branch on the current (target) repository. You cannot submit a pull request to one repository that requests a merge to a base branch of another repository.
The detailed description or contents of the pull request.
The name of the branch where your changes are implemented. IMPORTANT: This branch must already exist in the repository (or fork) before calling this action. You must first create the branch and push commits to it (using git or the 'Create a reference' action), then create the PR. For cross-repository pull requests, namespace `head` with the source owner and branch, like `username:branch`.
The name of the repository, without the `.git` extension. This name is not case-sensitive.
Indicates whether the pull request should be created as a draft. Draft pull requests cannot be merged until marked as ready for review.
The number of an existing issue in the repository to convert into a pull request. If provided, the issue's title and body may be used for the pull request. Required if `title` is not specified.
The account owner of the repository. This name is not case-sensitive.
The title of the new pull request. Required unless `issue` is specified.
The name of the repository (e.g., 'octocat/Hello-World') where the changes in the pull request were made. This field is required for cross-repository pull requests if both the source and target repositories are owned by the same organization but are different repositories.
Indicates whether maintainers of the upstream repository can modify the pull request. This is primarily relevant for pull requests originating from forks.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_REFERENCECreates a NEW Git reference (branch or tag) in a repository. IMPORTANT: This action ONLY creates NEW references - if the reference already exists, it will fail with a 422 'Reference already exists' error. To update an existing reference, use the 'Update a reference' (GITHUB_UPDATE_A_REFERENCE) action instead. The repository must not be empty prior to this operation.
Input parameters
Fully qualified reference to create (e.g., `refs/heads/master`, `refs/tags/v1.0.0`). Must start with `refs/` and contain at least two slashes.
SHA-1 hash of an existing commit in the repository that the new reference will point to.
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_REGISTRATION_TOKEN_FOR_AN_ORGANIZATIONGenerates a temporary (one-hour) registration token to add a new self-hosted runner to an organization for GitHub Actions.
Input parameters
The name of the organization. This name is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_REGISTRATION_TOKEN_FOR_A_REPOSITORYGenerates a time-limited token required to register a new self-hosted runner with a specific repository.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username of the account or the organization name that owns the repository. This field is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_RELEASECreates a release in a GitHub repository for a specified tag; the tag must be unique for published releases, and if a `discussion_category_name` is given, it must already exist.
Input parameters
A detailed description of the release. Markdown formatting is supported.
The title of the release. If omitted and `generate_release_notes` is false, it defaults to the `tag_name`.
The name of the repository, without the .git extension. This field is not case-sensitive.
Set to `true` to create an unpublished (draft) release. Defaults to `false`.
The account owner of the repository (username or organization name). This field is not case-sensitive.
The name of the tag for this release. This tag must be unique for published releases.
Set to `true` to identify this release as a pre-release. Defaults to `false`.
Specifies if this release should be marked as the latest for the repository. Draft releases and prereleases cannot be set as 'latest'.
Specifies the commitish value (e.g., branch name, tag name, or commit SHA) from which the Git tag is created. Defaults to the repository's default branch if the tag specified in `tag_name` doesn't exist yet.
Set to `true` to automatically generate the release title (`name`) and description (`body`) from the commit history since the last release. Defaults to `false`.
If specified, a new discussion will be created in this category and linked to the release. The category must already exist in the repository's discussions.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_REMOVE_TOKEN_FOR_AN_ORGANIZATIONGenerates a token, valid for one hour, to authenticate removing a self-hosted runner from an organization.
Input parameters
The unique identifier or name of the GitHub organization. This name is not case-sensitive. For example, if your organization's URL is github.com/my-org, 'my-org' is the value.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_REMOVE_TOKEN_FOR_A_REPOSITORYGenerates a temporary (one-hour validity) token required to unregister and remove a self-hosted runner from a repository.
Input parameters
Name of the repository, without the `.git` extension (not case-sensitive).
Username of the account owning the repository (not case-sensitive).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_REPLY_FOR_A_REVIEW_COMMENTPosts a reply to a specific review comment on a GitHub pull request, requiring the repository, pull request, and original comment to exist, and a non-empty reply body.
Input parameters
The text of the reply to the review comment.
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The unique identifier of the top-level review comment to which the reply is being made. This must be the ID of a top-level review comment, not a reply to that comment. Replies to replies are not supported.
The number that identifies the pull request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_REPOSITORY_DISPATCH_EVENTTriggers a GitHub Actions workflow or a webhook on a repository by creating a repository dispatch event, allowing programmatic triggering of workflows based on events outside of GitHub.
Input parameters
The name of the repository, without the `.git` extension (not case-sensitive).
The account owner of the repository (not case-sensitive).
Custom webhook event name (100 characters or fewer).
JSON string containing extra information for the webhook event (max 10 top-level properties), passed to the triggered workflow or action. Example: '{"ref": "main", "sha": "abc123"}'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_REPOSITORY_FOR_THE_AUTHENTICATED_USERCreates a new repository for the authenticated user, optionally within an organization if `team_id` is specified.
Input parameters
The name of the repository. Must be unique within your account. Will be used in the repository URL (github.com/username/repo-name). Can only contain alphanumeric characters, hyphens, underscores, and periods.
Whether the repository is private (true) or public (false).
The ID of the team to be granted access. Only valid if creating in an organization.
Whether the wiki is enabled.
A URL with more information about the repository.
Whether to initialize the repository with a README.
Whether issues are enabled.
A short description of the repository.
Whether this repository is a template repository.
Whether projects are enabled.
Whether downloads are enabled (deprecated by GitHub and may not be configurable).
Whether discussions are enabled.
Whether to allow auto-merge on pull requests.
SPDX license key identifier (lowercase). Examples: 'mit', 'apache-2.0', 'gpl-3.0'. Must be one of the GitHub-supported licenses.
Whether to allow merging pull requests with a merge commit.
Whether to allow rebase-merging pull requests.
Whether to allow squash-merging pull requests.
Desired .gitignore template (e.g., 'Python', 'Node').
The default title for a merge commit. `PR_TITLE` uses the pull request's title. `MERGE_MESSAGE` uses a classic title like 'Merge pull request #123 from branch-name'. Required when `merge_commit_message` is set. Valid combinations: (PR_TITLE, PR_BODY), (PR_TITLE, BLANK), (MERGE_MESSAGE, PR_TITLE).
The default message for a merge commit. `PR_BODY` uses the pull request's body. `PR_TITLE` uses the pull request's title. `BLANK` results in a blank commit message. Valid combinations with merge_commit_title: (PR_TITLE, PR_BODY), (PR_TITLE, BLANK), (MERGE_MESSAGE, PR_TITLE).
Whether to automatically delete head branches when pull requests are merged.
The default title for a squash merge commit. `PR_TITLE` uses the pull request's title. `COMMIT_OR_PR_TITLE` uses the commit's title (if only one commit) or the pull request's title (if multiple commits).
The default message for a squash merge commit. `PR_BODY` uses the pull request's body. `COMMIT_MESSAGES` uses the branch's commit messages. `BLANK` results in a blank commit message.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_REPOSITORY_FROM_AN_UNPUBLISHED_CODESPACEPublishes the specified codespace to a new repository, using the codespace's current state as the initial commit.
Input parameters
The desired name for the new repository to be created from the codespace. If omitted, GitHub might generate a name (e.g., based on the codespace name).
Specifies the visibility of the new repository. Set to `true` for a private repository, or `false` for a public one. Defaults to `false` (public).
The unique name of the codespace to be published as a new repository. This codespace must exist, be unpublished, and belong to the authenticated user.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_REPOSITORY_PROJECTCreates a new GitHub Projects V2 project board linked to a specified repository. Note: This action uses GitHub's Projects V2 GraphQL API. The legacy Projects V1 REST API has been sunset by GitHub. The project is owned by the repository owner (user or organization) and linked to the specified repository.
Input parameters
An optional detailed description for the project board. Note: GitHub Projects V2 does not support a body/description field during creation, so this field is accepted but not used.
The name of the project board to be created.
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_REPOSITORY_RULESETCreates a uniquely named ruleset for a repository, defining rules for branches or tags with specified enforcement, conditions, and bypass actors.
Input parameters
Unique name for the ruleset.
Name of the repository, without the `.git` extension (not case-sensitive).
Account owner of the repository (not case-sensitive).
Array of rule objects as a JSON string to be enforced. Each must have `type` and may have `parameters`. Refer to GitHub API docs for available rule types and parameters. Example: '\[{"type": "creation"}, {"type": "deletion"}\]'
The target of the ruleset, whether it applies to branches or tags.
Enforcement level: `disabled` (ruleset is not enforced), `active` (ruleset is enforced), or `evaluate` (test rules before enforcing; GitHub Enterprise only).
Actors that can bypass rules in this ruleset as a JSON string. Each actor object requires `actor_id`, `actor_type` (e.g., 'Team', 'Integration'), and `bypass_mode` (e.g., 'always'). Example: '\[{"actor_id": 1, "actor_type": "Team", "bypass_mode": "always"}\]'
Ref names or patterns to exclude. Condition fails if any pattern matches the ref name.
Ref names/patterns to include. Condition passes if one pattern matches the ref name. Use `~DEFAULT_BRANCH` for default branch, `~ALL` for all branches.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_REPOSITORY_USING_A_TEMPLATECreates a new repository from an existing template repository; the authenticated user must have access to the template and, if creating in an organization, repository creation permissions within it.
Input parameters
The desired name for the new repository to be created.
The username or organization name that will own the new repository. Defaults to the authenticated user if not provided.
Set to `true` to create a private repository, or `false` to create a public repository.
A brief summary or description for the new repository.
The name of the template repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the template repository. This field is not case-sensitive.
Set to `true` to copy the directory structure and files from all branches of the template repository, not just the default branch.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_REPOSITORY_VARIABLECreates a new, unencrypted variable in a repository for GitHub Actions workflows; fails if a variable with the same name already exists.
Input parameters
The name of the variable to create. Variable names are case-sensitive and can only contain alphanumeric characters (\[a-z\], \[A-Z\], \[0-9\]) or underscores (_). They cannot start with the `GITHUB_` prefix, and spaces are not allowed.
The name of the repository, without the `.git` extension. This field is not case sensitive.
The username or organization name that owns the repository. This field is not case sensitive.
The value of the variable. This will be stored as a string.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_REPOSITORY_WEBHOOKCreates a webhook for a specified repository; requires admin permissions on the repository.
Input parameters
Name of the webhook. Use `web`. This parameter currently only accepts `web` and defaults to `web` if not provided.
The name of the repository without the `.git` extension. This name is not case sensitive.
The account owner of the repository. This name is not case sensitive.
Determines if notifications are sent when the webhook is triggered. `true` sends notifications (active), `false` disables them (inactive).
List of events to trigger the webhook (e.g., `\['push'\]`, `\['issues'\]`). See GitHub documentation for 'webhook event payloads'.
The URL to which webhook payloads will be delivered via POST for subscribed events.
Optional secret string for HMAC hex digest in delivery signature headers, enhancing security. See GitHub's 'delivery signature headers' documentation for details.
Media type for serializing payloads: `json` or `form`. Defaults to `form` if not specified. `json` delivers JSON, `form` delivers URL-encoded data.
Determines SSL certificate verification for the payload URL: "0" to verify SSL (recommended), or "1" to skip. Defaults to "0" (verify SSL) if not provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_REVIEW_COMMENT_FOR_A_PULL_REQUESTCreates a review comment on a pull request's diff, targeting a specific line, range of lines, an entire file, or replying to an existing comment.
Input parameters
Text content of the review comment.
**\[LINE-BASED MODE\]** Line number in the diff for the comment. Required when using line-based mode (must be used with `side`). For multi-line comments, this is the last line of the range. Do not use with position or in_reply_to parameters.
Relative path of the file for the comment.
Repository name without the `.git` extension (not case sensitive).
**\[LINE-BASED MODE\]** Side of the diff (`LEFT` or `RIGHT`) for the comment. Required when using line-based mode with the `line` parameter. For multi-line comments, refers to the last line of the range. Do not use with position or in_reply_to parameters. **IMPORTANT:** Use `LEFT` only for deletions that appear in red in the diff. Use `RIGHT` for additions (green) or unchanged context lines (white). Attempting to comment on LEFT side lines that are not visible deletions in the diff will result in a 'could not be resolved' error.
Account owner of the repository (not case sensitive).
**\[DEPRECATED - Use line-based mode instead\]** Position in the diff hunk for the comment. When using position mode, do not provide line, side, start_line, start_side, or in_reply_to parameters.
SHA of the commit for the comment. Using an outdated `commit_id` can misplace the comment if lines change.
**\[LINE-BASED MODE - MULTI-LINE\]** First line in the diff for a multi-line comment. Required when creating a multi-line comment (must be used with `start_side`, `line`, and `side`). Do not use with position or in_reply_to parameters.
**\[LINE-BASED MODE - MULTI-LINE\]** Starting side of the diff (`LEFT` or `RIGHT`) for a multi-line comment. Required when creating a multi-line comment (must be used with `start_line`, `line`, and `side`). Do not use with position or in_reply_to parameters. **IMPORTANT:** Use `LEFT` only for deletions that appear in red in the diff. Use `RIGHT` for additions (green) or unchanged context lines (white). Attempting to use LEFT for lines that are not visible deletions will result in a 'could not be resolved' error.
**\[REPLY MODE\]** ID of an existing review comment to reply to. When using reply mode, do not provide position, line, side, start_line, or start_side parameters as they will be ignored.
Identifier of the pull request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_REVIEW_FOR_A_PULL_REQUESTCreates a pull request review, allowing approval, change requests, or comments; `body` is required if `event` is `REQUEST_CHANGES` or `COMMENT`, and omitting `event` makes the review `PENDING`.
Input parameters
Review's main body text; required if `event` is `REQUEST_CHANGES` or `COMMENT`.
Repository name, without the `.git` extension (case-insensitive).
Review action type (`APPROVE`, `REQUEST_CHANGES`, `COMMENT`); if omitted, review is `PENDING` and requires later submission.
Username of the account owning the repository (case-insensitive).
Inline draft review comments. Each object requires `path` (relative file path) and `body` (comment text). Optionally, specify `line` (or `start_line` for multi-line), and `side` (or `start_side`) for diff location. `position` is deprecated; use `line`. Example: `\[{'path': 'file.py', 'line': 10, 'body': 'Refactor this.'}\]`
SHA of the commit to review; defaults to the latest pull request commit. Outdated SHAs may lead to stale comments.
Identifying number of the pull request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_SCOPED_ACCESS_TOKENExchanges a user-to-server token for a new, fine-grained scoped access token for a GitHub App, requiring `client_id`, `access_token`, either `target` or `target_id`, and at least one permission; for repository-specific scoping, provide either `repositories` (names) or `repository_ids` (IDs), but not both.
Input parameters
Username or organization name for scoping the new token. Required if `target_id` is not provided.
Client ID of the GitHub App.
ID of the user or organization for scoping the new token. Required if `target` is not provided.
User-to-server access token to be exchanged for a new scoped token.
Repository names to scope the new token to. Cannot be used if `repository_ids` is specified.
Repository IDs to scope the new token to. Cannot be used if `repositories` is specified.
Permission for GitHub Pages settings, statuses, configurations, builds, and creating new builds. Applies to target repositories.
Permission for checks on code (e.g., CI statuses). Applies to target repositories.
Permission for issues, comments, assignees, labels, and milestones. Applies to target repositories.
Permission for GitHub Actions workflows, workflow runs, and artifacts. Applies to target repositories.
Permission for organization members and teams. Applies to target organization.
Permission to manage profile settings for the user account. Applies to target user.
Permission for repository secrets (e.g., Actions secrets). Applies to target repositories.
Permission for repository contents, commits, branches, downloads, releases, and merges. Applies to target repositories.
Read-only permission for repository metadata, search, and collaborator listing. Applies to target repositories.
Permission for packages in GitHub Packages. Applies to target repositories or organization.
Permission to list and manage repositories a user is starring. Applies to target user.
Permission for commit statuses. Applies to target repositories.
Permission to manage followers for the user account. Applies to target user.
Permission to view and manage GPG keys for the user account. Applies to target user.
Permission for updating GitHub Actions workflow files. Requires `contents: write`. Applies to target repositories.
Permission for Codespaces. Applies to target user/organization if repositories are not specified, otherwise to target repositories.
Permission for deployments and deployment statuses. Applies to target repositories.
Permission for repository environments. Applies to target repositories.
Permission to access specific files in targeted repositories. The file paths must be configured in the GitHub App settings.
Permission for repository administration (settings, teams, collaborators). Applies to target repositories.
Permission to manage Git SSH keys for the user account. Applies to target user.
Permission for pull requests, comments, assignees, labels, milestones, and merges. Applies to target repositories.
Permission to manage email addresses for the user account. Applies to target user.
Permission for security events (e.g., code scanning alerts). Applies to target repositories.
Permission for repository webhooks. Applies to target repositories.
Permission for team discussions and related comments. Applies to target organization.
Read-only permission for viewing an organization's billing plan. Applies to target organization.
Permission for Dependabot secrets for targeted repositories.
Permission to view and manage interaction limits on a repository. Applies to target repositories or organization.
Permission for organization webhooks. Applies to target organization.
Read-only permission to view organization audit log events. Applies to target organization.
Permission for repository projects, columns, and cards. Applies to target repositories.
Permission for organization-level secrets (e.g., Actions secrets). Applies to target organization.
Permission for Dependabot alerts. Applies to target repositories.
Permission for organization-level GitHub Packages. Applies to target organization.
Permission for organization projects and projects beta (if available). Applies to target organization.
Permission for secret scanning alerts. Applies to target repositories.
Permission for custom repository roles within an organization. Applies to target organization.
Permission for administrative settings of an organization. Applies to target organization.
Permission for viewing and managing users blocked by the organization. Applies to target organization.
Permission to view and edit repository custom properties, if allowed by property definition. Applies to target repositories.
Permission for custom organization roles. Applies to target organization.
Permission for custom properties for an organization. Applies to target organization.
Permission to view and manage organization announcement banners. Applies to target organization.
Permission for GitHub Actions self-hosted runners for an organization. Applies to target organization.
Permission for fine-grained personal access tokens requested by organization members. Applies to target organization.
Permission for GitHub Copilot seat assignments for organization members (beta). Applies to target organization.
Permission for requests for fine-grained personal access tokens within an organization. Applies to target organization.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_SNAPSHOT_OF_DEPENDENCIES_FOR_A_REPOSITORYCreates a snapshot of a repository's dependencies to populate the GitHub dependency graph and enable security alerts; `sha` must be a 40-character commit ID, `ref` a fully qualified Git reference (e.g., `refs/heads/main`), and `scanned` an ISO 8601 timestamp.
Input parameters
Git reference (fully qualified, e.g., `refs/heads/main`) of the repository branch/tag that triggered this snapshot.
Commit SHA (maximum 40 characters) associated with this dependency snapshot.
Repository name, without `.git` extension (name is not case-sensitive).
Account owner of the repository (name is not case-sensitive).
Optional external ID of the job that generated this snapshot.
UTC timestamp (ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ) when the snapshot was taken.
Version of the dependency snapshot submission, typically of the manifest or lock file format.
Optional user-defined metadata as a JSON string for domain-specific information. Limited to 8 keys with scalar values (e.g., string, number, boolean). Example: '{"key1": "value1", "key2": 123}'
Optional collection of package manifests as a JSON string (e.g., package-lock.json, pom.xml). Keys are manifest file names; values detail dependencies. Example: '{"package-lock.json": {"name": "...", "resolved": {...}}}'
Optional URL of the detector tool used.
Optional name of the tool used to detect dependencies.
Optional URL for the job that generated this snapshot.
Optional string to group snapshots. For a given `job.correlator` and `detector.name`, only the 'latest' snapshot is current. Useful to distinguish detection runs (e.g., concatenating GITHUB_WORKFLOW and GITHUB_JOB).
Optional version of the detector tool used.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_TAG_OBJECTCreates an annotated Git tag object in a repository, pointing to an existing Git object (commit, tree, or blob) defined by its SHA and ensuring the `type` field correctly specifies the object's type.
Input parameters
The name of the tag, typically a version identifier (e.g., "v0.0.1").
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The type of the Git object being tagged.
The account owner of the repository. This name is not case-sensitive.
The SHA of the Git object (commit, tree, or blob) that this tag is pointing to.
The message associated with the tag.
The timestamp for when this object was tagged. This should be in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.
The name of the person creating the tag.
The email address of the person creating the tag.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_TAG_PROTECTION_STATE_FOR_A_REPOSITORYDEPRECATED: This API was sunset on August 30, 2024. Use GITHUB_CREATE_A_REPOSITORY_RULESET instead to create tag protection rules via repository rulesets.
Input parameters
The name of the repository without the `.git` extension. Not case sensitive.
The account owner of the repository (username or organization name). Not case sensitive.
Glob pattern to protect tags. Examples: `v1.*` (protects tags starting with `v1.`), `*` (protects all tags).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_TEAMCreates a new team in an organization, optionally with maintainers, repositories, specific privacy, notification settings, or a parent team; if `parent_team_id` is given, `privacy` must be 'closed'.
Input parameters
Organization name where the team will be created (not case-sensitive).
Name of the new team.
Team privacy: 'secret' (visible to owners and members) or 'closed' (visible to all org members). Defaults to 'secret' for non-nested teams; must be 'closed' if `parent_team_id` is set.
**Deprecated**. Default repository permission ('pull' for read access, 'push' for write access) for the team.
Repository full names (e.g., "org-name/repo-name") for team access; repositories must exist and be accessible to the organization.
Team's purpose or focus.
GitHub user handles of organization members to be team maintainers; users must be organization members.
ID of an existing team to be the parent, creating a nested team. If provided, new team `privacy` must be 'closed'.
Notification settings for @mentions: 'notifications_enabled' (members notified) or 'notifications_disabled' (no one notified). Default: 'notifications_enabled'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_TEMPORARY_PRIVATE_FORKCreates a temporary private fork of the specified repository to address a security vulnerability, linking the fork to a GHSA ID that must be specifically associated with this repository; the fork may take up to 5 minutes to become accessible.
Input parameters
Name of the repository, without the `.git` extension; not case-sensitive.
Account owner (username or organization) of the repository; not case-sensitive.
Identifier for the GitHub Security Advisory (e.g., GHSA-rfv9-x7w6-39px) that the fork will address.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_TREECreates a new Git tree object in a repository, defining file/directory structure by specifying tree entries, optionally building on a `base_tree` SHA; all provided SHAs must be valid.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
Array of objects defining the tree structure. Each object (node) requires `path` (string), `mode` (string; e.g., '100644' file, '100755' executable, '040000' subdirectory/tree, '160000' submodule, '120000' symlink), and `type` (string: 'blob', 'tree', or 'commit'). For new/updated blobs, provide `content` (UTF-8 string). For existing objects or `tree`/`commit` types, provide `sha` (string). To delete, specify `path`, `mode`, `type`, and set `sha` to `null`.
The account owner of the repository. The name is not case sensitive.
SHA1 of an existing Git tree object to use as a base. If provided, its entries are combined with `tree` entries, where `tree` entries overwrite those from `base_tree` with the same path. Typically the SHA1 of the latest commit's tree for new branch changes. If omitted, the new tree is built from `tree` entries; files from the parent commit's tree not in `tree` are treated as deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_USER_PROJECTCreates a new GitHub Projects V2 project board for the authenticated user to organize and track issues, pull requests, and notes. Note: This action uses GitHub's Projects V2 GraphQL API. The legacy Projects V1 REST API has been sunset by GitHub.
Input parameters
Optional description for the new project. Note: GitHub Projects V2 does not support a body/description field during creation, so this field is accepted but not used.
Name/title for the new project. This will be displayed as the project board title.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_A_WORKFLOW_DISPATCH_EVENTManually triggers a GitHub Actions workflow identified by `workflow_id` at a given `ref`, if the workflow is configured to accept `workflow_dispatch` events.
Input parameters
Git reference (branch or tag) for the workflow.
Repository name, excluding the `.git` extension (case-insensitive).
Owner of the repository (username or organization, case-insensitive).
JSON string containing key-value inputs for the workflow, matching `on.workflow_dispatch.inputs` definitions (max 10); uses workflow defaults if omitted. Example: '{"actor": "mona", "environment": "production"}'
Identifier of the workflow: numeric ID or just the filename (e.g., 'main.yml'). If a full path like '.github/workflows/main.yml' is provided, the prefix is automatically stripped.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_COMMIT_SIGNATURE_PROTECTIONEnables commit signature protection for a specified branch, requiring all new commits to be signed.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use \[the GraphQL API\](https://docs.github.com/graphql).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_DEPLOYMENT_PROTECTION_RULEEnables a custom deployment protection rule for an existing environment in a repository by linking a configured GitHub App (via `integration_id`) to control deployments.
Input parameters
The name of the repository where the environment exists. Do not include the `.git` extension. This name is not case sensitive.
The GitHub username or organization name that owns the repository. This name is not case sensitive.
The unique identifier of the GitHub App that provides the custom deployment protection rule. This app must be installed and configured for the repository. Required - use GITHUB_LIST_ENVIRONMENT_CUSTOM_DEPLOYMENT_RULES to find available integration IDs for your environment.
The name of the environment to which the protection rule will be applied. This name must be URL-encoded if it contains special characters (e.g., slashes `/` should be replaced with `%2F`).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_DRAFT_ITEM_FOR_USER_PROJECTCreates a draft issue item in a user-owned GitHub ProjectsV2. Use when you need to add a new draft item to track ideas or tasks in a user's project.
Input parameters
The body content of the draft issue item to create in the project.
The title of the draft issue item to create in the project.
The handle for the GitHub user account.
The project's number.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_INFERENCE_CHAT_COMPLETIONSTool to create chat completions using GitHub Models inference API. Use when you need to generate AI-powered text responses using models like GPT-4, Claude, or Llama through GitHub's inference endpoint.
Input parameters
If specified, the system will make a best effort to sample deterministically, such that repeated requests with the same seed and parameters should return the same result.
Up to 4 sequences where the API will stop generating further tokens. The returned text will not contain the stop sequence.
ID of the specific model to use for the request. Format: {publisher}/{model_name}, e.g., openai/gpt-4o, anthropic/claude-3.5-sonnet.
A list of tools (functions) the model may call. The model will choose when and how to call these functions based on the conversation context.
An alternative to temperature called nucleus sampling. Range: \[0.0, 1.0\]. The model considers tokens with top_p probability mass.
If true, partial message deltas will be sent as data-only server-sent events as they become available.
The collection of context messages associated with this chat completion request. Each message must have a role (assistant, developer, system, or user) and content.
Maximum number of tokens to generate in the completion. The total length of input tokens and generated tokens is limited by the model's context length.
List of supported modalities for this request. Supported values: text, audio.
Controls the apparent creativity of generated completions. Range: \[0.0, 1.0\]. Lower values make output more deterministic, higher values more random.
Controls which (if any) tool is called by the model.
Options for streaming responses.
Specifies the format of the model's output.
Influences probability of generated tokens appearing based on whether they appear in the text so far. Range: \[-2.0, 2.0\]. Positive values increase likelihood of new topics.
Influences probability of generated tokens appearing based on their cumulative frequency in the text so far. Range: \[-2.0, 2.0\]. Positive values decrease likelihood of repetition.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_INFERENCE_EMBEDDINGSTool to create inference embeddings using GitHub's AI models. Use when you need to convert text into vector representations for similarity search, clustering, or other ML tasks.
Input parameters
A unique identifier representing your end-user, which can help monitor and detect abuse.
Input text to embed, encoded as a string or array of strings. Each string will be converted to an embedding vector.
ID of the specific model to use for the request. Format: {publisher}/{model_name}
The number of dimensions the resulting output embeddings should have. Must be supported by the model (max 2048).
Format for embeddings: 'float' (default) or 'base64'. Float returns arrays of numbers, base64 returns encoded strings.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_ISSUE_TYPECreate a new issue type for a GitHub organization. Requires the authenticated user to be an organization administrator. OAuth tokens need admin:org scope.
Input parameters
The organization name (case-insensitive).
The name of the issue type.
The color of the issue type.
Whether the issue type is enabled at the organization level.
A short description of the issue type.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_JIT_RUNNER_CONFIGGenerates a temporary Just-In-Time (JIT) configuration for a new self-hosted GitHub Actions runner for a repository; any specified non-default `runner_group_id` must be an existing runner group accessible by the repository.
Input parameters
The desired name for the new self-hosted runner.
The name of the repository, without the '.git' extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
A list of custom labels to assign to the runner. These labels help in targeting specific runners for jobs. Minimum items: 1. Maximum items: 100.
The working directory for the runner, relative to its installation path. This is where job execution will take place.
The unique identifier of the runner group to which the new runner will be assigned. Use 0 for the default group or the ID of a specific runner group.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_OR_UPDATE_AN_ENVIRONMENTCreates a new environment or updates an existing one in a GitHub repository, allowing configuration of deployment protection rules such as wait timers and reviewers; ensure `environment_name` is URL-encoded if it contains special characters.
Input parameters
Name of the repository, without the `.git` extension (not case-sensitive).
The username or organization name of the repository owner (not case-sensitive).
JSON string containing up to 6 users or teams allowed to review deployments. Reviewers need at least read access; one approval suffices. Each reviewer object requires `id` and `type` ('User' or 'Team'). Example: '\[{"id": 4532, "type": "User"}\]'
Time in minutes to delay a job after it's triggered (0-43,200, i.e., up to 30 days).
Name of the environment. URL-encode if it contains special characters (e.g., '/' becomes '%2F').
If true, prevents the user who triggered deployment from approving their own job.
If true, only branches with existing protection rules can deploy; `deployment_branch_policy_custom_branch_policies` must then be false.
If true, deployment is restricted to branches matching custom name patterns; `deployment_branch_policy_protected_branches` must then be false.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_OR_UPDATE_AN_ENVIRONMENT_SECRETCreates or updates an environment secret with an `encrypted_value` that was encrypted using the public key identified by `key_id` for the specified environment.
Input parameters
The name of the repository. Not case-sensitive.
The account owner of the repository. Not case-sensitive.
ID of the public key used for encryption, obtained from the 'Get an environment public key' GitHub API endpoint.
Name of the secret. Case-sensitive.
Value of the secret, encrypted with LibSodium using the public key obtained from the 'Get an environment public key' GitHub API endpoint for the target environment.
Name of the environment. Case-sensitive; URL-encode special characters (e.g., `/` becomes `%2F`).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_OR_UPDATE_AN_ORGANIZATION_SECRETCreates or updates an organization secret for GitHub Actions, requiring its value to be pre-encrypted via LibSodium using the organization's public key.
Input parameters
The organization name. The name is not case sensitive.
ID of the public key (from 'Get an organization public key' endpoint) used for encryption. This is required for both creating and updating secrets.
Controls which repositories can access the secret. If 'selected', `selected_repository_ids` must be provided.
The name of the secret.
Value for the secret, pre-encrypted using LibSodium with the organization's public key (obtained from 'Get an organization public key' endpoint). This is required for both creating and updating secrets.
List of repository IDs that can access this secret. Required and only applicable when `visibility` is 'selected'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_OR_UPDATE_A_REPOSITORY_SECRETCreates or updates a GitHub Actions secret within a specific repository; use `encrypted_value` and `key_id` to set or change its value.
Input parameters
The repository name, without the `.git` extension (case-insensitive).
The repository owner's username or organization name (case-insensitive).
ID of the public key used to encrypt `encrypted_value` (obtained with the public key). Required if `encrypted_value` is provided.
The name for the secret being created or updated. Must not start with 'GITHUB_' prefix (reserved for GitHub internal secrets).
Value for the secret, pre-encrypted with the repository's public key using LibSodium (public key is obtained via 'Get a repository public key' endpoint).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_OR_UPDATE_A_SECRET_FOR_THE_AUTHENTICATED_USERCreates or updates a Codespaces secret for the authenticated user; `encrypted_value` must be encrypted with the public key (ID: `key_id`) from GitHub's 'Get public key for the authenticated user' endpoint.
Input parameters
ID of the public key (from GitHub's 'Get public key for the authenticated user' endpoint) used to encrypt `encrypted_value`. If not provided, it will be fetched automatically.
The name of the secret. This name must be unique among the user's Codespaces secrets.
The plaintext value for your secret. This will be automatically encrypted using the user's Codespaces public key before being sent to GitHub. If you already have an encrypted value, use the encrypted_value parameter instead.
Secret's value, encrypted using \[LibSodium\](https://libsodium.gitbook.io/doc/bindings_for_other_languages) with the public key (see `key_id`) obtained from GitHub's 'Get public key for the authenticated user' endpoint.
Repository IDs that can access this secret. If omitted or empty, accessible to all user's Codespaces-enabled repositories.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_OR_UPDATE_CUSTOM_PROPERTIES_FOR_AN_ORGCreates new custom property schemas or updates existing ones in bulk for a specified organization; each property definition must include `property_name` and `value_type`.
Input parameters
The case-insensitive organization name.
Definitions for custom properties as a JSON string. Each must include a unique `property_name` (max 75 chars, no spaces) and `value_type`. Optional: `description`, `required`, `default_value`, `allowed_values` (for 'single_select' type).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_OR_UPDATE_CUSTOM_PROPERTY_ORGCreates a new custom property (name must be unique for creation) or updates an existing one for an organization to define metadata for its repositories.
Input parameters
The organization's unique identifier (case-insensitive).
If true, property must be set for all repositories and `default_value` is mandatory.
Data type of the custom property. Can be 'string' (free text), 'single_select' (single choice from list), 'multi_select' (multiple choices from list), 'true_false' (boolean), or 'url' (URL format).
Explanation of the custom property's purpose.
Default value if property isn't set. For `single_select` type, must be one of `allowed_values`. Can be a string for single values or an array for multi_select.
Ordered list of allowed values (up to 200). Required and non-empty if `value_type` is `single_select` or `multi_select`.
Who can edit the values of the property. Can be 'org_actors' (organization actors only) or 'org_and_repo_actors' (organization and repository actors).
Name of the custom property (case-sensitive).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_OR_UPDATE_FILE_CONTENTSCreates a new file or updates an existing file in a GitHub repository; SHA can be provided to validate file updates, automatically fetched if not provided.
Input parameters
The blob SHA of the file being replaced. Automatically fetched if not provided. If a 409 conflict occurs (SHA mismatch due to concurrent modifications), the action will automatically retry up to 5 times with exponential backoff and jitter.
The full path to the file in the repository, including the filename and extension. Do not include leading slashes.
The name of the repository (not case sensitive, without the `.git` extension).
The account owner of the repository (not case sensitive).
The branch name. Defaults to the repository's default branch if omitted. If a non-existent branch is specified, the action will automatically fall back to the repository's default branch. For empty repositories, omitting this parameter is recommended to let GitHub initialize with the repository's configured default branch.
The new file content. Can be provided as plain text (will be automatically encoded to Base64) or as Base64-encoded text. GitHub API requires Base64 encoding, which this action handles automatically.
The commit message for this file creation or update.
Author's timestamp (ISO 8601 format). Defaults to committer's date if author details are provided but date is not.
Author's name. If specified, `author_email` is also required. Defaults to committer details; if all committer/author details omitted, GitHub uses authenticated user.
Author's email. If specified, `author_name` is also required. Defaults to committer details; if all committer/author details omitted, GitHub uses authenticated user.
Committer's commit timestamp (ISO 8601 format). Defaults to current time if committer details are provided but date is not.
Committer's name. If specified, `committer_email` is also required. GitHub uses authenticated user if all committer/author details omitted.
Committer's email. If specified, `committer_name` is also required. GitHub uses authenticated user if all committer/author details omitted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_OR_UPDATE_GITHUB_PAGES_SITETool to enable or update GitHub Pages configuration for a repository. Use when setting up GitHub Pages for static site deployment or modifying Pages settings like custom domains and HTTPS enforcement.
Input parameters
The name of the repository without the .git extension. Not case-sensitive.
Custom domain for the Pages site (e.g., 'example.com'). Set to null to remove custom domain. Only used during updates.
The account owner of the repository (username or organization). Not case-sensitive.
Build process type: 'legacy' for traditional GitHub Pages build from a branch, 'workflow' for GitHub Actions. When 'workflow', source_branch and source_path are ignored.
The directory path within source_branch containing the site files: '/' for root or '/docs' for docs folder. Ignored if build_type is 'workflow'.
The repository branch to use for GitHub Pages source (e.g., 'main', 'gh-pages'). Required if build_type is 'legacy'. Ignored if build_type is 'workflow'.
Whether to enforce HTTPS for the Pages site. Only used during updates.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_OR_UPDATE_REPO_SECRET_WITH_ENCRYPTED_VALUECreates or updates a Dependabot secret in a repository using an `encrypted_value` (pre-encrypted with LibSodium using the repository's Dependabot public key) and its corresponding `key_id`. This action allows you to securely manage secrets for a given repository, ensuring that sensitive data remains protected during the update process. By providing the encrypted value alongside the key ID, you can seamlessly maintain the necessary credentials for your repository's operations.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository (e.g., a GitHub username or organization name). This name is not case-sensitive.
The ID of the public key that was used to encrypt the secret value. This ID is retrieved from GitHub along with the public key via the 'Get a repository public key' endpoint for Dependabot secrets. If not provided or if an outdated key_id is used, the action will automatically fetch the latest public key from GitHub and retry with the current key_id.
The name of the Dependabot secret to create or update.
Value for your secret. This value must be encrypted with LibSodium, using the public key retrieved from the GitHub API's 'Get a repository public key' endpoint for Dependabot secrets. The resulting encrypted string is typically Base64 encoded.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_REACTION_FOR_A_COMMIT_COMMENTCreates an emoji reaction for a commit comment; if the user has already reacted with the same content, details of the existing reaction are returned.
Input parameters
Name of the repository, without the `.git` extension. Not case-sensitive.
Username of the repository owner. Not case-sensitive.
The \[reaction type\](https://docs.github.com/rest/reactions/reactions#about-reactions) to add to the commit comment.
Unique ID of the commit comment.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_REACTION_FOR_AN_ISSUECreates a reaction for a specified issue within a GitHub repository.
Input parameters
The name of the repository without the `.git` extension. The name is not case-sensitive.
The account owner of the repository. The name is not case-sensitive.
The reaction type to add to the issue. See the \[GitHub documentation on reactions\](https://docs.github.com/rest/reactions/reactions#about-reactions) for full details.
The number that identifies the issue.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_REACTION_FOR_AN_ISSUE_COMMENTCreates a reaction for a specific comment on an issue within a GitHub repository.
Input parameters
Name of the repository, without the `.git` extension (not case-sensitive).
Username of the account that owns the repository (not case-sensitive).
Reaction content to add to the issue comment. Must be one of the values from `ContentEnm`.
Unique identifier of the issue comment.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_REACTION_FOR_A_PULL_REQUEST_REVIEW_COMMENTAdds a specified reaction to a pull request review comment within a GitHub repository.
Input parameters
The name of the repository, without the `.git` extension. This field is case-insensitive.
The username or organization name that owns the repository. This field is case-insensitive.
The reaction to add. See the \[GitHub API documentation on reactions\](https://docs.github.com/rest/reactions/reactions#about-reactions) for more context on reactions.
The unique identifier of the pull request review comment to which the reaction will be added.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_REACTION_FOR_A_RELEASECreates an emoji reaction for a specific, existing release in a GitHub repository.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username of the account that owns the repository. This field is not case-sensitive.
The type of reaction to add to the release.
The unique identifier (ID) of the release to add a reaction to.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_REACTION_FOR_A_TEAM_DISCUSSIONCreates a reaction for a team discussion within a GitHub organization.
Input parameters
The name of the GitHub organization. This field is not case-sensitive.
The reaction content to add to the team discussion.
The slug (URL-friendly version) of the team name.
The unique number identifying the team discussion.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_REACTION_FOR_A_TEAM_DISCUSSION_COMMENTAdds a reaction to a team discussion comment, requiring the specified organization, team, discussion, and comment to exist.
Input parameters
The organization name on GitHub. This name is not case sensitive.
The type of reaction to add to the team discussion comment. For more information on reaction types, see the \[GitHub API documentation on reactions\](https://docs.github.com/rest/reactions/reactions#about-reactions).
The slug (URL-friendly version) of the team name.
The unique number identifying the comment within the discussion.
The unique number identifying the team discussion.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_SPONSORSHIPTool to start a new GitHub sponsorship or reactivate a past sponsorship using GraphQL. Use when you need to sponsor a maintainer through GitHub Sponsors with a specified amount and privacy level.
Input parameters
The amount to sponsor in cents (USD). For example, 500 cents equals $5.00.
The global node ID of the user or organization acting as sponsor (e.g., 'U_kgDOABCDEF'). Required if sponsor_login is not provided.
Whether the sponsorship is recurring (true) or one-time (false). Note: one-time payments currently have a known bug in the GitHub API and may not work as expected.
Privacy level for GitHub sponsorships
The username of the sponsoring user or organization. Required if sponsor_id is not provided.
The global node ID of the user or organization to sponsor (e.g., 'U_kgDOMNOPQR'). Required if sponsorable_login is not provided.
The username of the user or organization to sponsor. Required if sponsorable_id is not provided.
A unique identifier for the client performing the mutation. Used to ensure idempotency of mutations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_SPONSORS_TIERTool to create a new payment tier for your GitHub Sponsors profile using GraphQL. Use when you need to add a new sponsorship tier with a specific monthly price and description. The amount is specified in dollars and will be converted to cents automatically.
Input parameters
The monthly sponsorship amount in dollars (USD). This value will be converted to cents internally (e.g., 5 for $5/month becomes 500 cents, 500 for $500/month becomes 50000 cents). Minimum is $1.
A detailed description of what this sponsorship tier provides. Explain the benefits and perks sponsors will receive at this level. This is a required field.
The global node ID of the user or organization who will receive sponsorships for this tier (e.g., 'U_kgDOABCDEF' for users, 'O_kgDOGHIJKL' for organizations). Use the get_viewer_graphql_id action to fetch your own ID.
A unique identifier for the client performing the mutation. Used to ensure idempotency of mutations and track request origin.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_UPDATE_ORG_SECRET_WITH_LIB_SODIUMCreates or updates a Dependabot organization secret, requiring the secret value to be pre-encrypted with LibSodium using the organization's public key obtained from the 'Get an organization public key' endpoint.
Input parameters
The organization name (case-insensitive).
ID of the Dependabot public key used for encryption (retrieved from 'Get an organization public key for Dependabot' endpoint: GET /orgs/{org}/dependabot/secrets/public-key). Required if `encrypted_value` is provided.
Secret visibility: `all` (all repositories), `private` (private repositories), or `selected` (specific repositories designated by `selected_repository_ids`).
The secret name (case-insensitive and unique within the organization).
Value of the secret, encrypted using \[LibSodium\](https://libsodium.gitbook.io/doc/bindings_for_other_languages) and the organization's Dependabot public key (obtained from the 'Get an organization public key for Dependabot' endpoint: GET /orgs/{org}/dependabot/secrets/public-key). Required to create or update the secret's value.
List of repository IDs that can access the secret; required and used only when `visibility` is `selected`.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_USER_LISTTool to create a new user list on GitHub. Use when you need to organize and group GitHub users for easier tracking and management.
Input parameters
The name of the user list to create.
A description for the user list to provide context about its purpose.
A unique identifier for the client performing the mutation. This can be used to track the request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_CREATE_VIEW_FOR_USER_PROJECTTool to create a new view in a user-owned GitHub project (Projects V2). Use when you need to add a customized view with specific layout, filters, and visible fields to organize project items. Note: This action works with GitHub Projects V2. The view can be configured with different layouts (table, board, roadmap) and optional filters. The visible_fields parameter is not applicable to roadmap layouts.
Input parameters
The name of the view to be created.
The filter query for the view. See GitHub's filtering projects documentation for syntax details.
The layout type for the view. Options are 'table', 'board', or 'roadmap'.
The unique identifier of the user who owns the project. This can be the username or user login.
The project's number as displayed in the project URL.
List of field IDs that should be visible in the view. Not applicable to roadmap layout. If not provided, default visible fields will be used.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DECLINE_A_REPOSITORY_INVITATIONDeclines a specific, pending repository invitation for the authenticated user, identified by its `invitation_id`.
Input parameters
Identifier of the pending repository invitation to decline; obtained by listing the user's pending invitations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_ACCESS_RESTRICTIONSRemoves all user, team, and app-based access restrictions from a protected branch.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The account owner of the repository (username or organization name). This field is not case-sensitive.
The name of the branch from which to remove access restrictions. Wildcard characters are not supported; for wildcard usage, refer to the GitHub GraphQL API.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_ADMIN_BRANCH_PROTECTIONRemoves admin enforcement from a protected branch (branch name cannot contain wildcard characters) in a repository.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The name of the branch. Cannot contain wildcard characters.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_A_FILEDeletes a file by path from a GitHub repository. The file's blob SHA is automatically fetched if not provided.
Input parameters
Blob SHA of the file being deleted. Optional - if not provided, it will be automatically fetched from the file at the given path.
Path to the file to be deleted within the repository.
The name of the repository, without the `.git` extension (not case-sensitive).
The account owner of the repository (not case-sensitive).
Branch from which the file will be deleted; defaults to the repository's default branch.
Commit message for the deletion.
Name of the commit author for the deletion; defaults to the committer's name.
Email address of the commit author for the deletion; defaults to the committer's email.
Name of the user committing the deletion; defaults to the authenticated user's name.
Email address of the user committing the deletion; defaults to the authenticated user's email.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_A_PACKAGE_VERSION_FOR_THE_AUTHENTICATED_USERDeletes an existing package version associated with the authenticated user.
Input parameters
The unique name of the package.
Type of the package. E.g., `maven` for GitHub Gradle registry, `container` for `ghcr.io` images. The `docker` type covers images from `docker.pkg.github.com` (including migrated ones).
The unique numeric identifier of the specific package version to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_APP_AUTHORIZATIONDeletes an OAuth application grant for a user, which revokes ALL OAuth tokens and their associated authorizations for the application. This endpoint is only accessible to OAuth App owners and requires Basic Authentication using the OAuth App's client_id and client_secret.
Input parameters
The client ID of your OAuth App. This must be YOUR OAuth App that you own, as this endpoint requires the app's client_secret for authentication.
An OAuth access token that was issued by your OAuth App (specified by client_id). Providing this token will revoke ALL tokens for that user's grant, not just this single token.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_APP_TOKENRevokes a single OAuth access token for an OAuth App or GitHub App with OAuth authorization. IMPORTANT: This endpoint requires Basic Authentication using the OAuth App's client_id as username and client_secret as password. It CANNOT be called with personal access tokens, GitHub App installation tokens, or any other token type. You must be the OAuth App owner to use this endpoint.
Input parameters
The client ID of the OAuth App or GitHub App with OAuth authorization.
The OAuth access token to be revoked. Must be a token issued by this OAuth App.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_A_REFERENCEDeletes a Git reference from a repository; 'ref' must be fully qualified (e.g., 'refs/heads/branch' or 'refs/tags/tag').
Input parameters
The Git reference to delete. Accepts multiple formats: 'refs/heads/branch-name', 'heads/branch-name', or just 'branch-name' for branches; 'refs/tags/tag-name' or 'tags/tag-name' for tags. Simple branch names are automatically prefixed with 'heads/'.
The name of the repository, without the `.git` extension. This name is not case sensitive.
The account owner of the repository. This name is not case sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_A_RELEASEPermanently deletes a specific release, its assets, and potentially its associated Git tag from a repository.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The account owner of the repository, typically a username or organization name. This field is not case-sensitive.
The unique numerical identifier (ID) of the release to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_A_RELEASE_ASSETDeletes a specific release asset from a GitHub repository; this action is idempotent.
Input parameters
The name of the repository, without the `.git` extension; not case-sensitive.
The account owner of the repository (username or organization); not case-sensitive.
The unique identifier of the release asset to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_A_RELEASE_REACTIONDeletes a reaction from a GitHub release, provided the repository, release, and reaction exist.
Input parameters
The name of the repository, without the `.git` extension (case-insensitive).
The account owner of the repository (case-insensitive).
Unique identifier of the release.
Unique identifier of the reaction to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_A_REPOSITORYPermanently deletes the specified repository; this is a destructive, irreversible action that requires admin privileges for the repository.
Input parameters
The name of the repository, without the `.git` extension; case-insensitive.
The account owner of the repository (user or organization); case-insensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_A_REPOSITORY_INVITATIONDeletes an active repository invitation, permanently revoking a user's access to collaborate on the specified repository.
Input parameters
The name of the repository, without the `.git` extension. This field is case-insensitive.
The username or organization name that owns the repository. This field is case-insensitive.
The unique numerical identifier of the repository invitation to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_A_REPOSITORY_RULESETPermanently deletes a repository ruleset.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username of the account that owns the repository. This field is not case-sensitive.
The unique identifier (ID) of the ruleset to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_A_REPOSITORY_SECRETDeletes a named GitHub Actions secret from a specified repository; this operation is destructive and idempotent, and requires the repository to exist.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The account owner of the repository. This is typically the username or organization name and is not case-sensitive.
The name of the secret to delete. This refers to a secret used in GitHub Actions.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_A_REPOSITORY_SUBSCRIPTIONDeletes the authenticated user's subscription to a specified repository if it exists, effectively 'unwatching' it.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository (e.g., a GitHub username or organization name). This name is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_A_REPOSITORY_VARIABLEDeletes a named variable (e.g., for GitHub Actions workflows) from a repository; the repository and the variable must already exist.
Input parameters
The name of the repository variable to delete.
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository. This name is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_A_REPOSITORY_WEBHOOKDeletes a specific webhook from a repository.
Input parameters
The name of the repository, without the `.git` extension. This name is not case sensitive.
The account owner of the repository. This name is not case sensitive.
The unique identifier of the webhook. This ID can be found in the `X-GitHub-Hook-ID` header of a webhook delivery.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_A_REVIEW_COMMENT_FOR_A_PULL_REQUESTDeletes a specific pull request review comment.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
The unique numerical identifier of the pull request review comment to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_ARTIFACTDeletes a GitHub artifact by its ID within a repository, typically resulting in an empty response (HTTP 204 No Content) on success.
Input parameters
Name of the repository, without the `.git` extension; not case-sensitive.
Account owner of the repository (user or organization); not case-sensitive.
Unique ID of the artifact to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_A_SECRET_FOR_THE_AUTHENTICATED_USERDeletes an existing Codespaces secret for the authenticated user by `secret_name`. This is a destructive and irreversible operation. Returns 404 if the secret does not exist.
Input parameters
Name of the Codespaces secret to delete. Case-sensitive; allows alphanumeric characters or underscores; must not start with `GITHUB_` or contain spaces.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_A_SELF_HOSTED_RUNNER_FROM_AN_ORGANIZATIONForces the removal of a self-hosted runner from a GitHub organization. This endpoint can be used to completely remove the runner when the machine you were using no longer exists. The runner will be immediately disconnected from GitHub Actions. Requires admin:org scope and organization admin access. Returns 204 No Content on successful deletion.
Input parameters
Organization name (not case-sensitive).
Unique ID of the self-hosted runner to remove (obtainable by listing organization runners).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_A_SELF_HOSTED_RUNNER_FROM_A_REPOSITORYRemoves a specific self-hosted runner (by `runner_id`) from a repository, if registered there; this is idempotent.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
Unique identifier of the self-hosted runner.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_A_TAG_PROTECTION_STATE_FOR_A_REPOSITORYDEPRECATED: This API was sunset on August 30, 2024. Use GITHUB_DELETE_A_REPOSITORY_RULESET instead to manage tag protection rules via repository rulesets.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The unique identifier of the tag protection to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_A_TEAMDeletes a team (and any child teams) from an organization.
Input parameters
The organization's unique identifier (case-insensitive).
The team's URL-friendly slug.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_A_THREAD_SUBSCRIPTIONCall this to mute a specific notification thread by deleting the user's subscription; notifications may still occur if the user is @mentioned, comments, or due to repository watch settings.
Input parameters
The unique identifier of the notification thread. This ID is obtained from other API calls, such as when listing notifications (e.g., via the `GET /notifications` endpoint). Ensure this ID refers to an active thread to which the user is currently subscribed.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_AUTOLINK_REFERENCEDeletes a specific autolink reference (which automatically links external resource IDs like JIRA-123 to URLs) from the specified repository.
Input parameters
The name of the repository, without the `.git` extension. This is not case-sensitive.
The username or organization name that owns the repository. This is not case-sensitive.
The unique numerical identifier of the autolink reference to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_A_WORKFLOW_RUNDeletes a specific workflow run from a repository.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The unique identifier of the workflow run.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_BRANCH_PROTECTIONRemoves all protection rules from a specific branch in a GitHub repository; the branch must currently have protection rules enabled.
Input parameters
The name of the repository, without the `.git` extension. Not case sensitive.
The account owner of the repository. Not case sensitive.
The name of the branch. Wildcard characters are not supported for this REST API endpoint; use the GitHub GraphQL API for wildcard support.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_CODE_SCANNING_ANALYSISDeletes a specific code scanning analysis by its ID from a repository; `confirm_delete` must be `true` if it's the last analysis of its type for a given tool and reference to prevent data loss.
Input parameters
Name of the repository without the `.git` extension (not case sensitive).
Account owner of the repository (not case sensitive).
Unique identifier of the code scanning analysis to delete, typically obtained by listing analyses.
Pass the string `true` to confirm deletion when this is the last analysis of its type for a specific tool and reference. Required to avoid a 400 error when deleting the final analysis in a set.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_CODESPACEDeletes a specific codespace owned by the authenticated user; this is a destructive action and the codespace must exist.
Input parameters
The unique name of the codespace to be deleted. This can be the system-generated name (e.g., 'monalisa-octocat-g4v9wxj96hp') or a user-defined display name if it's unique for the user.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_COMMIT_COMMENTDeletes a specific commit comment, identified by its `comment_id`, from the specified repository; the comment must exist.
Input parameters
The name of the repository, excluding the `.git` extension. This value is not case-sensitive.
The username or organization name that owns the repository. This value is not case-sensitive.
The unique numerical identifier of the commit comment to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_COMMIT_COMMENT_REACTIONDeletes a reaction from a commit comment in a GitHub repository.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The unique identifier of the commit comment from which the reaction will be deleted.
The unique identifier of the reaction to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_COMMIT_SIGNATURE_PROTECTIONDisables GPG commit signature protection for a specific branch in a GitHub repository, meaning commits pushed to this branch no longer require GPG signing.
Input parameters
The name of the repository, without the `.git` extension. The name is not case-sensitive.
The account owner of the repository. This is typically the username of the owner (for personal repositories) or the organization name (for organization-owned repositories). The name is not case-sensitive.
The name of the branch for which commit signature protection will be disabled. Wildcard characters are not supported in the branch name. To use wildcards, refer to the GitHub GraphQL API.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_CUSTOM_ORGANIZATION_ROLEDeletes a custom organization role (which should not be actively assigned) by its ID; a 204 No Content response indicates success.
Input parameters
The organization name (not case-sensitive).
Unique ID of the custom role to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_DEPENDEBOT_SECRET_BY_NAMEDeletes a specific Dependabot secret, identified by its name, from a given repository if both the repository and secret exist.
Input parameters
The name of the repository without the `.git` extension. This field is not case-sensitive.
The account owner of the repository (e.g., username or organization name). This field is not case-sensitive.
The name of the Dependabot secret to delete. Secret names are case-sensitive and can only contain alphanumeric characters (\[A-Z\], \[a-z\], \[0-9\]) or underscores (_); spaces are not allowed.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_DEPLOY_KEYDeletes a specific deploy key from a repository; to change a key's properties or access scope, the existing key must be deleted and a new one created.
Input parameters
The name of the repository, without the `.git` extension. This name is not case sensitive.
The account owner of the repository. This name is not case sensitive.
The unique identifier (ID) of the deploy key to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_DEPLOYMENTPermanently deletes a specified *inactive* deployment from a repository.
Input parameters
Repository name, without the `.git` extension (case-insensitive).
Username of the account owning the repository (case-insensitive).
Unique identifier of the deployment to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_DEPLOYMENT_BRANCH_POLICYDeletes a specific deployment branch or tag policy, identified by its ID, from a given environment within a repository.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The unique identifier of the branch policy.
The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with `%2F`.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_DISCUSSIONDeletes a specific team discussion, identified by its number, from an organization's team.
Input parameters
Case-insensitive name of the organization.
URL-friendly version (slug) of the team name.
The unique number identifying the discussion to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_DISCUSSION_COMMENTDeletes a specific comment from an existing team discussion within an organization, provided the specified organization, team, discussion, and comment all exist.
Input parameters
The organization name (not case sensitive).
The slug of the team name (URL-friendly version).
Unique number identifying the comment.
Unique number identifying the discussion.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_EMAIL_ADDRESSSends an empty request body to `DELETE /user/emails` to attempt deletion of user email addresses; the API typically requires specific emails, so outcome may vary.
Input parameters
Array of email addresses to delete from the authenticated user account.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_ENVIRONMENTDeletes an existing deployment environment from an existing repository.
Input parameters
The name of the repository, without the `.git` extension. This is not case sensitive.
The username or organization name that owns the repository. This is not case sensitive.
The name of the environment to delete. The name must be URL encoded; for example, slashes (`/`) should be replaced with `%2F`.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_ENVIRONMENT_SECRETDeletes an existing and accessible secret from a specified environment within a GitHub repository, returning an empty dictionary on success or error details otherwise.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
The name of the secret to be deleted. GitHub stores and processes secret names as uppercase (e.g., `my_secret` becomes `MY_SECRET`).
The name of the environment from which the secret will be deleted. This name must be URL-encoded if it contains special characters (e.g., slashes `/` should be replaced with `%2F`).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_ENVIRONMENT_VARIABLEDeletes a named environment variable from a specified, existing environment within a GitHub repository.
Input parameters
The name of the environment variable to delete.
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The name of the environment. Must be URL-encoded if it contains special characters (e.g., slashes `/` should be `%2F`).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_GISTPermanently deletes an existing GitHub gist, specified by its `gist_id`; this action is destructive and cannot be undone.
Input parameters
The unique identifier of the gist to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_GIST_COMMENTDeletes a specific comment from a GitHub Gist using its `gist_id` and `comment_id`.
Input parameters
The unique identifier of the Gist from which the comment will be deleted.
The unique identifier of the comment to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_GITHUB_ACTIONS_CACHE_BY_IDDeletes a specific GitHub Actions cache from a repository using its unique `cache_id`.
Input parameters
The name of the repository, without the `.git` extension.
The username or organization name that owns the repository.
The unique ID of the GitHub Actions cache to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_GITHUB_PAGES_SITEDeletes the GitHub Pages site for the specified repository; completes without error if no site is currently enabled.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository (e.g., a user or organization). This name is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_ISSUE_COMMENTPermanently deletes a specific comment by its ID from an issue or pull request, if the repository exists and the comment ID is valid.
Input parameters
Name of the repository, without the `.git` extension (case-insensitive).
Username of the account owning the repository (case-insensitive).
Unique identifier of the comment to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_ISSUE_COMMENT_REACTIONDeletes a reaction from an issue comment in a repository; the repository, comment, and reaction must exist.
Input parameters
The name of the repository, without the `.git` extension. This is not case-sensitive.
The username of the account that owns the repository. This is not case-sensitive.
The unique numeric identifier for the issue comment from which the reaction will be deleted.
The unique numeric identifier for the reaction to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_ISSUE_REACTIONPermanently removes a specific reaction from an issue in a GitHub repository.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The unique identifier of the reaction to be deleted.
The unique number identifying the issue from which the reaction will be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_LABELPermanently removes an existing label from a repository.
Input parameters
The name of the label to delete. Label names are case-insensitive. If the label name contains spaces or special characters, ensure it is correctly URL-encoded (e.g., 'help wanted' becomes 'help%20wanted').
REQUIRED. The name of the repository, without the `.git` extension. Must be provided together with 'owner' to identify the repository (e.g., for 'github.com/octocat/Hello-World', repo is 'Hello-World'). This field is not case-sensitive.
REQUIRED. The username or organization name that owns the repository. GitHub repositories are identified by owner/repo (e.g., 'octocat/Hello-World'), so both 'owner' and 'repo' must be provided together. This field is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_MILESTONEDeletes the specified milestone if it exists; this operation is idempotent, typically returning a 404 if the milestone is not found or already deleted.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The username or organization name that owns the repository. This name is not case-sensitive.
The unique number that identifies the milestone to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_ORGANIZATIONDeletes a GitHub organization and its repositories; this is a destructive action and the organization name will be unavailable for reuse for approximately 90 days.
Input parameters
The unique name of the organization to be deleted. This name is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_ORGANIZATION_SECRETPermanently deletes a secret from a GitHub organization, making it inaccessible to GitHub Actions workflows or other tools.
Input parameters
The name of the organization. This name is not case-sensitive.
The name of the secret to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_ORGANIZATION_VARIABLEDeletes a named GitHub Actions variable from a specified organization.
Input parameters
The name of the organization. This parameter is not case-sensitive.
The name of the organization variable to delete. This parameter is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_ORGANIZATION_WEBHOOKDeletes a specific webhook, identified by `hook_id`, from an existing organization.
Input parameters
The name of the organization. This field is not case-sensitive.
The unique identifier of the webhook. This ID can be retrieved from the `X-GitHub-Hook-ID` header in a webhook delivery or by listing organization webhooks.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_ORG_CODESPACEPermanently deletes a specific codespace belonging to a member of the specified organization.
Input parameters
The organization's name (case-insensitive).
GitHub username of the user owning the codespace.
Unique name of the codespace.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_ORG_PACKAGEDeletes a specific package in an organization; cannot delete public packages with over 5,000 downloads.
Input parameters
Name of the organization owning the package (not case-sensitive).
Unique name of the package to be deleted.
Type of the package to be deleted. Packages in GitHub's Gradle registry have type `maven`. Docker images in GitHub's Container registry (`ghcr.io`) have type `container`. Use type `docker` for images previously in GitHub's Docker registry (`docker.pkg.github.com`), even if migrated to the Container registry.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_PACKAGEPermanently deletes a specific package owned by the authenticated user; public packages downloaded over 5,000 times cannot be deleted via this API.
Input parameters
The unique name of the package to delete. For npm: supports scoped packages like '@scope/name'. For maven: use format 'com.example.package'. For container/docker: use image name like 'my-app'. The name must match exactly as it appears in the GitHub Packages registry.
The type of package to delete. Supported types: 'npm' (Node.js packages), 'maven' (Java/Gradle packages), 'rubygems' (Ruby gems), 'docker' (legacy Docker images from docker.pkg.github.com), 'nuget' (.NET packages), 'container' (Docker images from ghcr.io). Note: GitHub Gradle packages use 'maven' type; ghcr.io images use 'container' type.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_PACKAGE_VERSIONTool to delete a package version using GitHub GraphQL API. Use when you need to remove a specific version of a package by its global node ID.
Input parameters
A unique identifier for the client performing the mutation. Used to ensure idempotency of mutations.
The global node ID of the package version to delete (e.g., 'MDEyOlBhY2thZ2VWZXJzaW9uMQ=='). This is the GraphQL ID, not the numeric REST API ID.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_PACKAGE_VERSION_FOR_AN_ORGANIZATIONDeletes a specific package version within an organization; requires admin permissions for packages with over 5,000 downloads.
Input parameters
Organization name (case-insensitive).
Name of the package.
Package ecosystem. Notes: - `maven`: For GitHub's Gradle registry packages. - `container`: For Docker images in GitHub's Container registry (ghcr.io). - `docker`: For images originally in GitHub's Docker registry (docker.pkg.github.com), including migrated ones.
Unique ID of the package version to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_PACKAGE_VERSION_FOR_A_USERPermanently and irreversibly deletes a specific version of a package owned by the specified user.
Input parameters
The GitHub username of the account that owns the package.
The name of the package to which the version belongs.
The type of the package. Supported types include npm, maven, rubygems, docker, nuget, and container. Packages in GitHub's Gradle registry use the `maven` type. Docker images in GitHub's Container registry (ghcr.io) use the `container` type. The `docker` type can be used for images previously in GitHub's Docker registry (docker.pkg.github.com), even if migrated.
The unique identifier of the package version to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_PENDING_REVIEWDeletes a pending (unsubmitted) review from a pull request; this is only possible if the review has not yet been submitted.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository. This name is not case-sensitive.
The unique identifier of the pending review to be deleted.
The number that identifies the pull request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_PROJECTDeletes the specified GitHub project (Projects V2) using the GraphQL API. Note: This action uses GitHub's Projects V2 GraphQL API. The legacy Projects (classic) REST API was sunset on April 1, 2025 and is no longer available. The project is permanently deleted and cannot be recovered. The user must have admin permissions for the project to delete it.
Input parameters
The unique GraphQL node ID of the project to be deleted (e.g., 'PVT_kwDOBcMqx84ABdPx'). This is returned from project creation or listing operations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_PROJECT_CARDDeletes a project card from a GitHub 'Project (classic)'; this operation is idempotent. DEPRECATION NOTICE: GitHub Classic Projects (V1) and its REST API were sunset on April 1, 2025. This action may return a 404 error on GitHub.com. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/
Input parameters
The unique numerical identifier of the project card to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_PROJECT_COLUMNDeletes a project field (column) from a GitHub Projects V2 project using the GraphQL API. IMPORTANT: GitHub Classic Projects REST API was sunset on April 1, 2025. This action now uses the GitHub Projects V2 GraphQL API with the deleteProjectV2Field mutation. Note: The built-in Status field cannot be deleted as it is a core field in GitHub Projects V2. Only custom fields can be deleted.
Input parameters
The node ID of the project field to be deleted. This is a GraphQL node ID (e.g., 'PVTF_...').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_PROJECT_ITEM_FOR_USERTool to delete a project item for a user in GitHub Projects V2. Use when you need to remove an item from a user's project. Requires the project item's GraphQL node ID (starts with 'PVTI_'). Uses the GitHub GraphQL API deleteProjectV2Item mutation.
Input parameters
The GraphQL node ID of the project item to delete (e.g. 'PVTI_lADOBCxhzs4A...').
The handle for the GitHub user account.
The project's number.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_PULL_REQUEST_COMMENT_REACTIONDeletes a specific reaction from a pull request review comment, provided the comment and reaction exist on that comment within the specified repository.
Input parameters
Name of the repository, without the `.git` extension; not case-sensitive.
Account owner (username or organization) of the repository; not case-sensitive.
Unique ID of the pull request review comment.
Unique ID of the reaction to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_PULL_REQUEST_REVIEW_PROTECTIONDisables the requirement for pull request reviews before merging for a specific, existing branch in an existing repository; this action is idempotent and will succeed even if the protection is not currently enabled.
Input parameters
Name of the repository, without the `.git` extension (not case-sensitive).
Username or organization name of the repository owner (not case-sensitive).
Name of the branch to remove pull request review protection from (wildcards not supported; use GraphQL API for wildcards).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_REPO_CODESPACE_SECRET_BY_NAMEDeletes a specific Codespace secret from a repository by its name; this action is idempotent and will succeed even if the secret doesn't exist.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username of the account or the name of the organization that owns the repository. This field is not case-sensitive.
The name of the Codespace secret to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_SOCIAL_ACCOUNTS_FOR_THE_AUTHENTICATED_USERDeletes currently linked social media account URLs from the authenticated user's GitHub profile.
Input parameters
Absolute URLs of the social media profiles to be unlinked from the GitHub profile.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_TEAM_DISCUSSION_COMMENT_REACTIONDeletes a reaction from a team discussion comment, given the organization name, team slug, discussion number, comment number, and reaction ID.
Input parameters
The organization name. The name is not case sensitive.
The slug of the team name (URL-friendly version).
The unique identifier of the reaction to be deleted.
The number that uniquely identifies the comment within the discussion.
The number that uniquely identifies the discussion.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_TEAM_DISCUSSION_REACTIONPermanently deletes a specific reaction from a team discussion within an organization.
Input parameters
The organization name. This name is not case sensitive.
The slug of the team name, which is a URL-friendly version of the team name.
The unique identifier of the reaction to be deleted.
The unique number identifying the specific discussion within the team.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_USER_LISTTool to delete a GitHub user list using GraphQL. Use when you need to remove a user list from a GitHub account.
Input parameters
The ID of the user list to delete. This is a GitHub global node ID for the list.
A unique identifier for the client performing the mutation. Used to track requests.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_USER_PACKAGEDeletes a package owned by the specified user, requiring admin permissions for the authenticated user; deletion of public packages with over 5,000 downloads may require GitHub support.
Input parameters
The GitHub username of the account that owns the package.
The unique name of the package to be deleted.
Ecosystem of the package. Packages in GitHub's Gradle registry use `maven`. Docker images pushed to GitHub's Container registry (`ghcr.io`) use `container`. The `docker` type can find images from the old Docker registry (`docker.pkg.github.com`), even if migrated.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DELETE_WORKFLOW_RUN_LOGSDeletes all logs for a specific workflow run in a GitHub repository, provided the repository and run exist.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The unique identifier of the workflow run.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DISABLE_A_CUSTOM_PROTECTION_RULE_FOR_AN_ENVIRONMENTDisables a specific, currently active custom deployment protection rule for an existing environment within a GitHub repository.
Input parameters
The name of the repository (without the `.git` extension). This name is not case sensitive.
The account owner of the repository (e.g., a user or organization). This name is not case sensitive.
The name of the environment. This name must be URL encoded; for example, any slashes (`/`) in the name must be replaced with `%2F`.
The unique integer identifier of the custom deployment protection rule to be disabled.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DISABLE_A_WORKFLOWDisables a specified workflow (by ID or filename) in a given GitHub repository, preventing new automatic triggers; any in-progress runs will continue.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The account owner of the repository (username or organization name). This field is not case-sensitive.
The ID of the workflow or the workflow's file name (e.g., `main.yml` or `ci.yaml`). You can obtain the workflow ID by listing workflows in a repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DISABLE_PRIVATE_VULN_REPORTING_FOR_REPODisables private vulnerability reporting for an existing GitHub repository, preventing direct private vulnerability reports to maintainers via GitHub's interface for this repository.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The account owner of the repository (e.g., a GitHub username or organization name). This field is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DISABLE_REPOSITORY_ACTIONS_IN_ORGRemoves a repository from the list of selected repositories enabled for GitHub Actions in an organization. Only works when the organization's `enabled_repositories` policy is set to `selected`. Requires admin:org scope.
Input parameters
The GitHub organization name (not case-sensitive).
The unique identifier of the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DISMISS_A_REVIEW_FOR_A_PULL_REQUESTDismisses an APPROVED or CHANGES_REQUESTED review on a pull request with a mandatory explanatory message. IMPORTANT: Only reviews in APPROVED or CHANGES_REQUESTED state can be dismissed. Reviews in COMMENTED, PENDING, or already DISMISSED state will return a 422 error. To dismiss a review on a protected branch, you must be a repository admin or be authorized to dismiss pull request reviews.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The event type for dismissing the review. Must be set to DISMISS.
The username or organization name that owns the repository. This field is not case-sensitive.
The reason for dismissing the review. This is a required field.
The unique identifier for the review to be dismissed. The review must be in APPROVED or CHANGES_REQUESTED state.
The unique number identifying the pull request within the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DOWNLOAD_AN_ARTIFACTDownloads a GitHub Actions workflow artifact as a ZIP file. Returns the artifact as a downloadable file. Use GITHUB_LIST_ARTIFACTS_FOR_A_REPOSITORY or GITHUB_LIST_WORKFLOW_RUN_ARTIFACTS to get valid artifact IDs first.
Input parameters
Repository name, without the `.git` extension (case-insensitive).
Username or organization name of the repository owner (case-insensitive).
Unique numeric identifier of the artifact. Obtain from GITHUB_LIST_ARTIFACTS_FOR_A_REPOSITORY or GITHUB_LIST_WORKFLOW_RUN_ARTIFACTS actions.
Archive format for the download. GitHub API only supports 'zip'. Defaults to 'zip'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DOWNLOAD_A_REPOSITORY_ARCHIVE_TARDownloads a repository's source code as a tarball (.tar.gz) archive for a specific Git reference, if the repository is accessible.
Input parameters
A Git reference (e.g., branch name, tag name, or commit SHA) that points to the specific version of the repository content to be downloaded as a tarball archive. For example, `main` for the main branch, `v1.0.0` for a tag, or a full commit SHA.
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DOWNLOAD_A_REPOSITORY_ARCHIVE_ZIPDownloads a repository's source code as a ZIP archive for a specific Git reference (branch, tag, or commit SHA). IMPORTANT SIZE LIMITATION: This action may fail with 'payload too large' errors for large repositories due to platform size restrictions. If you encounter size limit issues, consider these alternatives: - Use GITHUB_GET_REPOSITORY_CONTENT to fetch specific files or directories (also lists directory contents) - Clone the repository using git if you need the full codebase Best suited for: small to medium repositories, downloading specific tagged releases, or quick code inspection.
Input parameters
The Git reference for the archive. This can be a branch name, a tag name, or a commit SHA.
The name of the repository, without the `.git` extension. This is not case-sensitive.
The username of the account that owns the repository. This is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DOWNLOAD_JOB_LOGS_FOR_A_WORKFLOW_RUNDownloads logs for a specific job in a GitHub Actions workflow run, contingent on the repository's existence and the job ID being valid and having produced logs.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository (e.g., user or organization). This name is not case-sensitive.
The unique identifier of the job for which to download logs. You can obtain this from the 'List jobs for a workflow run' endpoint.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DOWNLOAD_WORKFLOW_RUN_ATTEMPT_LOGSDownloads a ZIP archive of logs for a specific workflow run attempt. Returns a downloadable ZIP file containing logs for all jobs and steps in the workflow run.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The unique identifier of the workflow run.
The attempt number of the workflow run.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_DOWNLOAD_WORKFLOW_RUN_LOGSDownloads logs for a specific GitHub Actions workflow run as a ZIP archive containing log files for each job in the workflow.
Input parameters
The name of the repository (e.g., 'Spoon-Knife') without the `.git` extension. This name is not case-sensitive.
The account owner of the repository (e.g., 'octocat'). This name is not case-sensitive.
The unique identifier of the workflow run (e.g., 12345).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ENABLE_A_WORKFLOWReactivates a currently disabled GitHub Actions workflow within a repository using its workflow ID or filename.
Input parameters
The name of the repository, without the `.git` extension. This value is not case-sensitive.
The username or organization name that owns the repository. This value is not case-sensitive.
The ID of the workflow to be enabled. You can provide either the numeric workflow ID (e.g., 30433642) or the workflow filename (e.g., 'ci.yaml', 'data.yml').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ENABLE_GITHUB_ACTIONS_IN_SELECTED_REPOSITORIESSets the specific repositories that can use GitHub Actions within an organization by replacing the current list; only applies if the organization's Actions policy is 'selected repositories'.
Input parameters
Name of the GitHub organization (case-insensitive).
List of unique repository IDs for which GitHub Actions will be enabled. This list completely replaces the current selection of repositories.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ENABLE_PRIVATE_VULN_REPORTING_FOR_REPOEnables private vulnerability reporting for a repository, allowing security researchers to privately submit vulnerability reports to maintainers.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The account owner of the repository. This is typically the username or organization name and is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ENABLE_REPO_FOR_GITHUB_ACTIONSAdds a repository to the list of selected repositories enabled for GitHub Actions in an organization. Requires the organization's 'enabled_repositories' policy to be set to 'selected'.
Input parameters
The name of the GitHub organization. This name is not case-sensitive.
The unique numerical identifier of the GitHub repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ENCRYPT_AND_UPDATE_DEV_SECRETCreates or updates a repository's development environment secret using an `encrypted_value` and its corresponding `key_id`; the secret must be pre-encrypted with the repository's Codespaces public key.
Input parameters
The name of the repository without the `.git` extension. This name is not case-sensitive.
The account owner of the repository. This name is not case-sensitive.
ID of the public key (retrieved from the GitHub API's 'Get a repository public key for Codespaces' endpoint: `GET /repos/{owner}/{repo}/codespaces/secrets/public-key`) used to encrypt the secret's value. If not provided, it will be fetched automatically.
The name of the development environment secret.
The plaintext value for your secret. This will be automatically encrypted using the repository's Codespaces public key before being sent to GitHub. If you already have an encrypted value, use the encrypted_value parameter instead.
Value for your secret, already encrypted using the public key retrieved from the GitHub API's 'Get a repository public key for Codespaces' endpoint (`GET /repos/{owner}/{repo}/codespaces/secrets/public-key`). Use this if you have pre-encrypted the value yourself.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_ENCRYPT_ORG_DEV_ENV_SECRETCreates or updates an organization's GitHub Codespaces secret using an encrypted value and its corresponding public key ID.
Input parameters
The GitHub organization name (case-insensitive).
ID of the public key (from GET /orgs/{org}/codespaces/secrets/public-key) used to encrypt the secret's value. If not provided, it will be fetched automatically when encrypting.
Visibility of the secret. 'selected' requires `selected_repository_ids`.
Name of the secret to create or update.
The plaintext value for your secret. This will be automatically encrypted using the organization's Codespaces public key before being sent to GitHub. If you already have an encrypted value, use the encrypted_value parameter instead.
Encrypted secret value, using the public key from 'Get an organization public key' (GET /orgs/{org}/codespaces/secrets/public-key). Use this if you have pre-encrypted the value yourself. If not provided and secret_value is given, encryption will be done automatically.
Repository IDs that can access the secret; required if visibility is 'selected'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_EXPORT_A_CODESPACE_FOR_THE_AUTHENTICATED_USERTriggers an export of a user's specified codespace, automatically stopping it if active, and returns its export status and download URL.
Input parameters
Unique name of the codespace to be exported.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_EXPORT_SBOM_FOR_REPOExports the software bill of materials (SBOM) in SPDX JSON format for a repository, if its dependency graph is enabled and it has at least one commit.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_FIND_PULL_REQUESTSPrimary tool to find and search pull requests. Supports filtering by repository, author, state, labels, and merge status, and returns structured PR data for reliable use in workflows. GitHub search results are capped at ~1000 total items; narrow filters when totals approach this limit. `created_since`/`updated_since` filter on creation/update timestamps, not `merged_at`; apply merge-date filtering client-side.
Input parameters
Page number of results to fetch.
Filter by specific repository. Can be provided in 'owner/repo' format (e.g., 'facebook/react'), or as just the repo name when used with the owner parameter. When owner and repo are both provided and have the same value, they are combined as 'owner/repo'. When omitted along with owner, search scope is determined by for_authenticated_user flag. The repository must exist and be accessible with your token. Prefer 'owner/repo' format; bare repo name without the `owner` parameter causes invalid repository format errors.
Field to sort results by. Set explicitly to 'updated' with `order=desc` when recency matters; default behavior may return best-match relevance ordering instead.
Filter by label name.
Sort order (ascending or descending).
Filter by repository owner (user or organization). Can be used alone to search all repositories for an owner, or combined with repo parameter to specify owner and repo separately. When both owner and repo are provided, the search is scoped to 'owner/repo'. When omitted along with repo, search scope is determined by for_authenticated_user flag. The owner must exist and repositories must be accessible with your token.
Optional search query for PR title, description, or commit messages. Supports GitHub search syntax including label filters (e.g., 'label:bug'), logical operators (AND, OR, NOT), and text search. If not provided, PRs will be listed based on other filter parameters. Type qualifiers (type:pr, is:pr, is:issue, type:issue) are automatically normalized. When using logical operators with qualifiers like labels, the query is automatically grouped for proper parsing. When omitting query, ensure at least one structured filter parameter is provided; passing no query and no filters may cause validation errors. Prefer dedicated parameters (`label`, `state`, `author`) over embedding qualifiers in the query string. Exact title matching is not supported; post-filter on title client-side if needed.
Filter by PR state: 'open', 'closed', or 'all'.
Filter by PR author username. Must be a valid GitHub username (alphanumeric characters and hyphens only, cannot start or end with hyphen). No dots or other special characters allowed.
Filter by PR assignee username. Use '@me' for current user. Must be a valid GitHub username (alphanumeric characters and hyphens only, cannot start or end with hyphen). No dots or other special characters allowed.
Filter by programming language.
Filter by username mentioned in PR. Must be a valid GitHub username (alphanumeric characters and hyphens only, cannot start or end with hyphen). No dots or other special characters allowed.
Number of results per page (maximum 100). GitHub caps total search results at ~1000 items; iterate `page` until results fewer than `per_page` are returned, and add `repo`, `label`, or date filters when totals approach 1000.
Filter by merge status. True for merged PRs, False for unmerged, None for all.
Filter by base branch name.
Filter by head branch name.
Filter PRs created after this date (ISO 8601 format). Provide as UTC ISO 8601 timestamp to avoid off-by-one-day errors at range boundaries. Does not filter on `merged_at`.
Filter PRs updated after this date (ISO 8601 format).
Level of detail in the response. 'minimal' (default) returns an optimized response for AI agents. 'full' returns the complete GitHub API response.
Include private repositories accessible to the authenticated user in search results. When True without repo/owner, searches PRs involving you (author, assignee, mentions, commenter) across all accessible repos. When False without repo/owner, restricts to public repos only. When repo/owner is specified, this flag has no effect on scope. Set to True when searching private repositories; False searches all of GitHub and produces large noisy result sets.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_FIND_REPOSITORIESAI-optimized repository search with smart filtering by language, stars, topics, and ownership. Builds intelligent search queries and returns clean, actionable repository data. Check `incomplete_results` in the response — when true, results are non-exhaustive. Search endpoints are rate-limited to ~30 requests/minute (vs. 5000/hour for general REST); apply backoff on 403/429. Total results are capped at ~1000 per query regardless of pagination.
Input parameters
Page number of results to fetch.
Field to sort results by.
Sort order (ascending or descending).
Filter by specific user or organization. Do NOT use this parameter if your 'query' already contains 'user:', 'org:', or 'repo:' qualifiers - they will conflict. Use either 'owner' parameter OR search qualifiers in 'query', not both.
Search query for repository name, description, or README content. Accepts both 'query' and 'q' as parameter names. Supports OR operator for alternatives (e.g., 'bug OR error'). Multi-word phrases in OR expressions are automatically quoted. GitHub limits OR expressions to 6 terms maximum; queries exceeding this limit are truncated. If using GitHub qualifiers like 'repo:', 'user:', or 'org:', they must be properly formatted (e.g., 'repo:owner/name', 'user:username', 'org:orgname'). Note: 'owner:' is not a valid GitHub qualifier; if used, it will be automatically transformed to 'user:'. Must be non-empty; blank strings trigger a 'Search query cannot be empty' validation error.
Filter by repository topic/tag.
Filter by archived status. None means include both.
Filter by programming language.
Number of results per page (maximum 100). GitHub caps total results at ~1000 per query; for exhaustive searches, split by `language`, `topic`, `min_stars`/`max_stars`, or `owner`.
Maximum number of stars the repository should have.
Minimum number of forks the repository should have.
Minimum number of stars the repository should have.
How to handle forks: 'include' (include forks), 'exclude' (exclude forks), 'only' (only forks).
Level of detail in the response. 'minimal' (default) returns an optimized response for AI agents. 'full' returns the complete GitHub API response.
Search only in repositories accessible to the authenticated user (including private repos). Requires token scopes `repo`/`read:org`; sparse results compared to GitHub UI typically indicate insufficient token scopes.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_FOLLOW_ORGANIZATION_GRAPHQLTool to follow a GitHub organization using GraphQL. Use when you need to make the authenticated user follow an organization.
Input parameters
The global GraphQL node ID of the organization to follow. Must be a valid organization node ID.
A unique identifier for the client performing the mutation. Used to track requests.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_FOLLOW_USERAllows the authenticated user to follow the GitHub user specified by `username`; this action is idempotent and the user cannot follow themselves.
Input parameters
The GitHub username (handle) of the user to be followed by the authenticated user.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_FOLLOW_USER_GRAPHQLTool to follow a GitHub user using GraphQL. Use when you need to make the authenticated user follow another user.
Input parameters
The global Node ID of the user to follow. Must be a valid GitHub user ID in the format 'MDQ6VXNlcjU4MzIzMQ=='.
A unique identifier for the client performing the mutation. Used to track requests.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_FORCE_CANCEL_WORKFLOW_RUNForcefully cancels a queued or in-progress GitHub Actions workflow run, bypassing conditions like always() that would otherwise continue execution. Only use when the standard cancel endpoint fails. Cannot cancel completed workflow runs. Requires write permissions to the repository.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The unique identifier of the workflow run. Note: Only workflow runs with status 'queued' or 'in_progress' can be canceled. Completed workflow runs cannot be canceled.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_FORK_GISTForks a specified public gist, creating a copy under the authenticated user's account.
Input parameters
The unique identifier of the gist to be forked.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GENERATE_RELEASE_NOTESGenerates Markdown release notes content (listing changes, pull requests, and contributors) for a GitHub repository release, customizable via tags and a configuration file.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
The tag name for which the release notes are to be generated. This can be an existing tag or a new tag name.
Specifies the commitish value (e.g., a branch name, tag name, or commit SHA) that will be the target for the release's tag. This is required if the `tag_name` does not reference an existing tag. It is ignored if `tag_name` already exists.
The name of the previous tag to use as the starting point for the release notes. This manually specifies the range of changes to be included. If omitted, GitHub will attempt to automatically determine the previous release.
Specifies a path to a configuration file in the repository (e.g., `.github/release.yml`) containing settings for generating release notes. If unspecified, GitHub looks for a configuration file at ".github/release.yml" or ".github/release.yaml". If no such file is found, default settings are used.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_BLOBRetrieves the raw, typically Base64-encoded, content of a file (blob) from a GitHub repository using its SHA hash, if the repository and blob SHA exist.
Input parameters
The name of the repository, without the '.git' extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
The SHA-1 hash of the file (blob) to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_BRANCHRetrieves detailed information for a specified branch within a GitHub repository.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use \[the GraphQL API\](https://docs.github.com/graphql). If 'HEAD' is provided, it will be resolved to the repository's default branch.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_ACCESS_RESTRICTIONSLists users, teams, and GitHub Apps with push access to a branch; this branch must be protected in repository settings for detailed restrictions, otherwise expect a 404 or empty response.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository (e.g., username or organization name). This name is not case-sensitive.
The name of the branch. Wildcard characters are not supported in this field. To manage branch protections with wildcard patterns, please refer to the GitHub GraphQL API documentation.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_COMMITRetrieves a specific commit from a repository by its owner, name, and a valid commit reference (SHA, branch, or tag), supporting pagination for large diffs.
Input parameters
The commit reference. Can be a commit SHA (e.g., '`sha`'), a branch name (e.g., 'heads/`BRANCH_NAME`' or simply '`BRANCH_NAME`'), or a tag name (e.g., 'tags/`TAG_NAME`'). For more information, see "\[Git References\](https://git-scm.com/book/en/v2/Git-Internals-Git-References)" in the Git documentation.
Page number for paginating the commit's diff if it's too large. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
Number of results per page when paginating the commit's diff (max 100). For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_ADMIN_BRANCH_PROTECTIONChecks if repository administrators are subject to the branch protection rules on a specific branch.
Input parameters
Name of the repository, without the `.git` extension (case-insensitive).
Account owner of the repository (case-insensitive).
Name of the branch (wildcard characters not allowed; use GraphQL API for wildcard support).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_ALL_API_VERSIONSRetrieves all officially supported, date-based (e.g., "2022-11-28") versions of the GitHub REST API from the /versions endpoint.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_ALL_CONTRIBUTOR_COMMIT_ACTIVITYRetrieves commit activity (total commits, weekly additions/deletions/commits) for all contributors to a repository; may require a retry if GitHub returns 202 while preparing data.
Input parameters
Repository name, excluding `.git` (case-insensitive).
Username of the repository owner (case-insensitive).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_ALL_DEPLOYMENT_PROTECTION_RULES_FOR_ENVLists all enabled custom deployment protection rules for a specific environment in a repository; the environment must exist and be configured for deployments.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
The name of the environment. This name must be URL-encoded. For instance, if the environment name contains slashes (`/`), they should be replaced with `%2F`.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_MILESTONERetrieves detailed information for a specific milestone within a GitHub repository by its number.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username of the account that owns the repository. This field is not case-sensitive.
The unique sequential number identifying the milestone within the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_AN_APPRetrieves publicly available information for an existing GitHub App, identified by its unique URL-friendly `app_slug`.
Input parameters
The app's unique, URL-friendly, lowercase, hyphenated identifier, derived from its name (e.g., 'my-awesome-app').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_AN_ARTIFACTGets a specific artifact for a repository by `artifact_id`. This action retrieves the details of a specific artifact from a GitHub repository using the artifact's unique identifier. It allows users to access information about artifacts stored in the repository.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
The unique identifier (ID) of the artifact to retrieve. This ID can be obtained from other API calls that list artifacts.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_AN_ASSIGNMENTRetrieves detailed information for a specific GitHub Classroom assignment if the authenticated user is an administrator of the classroom.
Input parameters
The unique identifier of the GitHub Classroom assignment to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_AN_AUTOLINK_REFERENCE_OF_A_REPOSITORYRetrieves a specific autolink reference (which automatically hyperlinks text like 'JIRA-123' to an external system) for a repository using its unique ID; requires administrator access to the repository.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
The unique numeric identifier of the autolink configuration to retrieve. You can get this ID from the 'Get all autolinks of a repository' action.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_AN_ENVIRONMENTRetrieves the details of a specific deployment environment for a given repository, including its name, configurations, and current status.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The username of the account that owns the repository. This name is not case-sensitive.
The name of the deployment environment. The name must be URL-encoded; for example, any slashes `/` must be replaced with `%2F`.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_AN_ENVIRONMENT_PUBLIC_KEYRetrieves the public key for a specified GitHub repository environment, used to encrypt secrets for GitHub Actions.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
The name of the environment. The name must be URL encoded. For example, any slashes (`/`) in the name must be replaced with `%2F`.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_AN_ENVIRONMENT_SECRETRetrieves metadata (name and timestamps) for a single secret in a GitHub Actions environment. Note: The actual secret value is never returned by this API for security reasons.
Input parameters
Name of the repository, without the `.git` extension (not case-sensitive).
Username or organization name of the repository owner (not case-sensitive).
Name of the secret to retrieve.
Name of the environment (must be URL-encoded if it contains special characters).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_AN_ENVIRONMENT_VARIABLERetrieves a specific environment variable from a GitHub Actions environment by repository owner, repository name, environment name, and variable name.
Input parameters
The name of the specific environment variable to retrieve.
The name of the repository, without the `.git` extension. This is not case-sensitive.
The username or organization name that owns the repository. This is not case-sensitive.
The name of the GitHub Actions environment. If the name contains special characters (e.g., slashes `/`), it must be URL-encoded (e.g., `staging/feature` becomes `staging%2Ffeature`).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_AN_ISSUERetrieves detailed information about a specific issue in a repository using the owner, repository name, and issue number.
Input parameters
Name of the repository (without `.git` extension). Not case-sensitive.
Username of the account owning the repository. Not case-sensitive.
The identifying number of the issue.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_AN_ISSUE_COMMENTAction to get an issue comment.
Input parameters
The name of the repository, without the `.git` extension. This field is not case sensitive.
The username of the account that owns the repository. This field is not case sensitive.
The unique identifier of the issue comment.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_AN_ISSUE_EVENTFetches details of a specific issue event for a given repository and event ID.
Input parameters
Name of the repository, without the `.git` extension. Not case-sensitive.
Username of the account owning the repository. Not case-sensitive.
Unique identifier for the issue event.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_AN_ORGANIZATIONGet an organization
Input parameters
The name of the organization. This name is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_AN_ORGANIZATION_PUBLIC_KEYAction for `GetAnOrganizationPublicKey`.
Input parameters
Organization name (case-insensitive).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_AN_ORGANIZATION_ROLERetrieves a specific GitHub organization role by its ID.
Input parameters
The name of the GitHub organization. This name is not case-sensitive.
The unique numerical identifier of the role within the organization.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_AN_ORGANIZATION_SECRETGets an organization secret's metadata (e.g., name, creation/update dates, visibility), but not its encrypted value.
Input parameters
Organization name (case-insensitive).
Name of the secret.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_AN_ORGANIZATION_VARIABLERetrieves details (name, value, visibility, timestamps) of a specific, existing variable for an existing GitHub organization.
Input parameters
Name of the organization (case-insensitive).
Name of the organization variable.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_AN_ORGANIZATION_WEBHOOKRetrieves the full configuration, including subscribed events and delivery settings, for an existing organization webhook.
Input parameters
The name of the GitHub organization. This field is not case-sensitive.
The unique identifier of the webhook. You can find this value in the `X-GitHub-Hook-ID` header of a webhook delivery.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_PACKAGE_FOR_AN_ORGANIZATIONRetrieves a specific package (by type and name) from an organization, if both the package and organization exist.
Input parameters
Name of the GitHub organization (case-insensitive).
The unique name of the package.
Type of the package. GitHub Gradle packages use `maven` type. Images from `ghcr.io` (Container registry) use `container` type. Use `docker` for images from `docker.pkg.github.com` (Docker registry), even if migrated to the Container registry.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_PACKAGE_FOR_A_USERRetrieves metadata for a specific package owned by a GitHub user, using package type, name, and username as identifiers.
Input parameters
GitHub username of the package owner.
Unique name of the package on GitHub Packages.
Specifies the package's type. Note: Gradle packages use 'maven'; ghcr.io images use 'container'; 'docker' can find images migrated from docker.pkg.github.com to the Container registry.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_PACKAGE_FOR_THE_AUTHENTICATED_USERRetrieves detailed information for a specific package owned by the authenticated user.
Input parameters
The unique name of the package as it appears in the registry.
Type of the package. 'maven' for GitHub's Gradle registry; 'container' for Docker images in GitHub's Container registry (`ghcr.io`); 'docker' for images from GitHub's Docker registry (`docker.pkg.github.com`), including those migrated to the Container registry.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_PACKAGE_VERSION_FOR_AN_ORGANIZATIONRetrieves detailed information for a specific version of a package within an organization.
Input parameters
Organization name (case-insensitive).
Unique package name.
Package type. `maven` for GitHub Gradle registry. `container` for GitHub Container registry (`ghcr.io`) images. `docker` for images from GitHub Docker registry (`docker.pkg.github.com`), including migrated ones.
Unique ID of the package version.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_PACKAGE_VERSION_FOR_A_USERRetrieves a specific public package version associated with a GitHub user.
Input parameters
The GitHub username of the account that owns the package.
The name of the package.
The type of package. 'maven' is used for Gradle packages. 'container' is for images in GitHub's Container registry (ghcr.io). 'docker' can be used for images previously in GitHub's Docker registry (docker.pkg.github.com).
The unique numeric identifier of the specific package version. Obtain this ID by first listing package versions using the 'list_package_versions_for_a_package_owned_by_a_user' action.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_PACKAGE_VERSION_FOR_THE_AUTHENTICATED_USERRetrieves detailed information for an existing specific package version associated with the authenticated user, identified by its type, name, and version ID.
Input parameters
The name of the package, which can be case-sensitive depending on the package type.
The package type. Note: GitHub's Gradle registry packages use 'maven'; ghcr.io images use 'container'; 'docker' can refer to images from docker.pkg.github.com.
The unique numerical identifier (ID) of the specific package version.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_PROJECTRetrieves detailed information for a specific GitHub project (V2) using its project number and owner. Note: This action uses GitHub's Projects V2 REST API. The legacy Projects (classic) REST API was sunset on April 1, 2025. The project is identified by its number (visible in the project URL) and owner (either a username or organization name). If no owner is specified, the authenticated user is assumed.
Input parameters
The organization that owns the project. If provided, this takes precedence over username.
The GitHub username who owns the project. If not provided, defaults to the authenticated user.
The project's sequential number (e.g., 1, 2, 3). This is displayed in the project URL as https://github.com/users/{username}/projects/{project_number}.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_PROJECT_CARDRetrieves all details of a specific project card, given its unique `card_id`. DEPRECATION NOTICE: GitHub Projects (classic) REST API was sunset on April 1, 2025. This action only works with existing classic project cards that were created before the sunset date. For new projects, use GitHub Projects V2 (GraphQL API) instead.
Input parameters
The unique identifier of the project card.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_PROJECT_COLUMNRetrieves detailed information for a specific project column from GitHub Projects (classic). DEPRECATION NOTICE: GitHub Classic Projects (V1) and its REST API were sunset on April 1, 2025. This action will return 404 for most requests on GitHub.com. However, it may still work on GitHub Enterprise Server instances where classic projects are enabled. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/ Returns column details including: id, name, url, project_url, cards_url, node_id, created_at, and updated_at timestamps.
Input parameters
The unique integer identifier of the project column to retrieve. This ID can be obtained from the 'list_project_columns' action or from the column's API URL (e.g., /projects/columns/12345).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_PULL_REQUESTRetrieves a specific pull request from a GitHub repository using its owner, repository name, and pull request number.
Input parameters
The name of the repository, without the .git extension. This value is not case sensitive.
The username of the account that owns the repository. This value is not case sensitive.
The number that identifies the specific pull request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_REFERENCERetrieves a specific Git reference (e.g., a branch, tag, or fully qualified like 'heads/main') from a GitHub repository. The reference must exist in the repository; use 'list_matching_references' first if unsure what references are available.
Input parameters
The Git reference to retrieve. Must be formatted as `heads/<branch_name>` for branches, `tags/<tag_name>` for tags, or `pull/<number>/head` (or `pull/<number>/merge`) for pull requests. Simple branch names (e.g., `main`) are automatically converted to `heads/<name>`. The reference must exist in the repository; a 404 error is returned if not found. If unsure which references exist, use 'list_matching_references' or 'get_a_branch' first. Note: Commit SHAs are not supported by this endpoint; use commit-specific endpoints instead. Not all repositories use 'master'; many now use 'main' as the default branch.
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_RELEASEGets a specific release from a GitHub repository, provided the repository is accessible and the release exists.
Input parameters
The name of the repository, without the '.git' extension. This field is not case-sensitive.
The username of the account that owns the repository. This field is not case-sensitive.
The unique numerical identifier for the release.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_RELEASE_ASSETGets metadata for a specific release asset in a GitHub repository, including a `browser_download_url` for downloading the asset.
Input parameters
The name of the repository, without the `.git` extension. This name is not case sensitive.
The account owner of the repository (GitHub username or organization name). This name is not case sensitive.
The unique numeric identifier of the release asset.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_RELEASE_BY_TAG_NAMEGets a release from a GitHub repository by its tag name; the repository and a release with this tag must already exist.
Input parameters
Tag identifying the release to fetch.
Name of the repository, without the `.git` extension (not case sensitive).
Account owner of the repository (not case sensitive).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_REPOSITORYRetrieves detailed information about an existing and accessible GitHub repository.
Input parameters
The name of the repository, without the `.git` extension. This field is case-insensitive.
The username of the account that owns the repository. This field is case-insensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_REPOSITORY_PUBLIC_KEYGets a repository's public key for encrypting secrets to be used in GitHub Actions, if the repository exists and is accessible.
Input parameters
Name of the repository without the `.git` extension (case-insensitive).
Account owner of the repository (case-insensitive).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_REPOSITORY_READMEFetches the README file (if it exists and is accessible) from a specified GitHub repository, returning its Base64-encoded content and metadata.
Input parameters
The specific git reference (branch name, tag name, or commit SHA) to retrieve the README from. If omitted, the repository's default branch is used.
The name of the repository, excluding the `.git` extension. This name is not case-sensitive.
The GitHub account owner of the repository. This name is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_REPOSITORY_README_FOR_A_DIRECTORYRetrieves the README file from a specified directory within a GitHub repository, optionally at a given commit, branch, or tag.
Input parameters
Path to the directory containing the README file.
Commit, branch, or tag name; defaults to the repository's default branch if not provided.
Name of the repository, without the `.git` extension (not case sensitive).
Username of the account owning the repository (not case sensitive).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_REPOSITORY_RULESETRetrieves a specific repository ruleset by its ID; if `includes_parents` is true, the search for this `ruleset_id` also extends to rulesets from parent organizations.
Input parameters
Repository name, excluding `.git` extension; case-insensitive.
Account owner of the repository (username or organization); case-insensitive.
Unique identifier of the ruleset.
If true, also returns rulesets configured at higher levels (e.g., organization) that apply to this repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_REPOSITORY_RULE_SUITEGets detailed information for a specific repository rule suite by its ID, including its evaluation status and the results of its individual rules.
Input parameters
The name of the repository, excluding the `.git` extension. This name is not case-sensitive.
The username of the account or the name of the organization that owns the repository. This name is not case-sensitive.
The unique identifier of the rule suite. To obtain this ID, you can list rule suites for the repository (e.g., via `GET /repos/{owner}/{repo}/rulesets/rule-suites`) or organization (e.g., via `GET /orgs/{org}/rulesets/rule-suites`).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_REPOSITORY_SECRETGets metadata (name, creation/update timestamps) for an existing repository secret, excluding its encrypted value.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
The name of the secret to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_REPOSITORY_SUBSCRIPTIONGets the authenticated user's subscription details for a repository, indicating if they receive notifications.
Input parameters
The name of the repository, without the `.git` extension. This is not case-sensitive.
The username of the account that owns the repository. This is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_REPOSITORY_VARIABLEGets a specific GitHub Actions variable by name from an accessible repository.
Input parameters
The name of the GitHub Actions variable to retrieve.
The name of the repository, without the `.git` extension.
The username or organization that owns the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_REPOSITORY_WEBHOOKReturns the configuration of an existing webhook for a given repository.
Input parameters
The name of the repository without the `.git` extension. The name is not case-sensitive.
The account owner of the repository (e.g., a user or organization). The name is not case-sensitive.
The unique identifier of the hook. You can find this value in the `X-GitHub-Hook-ID` header of a webhook delivery.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_REVIEW_COMMENT_FOR_A_PULL_REQUESTRetrieves a specific pull request review comment by its ID, provided the repository exists, is accessible, and the comment ID is valid.
Input parameters
The name of the repository (without the `.git` extension). Not case-sensitive.
The account owner of the repository (GitHub username or organization name). Not case-sensitive.
Unique identifier of the pull request review comment.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_REVIEW_FOR_A_PULL_REQUESTRetrieves a specific review for a pull request using its owner, repository, pull request number, and review ID.
Input parameters
The name of the repository, without the `.git` extension. This is not case sensitive.
The username of the account that owns the repository. This is not case sensitive.
The unique numeric identifier of the review.
The numeric identifier of the pull request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_SECRET_FOR_THE_AUTHENTICATED_USERRetrieves metadata (name, timestamps, visibility; not the value) for a specific, existing development environment secret associated with the authenticated user's GitHub Codespaces.
Input parameters
The name of the secret to retrieve. This is case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_SELF_HOSTED_RUNNER_FOR_AN_ORGANIZATIONRetrieves detailed information about a specific self-hosted runner registered within a GitHub organization.
Input parameters
The login name of the GitHub organization. This name is not case-sensitive.
Unique identifier (ID) of the self-hosted runner.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_SELF_HOSTED_RUNNER_FOR_A_REPOSITORYGets a specific self-hosted runner for a repository by its unique ID.
Input parameters
The name of the repository, without the `.git` extension. This is not case-sensitive.
The username of the account that owns the repository. This is not case-sensitive.
The unique identifier (ID) of the self-hosted runner.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_ASSIGNMENT_GRADESRetrieves all grades for an existing GitHub Classroom assignment.
Input parameters
The unique identifier of the classroom assignment. This can be obtained from the list_assignments_for_a_classroom action or from the assignment's URL in GitHub Classroom.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_TAGRetrieves detailed information for a specific Git tag object from a GitHub repository, using the SHA of the tag object itself.
Input parameters
Name of the repository, without the `.git` extension (case-insensitive).
Username or organization that owns the repository (case-insensitive).
SHA of the Git tag object to retrieve; this is the SHA of the tag object, not the commit it may point to.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_TEAM_BY_NAMERetrieves a GitHub team by its slug from a specific organization.
Input parameters
The organization's name (case-insensitive).
The slug (URL-friendly version) of the team name.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_THREADRetrieves a specific GitHub notification thread using its unique `thread_id`.
Input parameters
The unique identifier of the notification thread, typically obtained from a list of notifications.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_THREAD_SUBSCRIPTION_FOR_THE_AUTHENTICATED_USERRetrieves the authenticated user's subscription details for a specific notification thread, identified by `thread_id`.
Input parameters
The unique identifier of the notification thread. This ID corresponds to the `id` field returned when retrieving notifications, for example, through the 'List notifications for the authenticated user' (GET /notifications) operation.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_TREEBrowse and list all files/directories in a GitHub repository. Efficiently retrieves the complete repository structure in a single API call when used with recursive mode. Perfect for analyzing codebase structure, finding specific files, or getting an overview of repository contents without cloning.
Input parameters
Repository name without owner or .git extension (e.g., for github.com/kubernetes/kubernetes, repo is 'kubernetes').
Repository owner username or organization name (e.g., for github.com/kubernetes/kubernetes, owner is 'kubernetes').
Branch name (e.g., 'main', 'master'), tag name (e.g., 'v1.0.0'), commit SHA, or tree SHA. Directory paths are NOT supported - use a branch/tag to get the full tree, then extract the directory's SHA from results.
Set to True (or '1'/'true') to fetch the ENTIRE repository file tree recursively (all files and directories in one call). Set to False or leave empty to fetch only the top-level files/folders. For browsing or analyzing the full repository structure, use recursive=True.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_USERRetrieves the public profile information for an existing GitHub user, specified by their username.
Input parameters
The GitHub username (handle) of the user to retrieve. This is case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_WEBHOOK_CONFIGURATION_FOR_AN_ORGANIZATIONRetrieves the configuration for a specific webhook associated with a GitHub organization.
Input parameters
The GitHub organization's name (case-insensitive).
Unique ID of the webhook (see `X-GitHub-Hook-ID` header in webhook deliveries).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_WEBHOOK_CONFIGURATION_FOR_A_REPOSITORYReturns the configuration for an existing webhook on the specified repository.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The unique identifier of the hook. You can find this value in the `X-GitHub-Hook-ID` header of a webhook delivery.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_WEBHOOK_DELIVERY_FOR_AN_ORGANIZATION_WEBHOOKReturns detailed information for a specific delivery attempt of a webhook configured for the specified GitHub organization.
Input parameters
The name of the GitHub organization. This field is not case-sensitive.
The unique identifier of the organization webhook. This ID can be found in the `X-GitHub-Hook-ID` header of a webhook delivery.
The unique identifier of the specific webhook delivery attempt.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_WORKFLOWRetrieves detailed information for a specific GitHub Actions workflow in a repository, identified by either its numeric ID or its filename.
Input parameters
Name of the repository, without the `.git` extension (case-insensitive).
Username or organization name owning the repository (case-insensitive).
Unique numeric identifier of the workflow; use this or `workflow_name`.
Full name of the workflow file (e.g., `ci.yml`); use this or `workflow_id`.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_WORKFLOW_RUNGets a specific workflow run by its ID from a GitHub repository.
Input parameters
Name of the repository (case-insensitive, without .git extension).
The username or organization name that owns the repository (not case-sensitive).
Unique ID of the workflow run.
If true, excludes pull request data; the `pull_requests` array in the response will be empty.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_A_WORKFLOW_RUN_ATTEMPTRetrieves detailed information for a specific attempt of a workflow run in a GitHub repository, including its status, conclusion, and timings.
Input parameters
The name of the repository, without the `.git` extension. This name is not case sensitive.
The account owner of the repository, such as a GitHub username or organization name. This name is not case sensitive.
The unique identifier (ID) of the workflow run. This ID is specific to a repository and can be obtained from API calls that list workflow runs.
The attempt number of the specific workflow run. Each re-run of a workflow creates a new attempt number, starting from 1.
If `true`, excludes pull request data from the API response; the `pull_requests` array in the response will then be empty.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_BILLING_USAGE_REPORT_USERRetrieves the billing usage report for a specified GitHub user. Use when you need to analyze billing costs and usage patterns.
Input parameters
If specified, only return results for a single day. The value of `day` is an integer between `1` and `31`. If no `year` or `month` is specified, the default `year` and `month` are used.
If specified, only return results for a single year. The value of `year` is an integer with four digits representing a year. For example, `2025`. Default value is the current year.
If specified, only return results for a single month. The value of `month` is an integer between `1` and `12`. If no year is specified the default `year` is used.
The handle for the GitHub user account.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_BRANCH_PROTECTIONRetrieves branch protection settings for a specific, existing, and accessible branch in a GitHub repository; protection feature availability varies by GitHub product plan.
Input parameters
Name of the repository, without the `.git` extension; not case-sensitive.
Account owner of the repository (username or organization name); not case-sensitive.
Name of the branch; wildcard characters are not supported (use GitHub GraphQL API for wildcard matching).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_CATALOG_MODELSTool to retrieve the list of AI models available in the GitHub Models catalog. Use when you need to discover available models, their capabilities, token limits, and supported modalities.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_CHECK_RUNRetrieves detailed information for a specific check run within a GitHub repository.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username of the account that owns the repository. This field is not case-sensitive.
The unique numerical identifier of the check run.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_CHECK_SUITERetrieves a specific check suite (a collection of check runs) by its ID from a repository accessible to the authenticated user.
Input parameters
The name of the repository, without the `.git` extension. This value is not case sensitive.
The username of the account that owns the repository. This value is not case sensitive.
The unique identifier of the check suite.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_CLASSROOMRetrieves details for a specific GitHub Classroom. Requires the authenticated user to be an administrator of the classroom.
Input parameters
The unique identifier of the classroom.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_CODE_OF_CONDUCTRetrieves the full details of a specific GitHub code of conduct using its unique key.
Input parameters
Unique key for a specific code of conduct.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_CODE_OF_CONDUCT_GRAPH_QLTool to look up a code of conduct by its key using GitHub's GraphQL API. Use when you need to fetch code of conduct details as part of a GraphQL workflow.
Input parameters
The unique key identifier for the code of conduct to retrieve. Common keys include 'contributor_covenant', 'citizen_code_of_conduct', and 'django'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_CODEQL_DATABASEGets an existing CodeQL database (including a download URL) for a specified language in an accessible repository, if one has been successfully built for that language.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository. This name is not case-sensitive.
The programming language of the CodeQL database to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_CODE_SCANNING_ALERTRetrieves a specific code scanning alert, which identifies potential code vulnerabilities or errors, by its number from the specified GitHub repository.
Input parameters
Repository name, without the `.git` extension (case-insensitive).
Username of the account owning the repository (case-insensitive).
Unique number identifying the code scanning alert (must be >= 1), found in the alert's URL or API responses.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_CODE_SCANNING_ANALYSISRetrieves detailed information for a specific code scanning analysis on an accessible repository, identified by its `analysis_id`.
Input parameters
Name of the repository, without the `.git` extension (not case-sensitive).
Username or organization name owning the repository (not case-sensitive).
Unique ID of the code scanning analysis, obtained by listing all analyses for the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_CODE_SCANNING_DEFAULT_SETUPGets the default setup configuration for code scanning in a repository, including state, languages, query suite, and schedule for a repository if it exists.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_CODESPACECall to retrieve detailed information for a `codespace_name` belonging to the authenticated user, ensuring the codespace exists and is accessible.
Input parameters
Unique name or identifier of the codespace, typically auto-generated upon creation.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_COMMIT_AUTHORSFetches commit authors identified during a repository import, used to map authors from an external VCS to GitHub accounts. NOTE: This endpoint has been deprecated by GitHub as of April 12, 2024, and is no longer available. The Source Imports REST API has been retired due to very low usage levels. Please use the GitHub Importer tool at https://github.com/new/import for repository imports.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The username of the account that owns the repository. This name is not case-sensitive.
An optional author ID. If provided, only authors with an ID greater than this specified ID will be returned. This ID refers to the `id` field of an author object in the response, and can be used for paginating through the list of authors.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_COMMIT_COMMENTRetrieves the full details of a specific commit comment in a GitHub repository, using its unique identifier.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository. This name is not case-sensitive.
The unique identifier of the commit comment.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_COMMIT_OBJECTRetrieves detailed information (including author, committer, message, tree, parents, verification) for a specific commit in a GitHub repository, identified by its SHA.
Input parameters
Name of the repository without the `.git` extension. The name is not case sensitive.
Account owner of the repository. The name is not case sensitive.
SHA identifier of the commit.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_COMMIT_SIGNATURE_PROTECTIONGets the commit signature protection status for a branch in a repository.
Input parameters
The name of the repository, without the `.git` extension. This name is not case sensitive.
The account owner of the repository. This name is not case sensitive.
The name of the branch. This name IS case-sensitive (unlike owner and repo). Wildcard characters are not allowed. To use wildcard characters in branch names, consider using the GraphQL API.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_COMMIT_STATUSESList all statuses for a commit reference (SHA, branch, or tag) in reverse chronological order. Use when you need to check CI/CD status results from various systems for a specific commit.
Input parameters
The commit reference. Can be a commit SHA, branch name (heads/BRANCH_NAME), or tag name (tags/TAG_NAME).
Page number of results to fetch. Default: 1
The name of the repository without the .git extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
Number of results per page, maximum 100. Default: 30
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_COMMUNITY_PROFILE_METRICSRetrieves a repository's community profile metrics, including health percentage and the presence of key community files (e.g., README, LICENSE).
Input parameters
Name of the repository, without '.git' extension. Not case-sensitive.
Username of the account owning the repository. Not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_CONTEXTUAL_INFORMATION_FOR_A_USERGets contextual hovercard information for a GitHub user; `subject_type` and `subject_id` can be jointly provided for more specific details.
Input parameters
GitHub username for whom to retrieve hovercard data.
Entity ID for `subject_type` for more specific hovercard context; required if `subject_type` is also given.
Entity type for more specific hovercard context (e.g., 'repository'); required if `subject_id` is also given.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_CUSTOM_DEPLOYMENT_PROTECTION_RULERetrieves a specific custom deployment protection rule (used by GitHub Apps for external validation or manual approval of deployments) for a given environment in a repository.
Input parameters
The name of the repository without the `.git` extension. This name is not case sensitive.
The account owner of the repository (username or organization name). This name is not case sensitive.
The name of the environment. The name must be URL encoded if it contains special characters (e.g., any slashes `/` must be replaced with `%2F`).
The unique identifier of the custom deployment protection rule. Get this ID from GITHUB_GET_ALL_DEPLOYMENT_PROTECTION_RULES_FOR_AN_ENVIRONMENT action.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_DEFAULT_ATTRIBUTES_FOR_A_CODESPACEGet pre-flight data (e.g., default location, devcontainer path) for creating a Codespace in a given repository (must exist and be accessible), optionally for a specific Git ref.
Input parameters
Git reference (branch name, tag name, or commit SHA) for devcontainer configuration. If omitted, the repository's default branch is used.
Name of the repository, without the `.git` extension (case-insensitive).
Username of the account owning the repository (case-insensitive).
Optional IP address to override default location auto-detection (e.g., for proxied requests). If unspecified, location is inferred from source IP.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_DEFAULT_WORKFLOW_PERMISSIONS_FOR_AN_ORGANIZATIONGets the default GITHUB_TOKEN workflow permissions and settings for a GitHub organization.
Input parameters
The name of the organization. This name is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_DEFAULT_WORKFLOW_PERMISSIONS_FOR_A_REPOSITORYGets the default workflow permissions (`read` or `write`) for the GITHUB_TOKEN and whether it can approve pull request reviews in an existing and accessible repository.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_DEPENDENCY_DIFFGets the dependency diff between two Git revisions in a repository, where 'basehead' specifies the revisions and 'name' can optionally scope to a specific manifest file.
Input parameters
The optional full path, relative to the repository root, of a specific dependency manifest file (e.g., `package-lock.json`, `pom.xml`). If provided, the diff will be scoped to this file.
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
A string specifying the base and head Git revisions to compare, in the format `BASE_REF...HEAD_REF`. `BASE_REF` and `HEAD_REF` can be commit SHAs, branch names, or tags. For example, `main...develop` or `v1.0.0...v1.1.0`.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_DEPLOY_KEYGets a specific deploy key, identified by its `key_id`, for the GitHub repository specified by `owner` and `repo`.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
The unique numerical identifier of the deploy key.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_DEPLOYMENTGets a specific deployment by ID from a repository, provided the repository and deployment ID exist.
Input parameters
The name of the repository, without the '.git' extension. This field is not case-sensitive.
The username of the account that owns the repository. This field is not case-sensitive.
The unique numeric identifier of the deployment to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_DEPLOYMENT_BRANCH_POLICYRetrieves a specific deployment branch policy for an environment in a repository, identified by its unique ID.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository. This name is not case-sensitive.
The unique identifier of the branch policy.
The name of the environment. The name must be URL encoded; for example, replace any slashes in the name with `%2F`.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_DEPLOYMENT_STATUSRetrieves a specific deployment status by its ID for a given deployment within a GitHub repository.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The unique identifier of the deployment status.
The unique identifier of the deployment.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_DETAILS_ABOUT_A_CODESPACE_EXPORTRetrieves detailed information about a specific export of a codespace.
Input parameters
The ID of the export operation. Currently, only 'latest' is supported, which refers to the most recent export for the specified codespace.
The unique name of the codespace.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_DISCUSSIONFetches a specific discussion by its number from a team within an organization. This is a read-only action that retrieves discussion details including title, body, author information, comment count, and reactions. The authenticated user must be a member of the organization to access team discussions.
Input parameters
The organization's name (case-insensitive).
The team's slug (URL-friendly name).
The discussion's unique number within the team.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_DISCUSSION_COMMENTFetches a specific comment from a team discussion within a specific organization.
Input parameters
The name of the organization. This field is not case-sensitive.
The slug of the team name. This is the team name converted to lowercase, with spaces and special characters replaced by hyphens. For example, 'Developer Tools Team' becomes 'developer-tools-team'.
The unique number identifying the comment within the discussion.
The unique number identifying the discussion.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_EMOJISLists all emojis available for use on GitHub, including custom and Unicode emojis.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_ENTERPRISE_MEMBER_INVITATIONTool to look up a pending enterprise unaffiliated member invitation by invitee and enterprise. Use when you need to check the status of a specific invitation.
Input parameters
The login (username) of the user invited to join the enterprise. This is the GitHub username of the invitee.
The slug of the enterprise the user was invited to join. Enterprise slugs are used to identify enterprises in GitHub URLs (e.g., 'acme-corp').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_FEEDSFetches a list of available GitHub feed URLs for the authenticated user.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_GISTFetches a specific GitHub gist by its `gist_id`, returning comprehensive details if the gist exists.
Input parameters
The unique hexadecimal string identifier of the gist, found in its URL.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_GIST_COMMENTRetrieves a specific Gist comment by its ID and the Gist's ID.
Input parameters
The unique alphanumeric identifier of the Gist (found in the Gist URL after gist.github.com/username/).
The unique numeric identifier of the comment. Obtain this from listing gist comments or from the comment URL.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_GIST_REVISIONRetrieves a specific revision of a gist.
Input parameters
The SHA (Secure Hash Algorithm) identifier of a specific gist revision. This is a 40-character hexadecimal string.
The unique identifier of the gist.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_GITHUB_ACTIONS_CACHE_USAGE_FOR_AN_ORGANIZATIONRetrieves total GitHub Actions cache usage statistics for an organization, including active cache count and size across all repositories.
Input parameters
Name of the organization (case-insensitive).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_GITHUB_ACTIONS_CACHE_USAGE_FOR_A_REPOSITORYRetrieves the total count of active GitHub Actions caches and their combined size in bytes for a specified repository.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_GITHUB_ACTIONS_PERMISSIONS_FOR_AN_ORGANIZATIONGets the GitHub Actions permissions for a specified organization, detailing repository enablement and allowed actions policies.
Input parameters
The name of the GitHub organization. This field is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_GITHUB_ACTIONS_PERMISSIONS_FOR_A_REPOSITORYGets the GitHub Actions permissions policy for a repository, including its enabled status and the scope of allowed actions.
Input parameters
The name of the repository, without the `.git` extension. This is not case-sensitive.
The username of the account that owns the repository. This is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_GITHUB_BILLING_PREMIUM_REQUEST_USAGE_REPORT_USERTool to get billing premium request usage report for a GitHub user. Use when you need to retrieve usage data for premium features like Copilot or AI models.
Input parameters
If specified, only return results for a single day. The value of `day` is an integer between `1` and `31`. If no `year` or `month` is specified, the default `year` and `month` are used.
If specified, only return results for a single year. The value of `year` is an integer with four digits representing a year. For example, `2025`. Default value is the current year.
The model name to query usage for. The name is not case sensitive.
If specified, only return results for a single month. The value of `month` is an integer between `1` and `12`. Default value is the current month. If no year is specified the default `year` is used.
The product name to query usage for. The name is not case sensitive.
The handle for the GitHub user account.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_GITHUB_BILLING_USAGE_SUMMARY_FOR_USERTool to retrieve billing usage summary for a GitHub user account. Use when tracking usage costs, monitoring billing details, or generating usage reports for a specific user. Note: This endpoint only returns data for the past 24 months and is currently in public preview.
Input parameters
If specified, only return results for a single day. The value of day is an integer between 1 and 31. If no year or month is specified, the default year and month are used.
The SKU to query for usage.
If specified, only return results for a single year. The value of year is an integer with four digits representing a year (e.g., 2025). Default value is the current year.
If specified, only return results for a single month. The value of month is an integer between 1 and 12. Default value is the current month. If no year is specified the default year is used.
The product name to query usage for. The name is not case sensitive.
The handle for the GitHub user account.
The repository name to query for usage in the format owner/repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_GITHUB_META_INFORMATIONFetches GitHub's publicly available metadata, useful for configuring network security policies or IP allow-listing.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_GITHUB_PAGES_BUILDRetrieves detailed information about a specific GitHub Pages build for a repository, which must have GitHub Pages enabled.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
The unique identifier of the GitHub Pages build to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_GITIGNORE_TEMPLATERetrieves a specific .gitignore template from GitHub by its name, which must be an existing template in GitHub's collection.
Input parameters
The name of the .gitignore template to retrieve (e.g., 'Python', 'Node'). This is case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_GLOBAL_SECURITY_ADVISORYRetrieve a global GitHub security advisory by its GHSA identifier. Use this to get detailed information about vulnerabilities including severity, affected packages, CVSS scores, and references.
Input parameters
The GHSA (GitHub Security Advisory) identifier of the advisory.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_GRAPHQL_NODETool to fetch any GitHub object by its global node ID. Use when you have a node_id and need to retrieve the corresponding object details.
Input parameters
The global node ID of the object to fetch. This is the GraphQL global identifier (node_id) returned by GitHub's API, not the numeric ID.
Optional GraphQL fragment to specify which fields to retrieve from the returned node. Use GraphQL inline fragment syntax (e.g., '... on User { login name }'). If omitted, only the 'id' field will be returned.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_GRAPHQL_RATE_LIMITTool to retrieve the authenticated client's GitHub GraphQL API rate limit information. Use when you need to check remaining quota, current usage, or reset time for GraphQL requests.
Input parameters
If true, calculate the cost for the query without evaluating it. Use this to estimate query costs without consuming actual quota.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_INFORMATION_ABOUT_A_SARIF_UPLOADRetrieves detailed information, including processing status and results URL, about a specific SARIF (Static Analysis Results Interchange Format) upload for a repository, uniquely identified by its sarif_id.
Input parameters
Name of the repository, without the `.git` extension (not case-sensitive).
Username of the account that owns the repository (not case-sensitive).
Unique identifier of the SARIF upload, returned when a SARIF file is successfully uploaded.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_INTERACTION_RESTRICTIONS_FOR_AN_ORGANIZATIONRetrieves interaction restrictions for an organization, showing which GitHub user types can interact with its public repositories and when restrictions expire; returns an empty response if no restrictions are set.
Input parameters
The name of the organization. This name is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_INTERACTION_RESTRICTIONS_FOR_A_REPOSITORYRetrieves active interaction restrictions for a repository, detailing which user groups are limited from activities like commenting or creating pull requests, and when these restrictions expire.
Input parameters
The name of the repository, without the `.git` extension. This is case-insensitive.
The username of the account that owns the repository. This is case-insensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_INTERACTION_RESTRICTIONS_FOR_PUBLIC_REPOSRetrieves currently active interaction restrictions for the authenticated user's public repositories.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_LABELRetrieves a specific label by its name from a specified GitHub repository.
Input parameters
The name of the label to retrieve. GitHub's API treats label names as case-insensitive for this operation.
The name of the repository, without the `.git` extension. The name is not case-sensitive.
The account owner of the repository (e.g., a username or organization name). The name is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_LARGE_FILESLists files larger than 100MB identified during a previous source import for the specified repository. NOTE: This endpoint has been deprecated by GitHub as of April 12, 2024, and is no longer available. The Source Imports REST API has been retired due to very low usage levels. Please use the GitHub Importer tool at https://github.com/new/import for repository imports.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_LATEST_PAGES_BUILDRetrieves information about the most recent GitHub Pages build for a repository, which must exist, be accessible, have GitHub Pages enabled, and have at least one prior build.
Input parameters
The name of the repository, without the '.git' extension. This name is not case-sensitive.
The username of the account or the name of the organization that owns the repository. This name is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_LICENSECall this action to retrieve comprehensive details for a specific software license recognized by GitHub, using its unique license key.
Input parameters
The unique identifier (key) of the license. This is typically the SPDX license identifier (e.g., 'mit', 'apache-2.0').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_LICENSE_GRAPH_QLTool to look up an open source license by its SPDX ID using GitHub's GraphQL API. Use when you need to fetch license details for compliance tracking or repository setup.
Input parameters
The license's downcased SPDX ID. Common keys include 'mit', 'apache-2.0', 'gpl-3.0', 'bsd-3-clause', 'lgpl-3.0', 'mpl-2.0', 'agpl-3.0', 'unlicense', 'isc', 'bsd-2-clause'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_OCTOCATFetches an ASCII art representation of GitHub's Octocat, suitable for text-based displays.
Input parameters
Custom message for Octocat's speech bubble. If omitted or empty, a random 'Zen of GitHub' message will be displayed instead.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_OIDC_SUBJECT_CLAIM_TEMPLATERetrieves the OpenID Connect (OIDC) subject claim customization template for a repository, which defines the `sub` claim structure in OIDC tokens for GitHub Actions workflows; returns the default configuration if no customization is applied.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_ORG_ALLOWED_ACTIONSGets the list of allowed actions and reusable workflows for an organization when the 'allowed_actions' policy is set to 'selected'.
Input parameters
The unique identifier or name of the organization. This field is not case sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_ORGANIZATION_AUDIT_LOGTool to retrieve an organization's audit log events for security and compliance investigations. Use when tracking organizational changes, security audits, or compliance monitoring. Requires organization owner permissions and read:audit_log scope.
Input parameters
The organization name. The name is not case sensitive.
A cursor for pagination. Returns events after this cursor. Use the cursor from the response to fetch the next page.
The order of audit log events. Can be 'asc' (ascending, oldest first) or 'desc' (descending, newest first). Defaults to 'desc'.
A cursor for pagination. Returns events before this cursor. Use the cursor from the response to fetch the previous page.
A search phrase to filter audit log events. For example, 'action:org' for organization-related events, or 'actor:octocat' for events by a specific user.
The event types to include. Can be 'web' (web interface events), 'git' (Git events), or 'all'. Defaults to 'web'.
The number of results per page (max 100). Defaults to 30.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_ORGANIZATION_CUSTOM_PROPERTYRetrieves the definition (schema) of a specific, existing custom property for an organization.
Input parameters
Organization's login name (not case-sensitive).
Name of the custom property to retrieve (case-sensitive).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_ORGANIZATION_PROJECT_ITEMTool to get an item from an organization-owned GitHub Projects V2 project. Use when you need to retrieve details about a specific project item including its content, fields, timestamps, and creator information.
Input parameters
The organization name. The name is not case sensitive.
Limit results to specific fields, by their IDs. If not specified, the title field will be returned. Format: fields\[\]=123&fields\[\]=456 or fields=123,456,789
The unique identifier of the project item.
The project's number.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_ORGANIZATION_PUBLIC_KEYRetrieves an organization's public key, which must be used to encrypt secret values before they are configured for Codespaces.
Input parameters
The name of the GitHub organization. This field is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_ORGANIZATION_PUBLIC_KEY_FOR_DEPENDABOTRetrieves the public key for an existing GitHub organization, required for encrypting Dependabot secrets. Requires admin:org scope.
Input parameters
The name of the GitHub organization. Requires admin:org scope (must be an organization admin). This field is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_ORG_DEV_ENVIRONMENT_SECRET_SAFELYRetrieves metadata for a specific secret available to an organization's GitHub Codespaces without exposing its encrypted value.
Input parameters
The organization name (login). The name is not case-sensitive.
The name of the development environment secret to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_ORG_OIDC_SUBJECT_CLAIM_TEMPLATERetrieves the OpenID Connect (OIDC) subject claim customization template for a GitHub organization, which defines how the `sub` claim in OIDC tokens for workflows is constructed.
Input parameters
The name of the GitHub organization (case-insensitive). This is the organization's login/username, not a numeric ID.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_PAGES_DNS_HEALTH_CHECKRetrieves the DNS health check status (e.g., CNAME/A records, HTTPS) for a GitHub Pages site; the check may be pending (HTTP 202) on initial calls or after site changes.
Input parameters
The name of the repository, without the `.git` extension. This field is not case sensitive.
The username or organization name that owns the repository. This field is not case sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_PAGES_SITERetrieves information for a GitHub Pages site, which must be enabled for the repository.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_PAGE_VIEWSRetrieves page view statistics for a repository over the last 14 days, including total views, unique visitors, and a daily or weekly breakdown.
Input parameters
The time unit for which to aggregate page views.
The name of the repository, without the `.git` extension. This field is case-insensitive.
The username of the account that owns the repository. This field is case-insensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_PENDING_DEPLOYMENTS_FOR_A_WORKFLOW_RUNRetrieves pending deployment environments for a specific workflow run that are awaiting approval due to protection rules.
Input parameters
Name of the repository, without the `.git` extension; not case-sensitive.
Account owner of the repository (user or organization); not case-sensitive.
Unique numerical identifier of the workflow run.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_PROJECT_PERMISSION_FOR_A_USERRetrieves permission information for a GitHub project (classic) collaborator. Returns the permission level and full user object for a collaborator on a GitHub project (classic). The permission returned can be admin, write, read, or none.
Input parameters
The GitHub username of the project owner or the user whose permission is being checked.
The unique identifier (number) of the project.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_PUBLIC_KEY_FOR_SECRET_ENCRYPTIONRetrieves a repository's public key for encrypting GitHub Codespaces secrets; requires `repo` scope or equivalent read access to codespaces secrets for private repositories.
Input parameters
Repository name, without the `.git` extension (not case-sensitive).
Username or organization name of the repository owner (not case-sensitive).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_PUBLIC_KEY_FOR_THE_AUTHENTICATED_USERRetrieves the authenticated user's public key for encrypting GitHub Codespaces secrets. The returned key must be used with libsodium sealed box encryption before creating or updating secrets via the API.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_PULL_REQUEST_REVIEW_PROTECTIONRetrieves the pull request review protection settings for a specific branch in a GitHub repository, if such protection is configured.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive. For example, in 'octocat/Hello-World', 'Hello-World' is the repository name.
The account owner of the repository. This name is not case-sensitive. For example, in 'octocat/Hello-World', 'octocat' is the owner.
The name of the branch. Wildcard characters are not allowed. To use wildcard characters in branch names, refer to the GitHub GraphQL API.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_RATE_LIMIT_STATUS_FOR_THE_AUTHENTICATED_USERRetrieves the authenticated user's current GitHub API rate limit status, including usage and limits across different resource categories.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_RAW_REPOSITORY_CONTENTTool to fetch raw file content from a GitHub repository. Returns raw bytes in whatever format the file uses (JSON, CSV, binary, etc.) — parsing and validation are the caller's responsibility. Ensure owner, repo, ref, and path are consistent when combining with other GitHub tools to avoid mismatched-ref errors.
Input parameters
The branch name, tag name, or commit SHA to fetch the file from. Defaults to the repository's default branch (usually 'main' or 'master'). Recommended to pass explicitly — omitting it fetches from the default branch, which may not match the ref used in other tool calls and can yield unexpected or missing content.
The file path within the repository, relative to the repository root. Use forward slashes for directory separators (e.g., 'src/utils/helper.js'). Do not include leading slash. Do NOT pass a full GitHub URL - only the relative path within the repo. Must exactly match the file path as it exists in the repository — use GITHUB_GET_A_TREE to discover valid paths rather than guessing directory structure.
The repository name (not the full URL). This is the repository name shown in the repository URL (e.g., for github.com/torvalds/linux, the repo is 'linux'). Do not include '.git' suffix. Case-insensitive.
The GitHub username or organization name that owns the repository. This is the account name shown in the repository URL (e.g., for github.com/torvalds/linux, the owner is 'torvalds'). Case-insensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_REPO_ALLOWED_ACTIONSGets the settings for allowed actions and reusable workflows in a repository. Requires the repository's `allowed_actions` policy to be set to `selected` (returns 409 if set to `all` or `local_only`).
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_REPO_DEV_ENV_SECRETGets metadata (name, creation/update timestamps) for a specific, existing development environment secret (Codespaces secret) in a repository, without exposing its value.
Input parameters
The name of the repository, without the `.git` extension. This field is case-insensitive.
The username or organization name that owns the repository. This field is case-insensitive.
The name of the development environment secret to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_REPOS_ATTESTATIONSTool to retrieve attestations by subject digest from a GitHub repository. Use when you need to verify or check attestations for a specific artifact identified by its SHA256 digest.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API".
The account owner of the repository. The name is not case sensitive.
A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API".
The number of results per page (max 100). For more information, see "Using pagination in the REST API".
Optional filter for fetching attestations with a given predicate type. This option accepts `provenance`, `sbom`, `release`, or freeform text for custom predicate types.
The parameter should be set to the attestation's subject's SHA256 digest, in the form `sha256:HEX_DIGEST`.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_REPOSITORY_CLONESRetrieves the total number of clones and a breakdown of clone activity (daily or weekly) for a specified repository over the preceding 14 days.
Input parameters
Specifies the time frame for aggregating clone data: `day` for daily clone counts, or `week` for weekly clone counts (a week starts on Monday).
The name of the repository, without the '.git' extension. This field is not case-sensitive.
The username of the account that owns the repository. This field is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_REPOSITORY_CONTENTRetrieves a file's Base64 encoded content or lists a directory's contents from a GitHub repository.
Input parameters
The name of the commit, branch, or tag to read from. Use this parameter to specify which branch (e.g., 'feat/godlocal-dev', 'main', 'develop'), tag (e.g., 'v1.2.0'), or commit SHA you want to access. If not provided, the repository's default branch will be used. Note: Branch names should be passed here, NOT in the path parameter.
Required. Path to file or directory in the repository. Empty string ('') retrieves root directory contents. Leading slashes auto-stripped. CRITICAL: Do NOT pass branch names here (e.g., 'feat/godlocal-dev', 'main'). Branch names belong in the `ref` parameter. Path should be file/directory path only (e.g., 'src/main.js', 'README.md'), NOT prefixed with branch name (use 'src/main.js' not 'main/src/main.js'). File paths must include extension (e.g., 'README.md', not 'README'). For common files (README, LICENSE, CHANGELOG) without extensions, action auto-tries common extensions (.md, .txt, .rst). Paths are case-sensitive. On 404 errors, list parent directory to verify exact path/casing.
Required. The name of the repository, without the `.git` extension. This name is not case sensitive.
Required. The account owner of the repository. This name is not case sensitive. Can also accept full repository path in format 'owner/repo' - the repo part will be extracted automatically.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_REPOSITORY_GRAPH_QLTool to lookup a repository by owner and name using GitHub's GraphQL API. Use when you need comprehensive repository information.
Input parameters
The name of the repository.
The login field of a user or organization that owns the repository.
Follow repository renames. If true, the query will follow repository renames to find the current repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_REPOSITORY_OWNERTool to lookup a repository owner (User or Organization) by login using GitHub's GraphQL API. Use when you need to determine whether a login is a user or organization and retrieve basic profile information.
Input parameters
The username or organization name to lookup. This is case-sensitive and must match the exact GitHub login.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_REPOSITORY_PERMISSIONS_FOR_A_USERRetrieves a specific user's permission level ('admin', 'write', 'read', or 'none') for a given repository, where 'maintain' role is reported as 'write' and 'triage' as 'read'.
Input parameters
Name of the repository, without the `.git` extension (case-insensitive).
Account owner of the repository (case-insensitive).
GitHub user's handle (case-insensitive).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_REPOSITORY_PUBLIC_KEY_FOR_ENCRYPTIONGets a repository's public key, used to encrypt secrets for Dependabot.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_REPOSITORY_SECRET_SECURELYRetrieves metadata for an existing Dependabot secret in a repository, without exposing its encrypted value.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
The name of the Dependabot secret to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_REPOSITORY_SECURITY_ADVISORYTool to retrieve a repository security advisory using its GHSA identifier. Use when you need detailed information about a specific security vulnerability.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The GHSA (GitHub Security Advisory) identifier of the advisory.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_REPOSITORY_WEBHOOK_DELIVERYRetrieves a specific delivery for a repository webhook, identified by its `hook_id` and `delivery_id`.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The unique identifier of the webhook. You can find this value in the `X-GitHub-Hook-ID` header of a webhook delivery, or by listing repository webhooks.
The unique identifier of a specific delivery for the webhook. This ID corresponds to a single delivery attempt. You can find this by listing webhook deliveries.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_RULES_FOR_A_BRANCHRetrieves all active rules for a specific branch in a GitHub repository, excluding rules in 'evaluate' or 'disabled' status.
Input parameters
Page number of results to fetch.
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The GitHub account owner of the repository. This name is not case-sensitive.
The name of the branch. Wildcard characters are not supported for this parameter; to use wildcards, refer to the GitHub GraphQL API.
Number of results per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_SINGLE_ORG_SECRET_WITHOUT_DECRYPTIONGets a single organization Dependabot secret's metadata (name, timestamps, visibility) without revealing its encrypted value. Requires admin:org scope.
Input parameters
The name of the GitHub organization (case-insensitive).
The name of the Dependabot secret to retrieve (case-insensitive).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_STATUS_CHECKS_PROTECTIONRetrieves the status check protection settings for a specific branch in a GitHub repository, if status check protection is enabled for it.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The account owner of the repository (e.g., a GitHub username or organization name). This field is not case-sensitive.
The name of the branch. Wildcard characters are not supported in branch names for this endpoint; for wildcard support, please refer to the GitHub GraphQL API.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_TEAM_MEMBERSHIP_FOR_A_USERRetrieves a user's role and membership status within a specific team in an organization. Returns membership details including role ('member' or 'maintainer') and state ('active' or 'pending'). If the user is not a member of the team, returns is_member=False with a descriptive message. Requires the authenticated user to be an organization member with visibility into the team.
Input parameters
The name of the GitHub organization. This field is not case-sensitive.
The GitHub username of the user.
The URL-friendly version of the team name (slug).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_TEAMS_WITH_ACCESS_TO_THE_PROTECTED_BRANCHLists teams with explicit push access to a protected branch, provided team restrictions are configured in the branch's protection settings; returns an empty list otherwise.
Input parameters
Repository name, without the `.git` extension; not case-sensitive.
Username of the repository owner; not case-sensitive.
Name of the branch; does not support wildcard characters (for wildcard support, use the GraphQL API).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_THE_AUTHENTICATED_USERGets the profile information for the currently authenticated GitHub user, including potentially private details based on user settings.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_THE_COMBINED_STATUS_FOR_A_SPECIFIC_REFERENCERetrieves the aggregated commit status (e.g., success, failure, pending) from all checks for a specific reference (SHA, branch, or tag) in a GitHub repository.
Input parameters
The specific commit reference to query. This can be a commit SHA, a branch name (e.g., `heads/main`), or a tag name (e.g., `tags/v1.0.0`). See "\[Git References\](https://git-scm.com/book/en/v2/Git-Internals-Git-References)" for more details.
The page number for the results to retrieve. See "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)" for more information.
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
The number of results to display per page, with a maximum of 100. Details on pagination can be found in "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_THE_HOURLY_COMMIT_COUNT_FOR_EACH_DAYRetrieves the 'punch card' data, showing hourly commit counts for each day of the week for an existing and accessible repository.
Input parameters
The name of the repository, without the `.git` extension. The name is not case sensitive.
The account owner of the repository. This is typically the username or organization name. The name is not case sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_THE_LAST_YEAR_OF_COMMIT_ACTIVITYFetches weekly commit totals and daily commit counts for the last 52 weeks for a specified GitHub repository.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_THE_LATEST_RELEASEFetches the latest official (non-prerelease, non-draft) release for a GitHub repository; requires at least one such published release.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The account owner of the repository (e.g., a GitHub username or organization name). This field is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_THE_LICENSE_FOR_A_REPOSITORYRetrieves the license file and its details for a repository, optionally from a specific Git reference (branch, tag, or commit SHA).
Input parameters
The specific Git reference (branch name, tag name, or commit SHA) to retrieve the license from. For a branch, it can be formatted as `refs/heads/<branch_name>` or simply `<branch_name>`. To reference a pull request's merge commit, use `refs/pull/<pull_number>/merge`. If omitted, the license from the repository's default branch is used.
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The account owner of the repository (username or organization name). This field is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_THE_REVIEW_HISTORY_FOR_A_WORKFLOW_RUNRetrieves the detailed approval history for a specific workflow run in a GitHub repository, detailing each review's environment, state, reviewer, and comments, to track the approval process for workflows, particularly automated deployments.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The username of the account or the name of the organization that owns the repository. This name is not case-sensitive.
The unique identifier of the workflow run for which to retrieve the review history.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_THE_STATUS_OF_A_GITHUB_PAGES_DEPLOYMENTRetrieves the status of a specific GitHub Pages deployment for a repository, which must have GitHub Pages enabled.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The account owner of the repository (username or organization name). This field is not case-sensitive.
The unique identifier of the GitHub Pages deployment. This can be the numeric ID of the deployment or the commit SHA that triggered the deployment.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_THE_WEEKLY_COMMIT_ACTIVITYFetches the weekly commit activity (additions and deletions per week) for a repository over the past year; best for repositories with under 10,000 commits.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository (e.g., a user or organization). This name is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_THE_WEEKLY_COMMIT_COUNTRetrieves the weekly commit count for a repository, detailing commits by the owner and all contributors over the last 52 weeks; GitHub may return a 202 status or an empty response if statistics are being computed.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository. This name is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_THE_ZEN_OF_GITHUBRetrieves a random quote from GitHub's 'Zen of GitHub' collection, reflecting GitHub's design philosophies and offering humorous insights, useful for displaying GitHub wisdom or a lighthearted message.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_TOP_REFERRAL_PATHSFetches the top 10 most viewed content paths for a repository from the last 14 days.
Input parameters
Repository name, without the `.git` extension (not case-sensitive).
Username of the account or organization owning the repository (not case-sensitive).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_TOP_REFERRAL_SOURCESFetches the top 10 websites that referred traffic to a repository within the last 14 days.
Input parameters
The name of the repository, without the `.git` extension. This field is case-insensitive.
The username or organization name that owns the repository. This field is case-insensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_USER_BY_IDRetrieves a GitHub user's profile information by their unique numeric account ID. Use when you know the user's numeric ID rather than their username.
Input parameters
The unique numeric identifier of the GitHub user account to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_USER_PROJECT_ITEMTool to get an item from a user-owned project in GitHub Projects V2. Use when you need to retrieve details about a specific item (issue, pull request, or draft issue) in a user's project board.
Input parameters
Limit results to specific fields, by their IDs. If not specified, the title field will be returned. Example: fields\[\]=123&fields\[\]=456&fields\[\]=789 or fields=123,456,789
The unique identifier of the project item.
The handle for the GitHub user account.
The project's number.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_USERS_ATTESTATIONSTool to get attestations by subject digest for a GitHub user. Use when you need to retrieve attestation data for a specific artifact or resource identified by its subject digest.
Input parameters
A cursor, as given in the Link header. If specified, the query only searches for results after this cursor.
A cursor, as given in the Link header. If specified, the query only searches for results before this cursor.
The number of results per page (max 100). For more information, see 'Using pagination in the REST API'.
The handle for the GitHub user account.
Optional filter for fetching attestations with a given predicate type. This option accepts 'provenance', 'sbom', 'release', or freeform text for custom predicate types.
Subject digest for the attestation. Must include the algorithm prefix (e.g., 'sha256:' or 'sha512:').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_USERS_PROJECTS_V2Tool to list GitHub Projects v2 for a specified user. Use when you need to retrieve all projects owned by a user with pagination support.
Input parameters
Limit results to projects of the specified type.
A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see 'Using pagination in the REST API'.
A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see 'Using pagination in the REST API'.
The number of results per page (max 100). For more information, see 'Using pagination in the REST API'.
The handle for the GitHub user account.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_USERS_WITH_ACCESS_TO_THE_PROTECTED_BRANCHLists users with explicit push access to a protected branch, provided its protection rule restricts pushes to specific users.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository (e.g., user or organization). This name is not case-sensitive.
The name of the protected branch. Wildcard characters are not supported. To use wildcard characters in branch names, refer to the GitHub GraphQL API.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_VIEWER_GRAPHQLTool to retrieve the authenticated user's profile information via GitHub GraphQL. Use when working with GraphQL queries or need viewer details in GraphQL format.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_WORKFLOW_EXTERNAL_ACCESSGets the access level settings for a private repository, determining how workflows outside this repository can use its actions and reusable workflows.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository. This name is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_WORKFLOW_RUN_JOBRetrieves detailed information for a specific job within a GitHub Actions workflow run, given its `job_id` which must be valid for the specified repository's workflow.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
The unique numerical identifier of the job to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_WORKFLOW_RUN_USAGEGets the billable time, in milliseconds, for a specific workflow run, detailing time spent on various operating systems.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
Account owner of the repository (username or organization name); not case sensitive.
Unique identifier of the workflow run.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_GET_WORKFLOW_USAGEGets the billable time (in milliseconds, broken down by runner OS) for a specific workflow within a repository for the current billing cycle.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
The unique identifier (ID) of the workflow or the workflow's file name (e.g., 'main.yml').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_IS_REPOSITORY_STARRED_BY_THE_USERUse to determine if the authenticated user has starred a specific GitHub repository, which is confirmed by an HTTP 204 status (resulting in an empty dictionary in the response data); the action fails (e.g., HTTP 404) if the repository is not starred or does not exist.
Input parameters
The name of the repository, without the `.git` extension. This name is not case sensitive.
The account owner of the repository (e.g., a user or organization). This name is not case sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ACCEPTED_ASSIGNMENTS_FOR_AN_ASSIGNMENTLists accepted assignments (student repositories created after acceptance) for an existing GitHub Classroom assignment, identified by its unique `assignment_id`.
Input parameters
Page number of the results to retrieve.
Number of results to return per page (maximum 100).
The unique identifier of the classroom assignment for which to list accepted assignments.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ACCESSIBLE_REPOSITORIESLists repositories that the authenticated user can access through a specific GitHub App installation. Returns repositories where the user has explicit :read, :write, or :admin permission through the installation. The response includes permission details for each repository. Prerequisites: - Requires a GitHub App user access token (not a standard OAuth token) - Use GITHUB_LIST_APP_INSTALLATIONS first to get valid installation IDs
Input parameters
Page number of the results to fetch, starting from 1.
Number of repositories to return per page. Maximum is 100.
The unique identifier of the GitHub App installation. Get this from GITHUB_LIST_APP_INSTALLATIONS.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_APP_INSTALLATIONSLists GitHub App installations accessible to the authenticated user via their access token, including installation details, permissions, and repository access.
Input parameters
Page number of results to retrieve.
Number of results per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_APPS_WITH_ACCESS_TO_THE_PROTECTED_BRANCHLists GitHub Apps with push access to a repository's protected branch.
Input parameters
The name of the repository, without the '.git' extension. This field is not case-sensitive.
The username of the account that owns the repository. This field is not case-sensitive.
The name of the protected branch. This name cannot contain wildcard characters. To work with branch names containing wildcard characters, please use the GitHub GraphQL API.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ARTIFACTS_FOR_A_REPOSITORYLists GitHub Actions workflow artifacts for a specified repository, which must exist.
Input parameters
The name of an artifact. If specified, only artifacts with this exact name will be returned. If omitted or null, all artifacts in the repository are listed (subject to pagination).
The page number of the results to fetch, starting from 1.
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The account owner of the repository (username or organization name). This field is not case-sensitive.
The number of artifacts to return per page; maximum is 100.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ASSIGNEESLists users who can be assigned to issues in a repository, typically those with push access.
Input parameters
Page number of results (1-indexed).
The name of the repository, without the `.git` extension. This is not case-sensitive.
The username of the account that owns the repository. This is not case-sensitive.
Number of results per page. Max 100.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ASSIGNMENTS_FOR_A_CLASSROOMLists all assignments for a given GitHub Classroom `classroom_id`; the classroom must exist and be accessible.
Input parameters
Specifies the page number of the results to retrieve. For more information, refer to GitHub's documentation on \[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).
Specifies the number of results to return per page (maximum is 100). For more information, refer to GitHub's documentation on \[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).
The unique identifier of the classroom for which assignments are to be listed.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ATTESTATION_REPOSITORIESTool to list attestation repositories for an organization. Use when you need to discover which repositories in an organization have attestations. Attestations provide verifiable metadata about software artifacts.
Input parameters
The organization name. The name is not case sensitive.
A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see 'Using pagination in the REST API'.
A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see 'Using pagination in the REST API'.
The number of results per page (max 100). For more information, see 'Using pagination in the REST API'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_AVAILABLE_MACHINE_TYPES_FOR_A_REPOSITORYLists machine types available for GitHub Codespaces in a repository, optionally using a Git ref to check compatibility based on prebuild availability and devcontainer configurations.
Input parameters
The Git reference (branch name, tag name, or commit SHA) to check for prebuild availability and devcontainer configuration restrictions. This ensures listed machine types are compatible with the specified repository version.
The name of the repository, without the `.git` extension. The name is not case sensitive.
The account owner of the repository. This is typically the username (for personal repositories) or the organization name (for organization-owned repositories). The name is not case sensitive.
The geographic location to check for available machine types. If not provided, the location may be inferred. Specifying a location can help find machines in a preferred region.
An IP address used for auto-detecting the location if `location` is not specified. This is particularly useful when requests are proxied, to ensure location-based machine availability is accurate.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_BRANCHESLists branches for an existing GitHub repository, with an option to filter by protection status.
Input parameters
Page number for paginated results.
Repository name, excluding `.git` extension (case-insensitive).
Account owner's username (case-insensitive).
Number of results per page (max 100).
Filter by protection status: `true` for protected, `false` for unprotected; omit for all branches.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_BRANCHES_FOR_HEAD_COMMITLists branches in an accessible repository where the provided commit SHA is the head, useful for identifying development lines based on that commit.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository (e.g., a user or organization). This name is not case-sensitive.
The full SHA-1 hash of the commit. This action will find branches where this commit is the most recent one (the head).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_CHECK_RUN_ANNOTATIONSLists annotations for a specific check run in a GitHub repository, detailing issues like errors or warnings on particular code lines.
Input parameters
The page number of the results to fetch. See "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)" for more details.
The name of the repository, without the `.git` extension. The name is not case sensitive.
The account owner of the repository. This is typically the username or organization name. The name is not case sensitive.
The number of results per page (maximum 100). See "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)" for more details.
The unique identifier of the check run for which annotations are to be listed.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_CHECK_RUNS_FOR_A_REFList GitHub check runs for a commit SHA, branch, or tag to assess CI status and conclusions. Use when you need reliable CI pass/fail signals beyond commit metadata.
Input parameters
The git reference - can be a commit SHA, branch name, or tag name.
Page number of results to fetch.
The name of the repository without .git extension. Case-insensitive.
The account owner of the repository (username or organization name). Case-insensitive.
Filter by GitHub App identifier.
Filter by completion timestamp: 'latest' returns the most recent check runs, 'all' returns all check runs.
Filter by check run status: queued, in_progress, or completed.
Number of results per page, maximum 100.
Filters results to check runs with the specified name.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_CHECK_RUNS_IN_A_CHECK_SUITELists check runs for a specific check suite in a GitHub repository, optionally filtering by check name or status.
Input parameters
Page number of results to fetch (starts at 1).
Repository name, without the `.git` extension (case-insensitive).
Username or organization name of the repository owner (case-insensitive).
Filter by `completed_at` timestamp: 'latest' for most recent, 'all' for all check runs.
Filter check runs by status; returns all statuses if omitted.
Number of check runs per page (max 100).
Filter check runs by this name; returns all names if omitted.
Numeric ID of the check suite.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_CHECK_SUITES_FOR_A_GIT_REFERENCELists check suites for a Git reference (commit SHA, branch, or tag) in a repository, optionally filtering by GitHub App ID or check run name.
Input parameters
Git reference (commit SHA, branch name like `heads/BRANCH_NAME` or `BRANCH_NAME`, or tag name like `tags/TAG_NAME` or `TAG_NAME`) to list check suites for.
Page number of results to fetch (1-indexed).
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository (username or organization name). This name is not case-sensitive.
Filters check suites by the `id` of the GitHub App that created them. If omitted, check suites from all apps are returned.
Number of results per page (max 100).
Filters check suites by the name of a check run. Only check suites that contain at least one check run with this name will be returned. If omitted, check suites are not filtered by check run name.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_CHILD_TEAMSLists the immediate child teams of a parent team within an organization.
Input parameters
The organization name (not case-sensitive).
Page number of the results to retrieve.
Number of results per page (maximum 100).
The slug (URL-friendly version) of the parent team's name.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_CLASSROOMSLists GitHub Classrooms to which the authenticated user has administrative access.
Input parameters
Page number for the results.
Number of results per page (maximum 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_CODEOWNERS_ERRORSLists syntax errors in a repository's CODEOWNERS file, which must be located at the root, `.github/`, or `docs/` directory for the specified ref.
Input parameters
Branch name, tag, or commit SHA for the CODEOWNERS file; defaults to the repository's default branch if unspecified.
Name of the repository, without the `.git` extension (not case-sensitive).
Username of the account owning the repository (not case-sensitive).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_CODEQL_DATABASES_FOR_A_REPOSITORYLists all CodeQL databases for a repository where CodeQL analysis has been previously run and completed.
Input parameters
Name of the repository, without the `.git` extension (not case-sensitive).
Username of the account owning the repository (not case-sensitive).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_CODE_SCANNING_ALERTS_FOR_AN_ORGANIZATIONLists code scanning alerts for a GitHub organization; use EITHER `tool_name` OR `tool_guid` if filtering by tool, not both.
Input parameters
The GitHub organization name (case-insensitive).
Page number for results. Used if `before` or `after` cursors are not provided.
Sort field.
A pagination cursor to retrieve results appearing after this.
Filter alerts by state.
A pagination cursor to retrieve results appearing before this.
Number of results per page (maximum 100).
Filter alerts by severity.
Sort direction.
GUID of the code scanning tool. Some tools may not report a GUID. Cannot be used with `tool_name`.
Name of the code scanning tool (e.g., 'CodeQL'). Cannot be used with `tool_guid`.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_CODE_SCANNING_ALERTS_FOR_A_REPOSITORYLists code scanning alerts for a repository, optionally filtering by tool (which must have produced scan results for the repository), Git reference, state, or severity.
Input parameters
Git reference (branch, tag, or pull request merge reference, e.g., `refs/pull/42/merge`) for retrieving alerts; defaults to the repository's default branch if unspecified.
Page number for paginated results, starting at 1.
The name of the repository, without the `.git` extension; not case-sensitive.
Sort property: `created` (alert creation time) or `updated` (last update time).
The account owner of the repository (username or organization name); not case-sensitive.
Filters alerts by state.
Number of results per page (max 100).
Filters alerts by severity.
Sort direction: `asc` (ascending) or `desc` (descending).
The GUID of a code scanning tool to filter alerts by; use either `tool_guid` or `tool_name`, not both. Some tools may not provide a GUID.
The name of a code scanning tool to filter alerts by; use either `tool_name` or `tool_guid`, not both.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_CODE_SCANNING_ANALYSES_FOR_A_REPOSITORYLists code scanning analyses for an existing repository, optionally filtering by tool (name or GUID), Git reference, or SARIF ID.
Input parameters
The Git reference for which to list analyses. This can be a branch name (e.g., 'main' or 'refs/heads/main') or a pull request merge reference (e.g., 'refs/pull/123/merge').
Page number of the results to retrieve.
The name of the repository, without the `.git` extension. This name is not case-sensitive.
Property by which to sort the results. Currently, only 'created' is a supported sort field.
The account owner of the repository. This name is not case-sensitive.
Number of results to return per page (maximum 100).
Filter analyses to those associated with a specific SARIF upload ID.
Direction to sort results. 'asc' for ascending, 'desc' for descending.
The GUID of a code scanning tool used to filter analyses. Only results from this tool will be listed. Some tools may not provide a GUID. Mutually exclusive with `tool_name`.
The name of a code scanning tool used to filter analyses. Only results from this tool will be listed. Mutually exclusive with `tool_guid`.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_CODES_OF_CONDUCTRetrieves all available codes of conduct from GitHub, often used to select one for a repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_CODES_OF_CONDUCT_GRAPHQLTool to fetch all available codes of conduct using GitHub's GraphQL API. Use when you need to retrieve the complete list of codes of conduct that can be applied to repositories.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_CODESPACES_FOR_A_USER_IN_ORGANIZATIONLists all GitHub Codespaces owned by a specified member of a given organization.
Input parameters
Name of the GitHub organization (case-insensitive).
Page number of the results to retrieve (starts from 1).
Number of codespaces to return per page (maximum 100).
GitHub username of the organization member.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_CODESPACES_FOR_THE_AUTHENTICATED_USERLists GitHub Codespaces for the authenticated user, optionally filtering by repository ID and supporting pagination.
Input parameters
Page number for results (starts at 1). For pagination details, see: https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api.
Number of codespaces per page (max 100). For pagination details, see: https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api.
If provided, filters codespaces to this repository ID.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_CODESPACES_FOR_THE_ORGANIZATIONLists active/pending GitHub Codespaces for an existing organization; admins list all, members list their own.
Input parameters
Non-case-sensitive unique identifier of the GitHub organization.
Page number of results. Details: '\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)'.
Number of results per page (max 100). Details: '\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_COMMENT_CHANGESTool to list issue and PR comment changes across an organization's repositories efficiently. Use when monitoring comment activity without per-PR/per-issue polling. Filters organization events to return only comment-related events (IssueCommentEvent, PullRequestReviewCommentEvent, CommitCommentEvent). Note: Events are limited to the past 30 days and up to 300 events per timeline. Use ETag header for efficient polling to avoid rate limits.
Input parameters
Organization name to list comment events for. Not case-sensitive.
Page number of results to fetch.
Number of events to return per page (maximum 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_COMMENTS_FOR_A_PULL_REQUEST_REVIEWLists all comments for a specific review on a GitHub pull request.
Input parameters
Page number of the results to fetch. See GitHub's \[pagination guide\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
Number of comments to retrieve per page (max 100). See GitHub's \[pagination guide\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).
The unique identifier of the pull request review.
The unique number that identifies the pull request within the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_COMMIT_COMMENTSRetrieves all comments for a specific commit in a GitHub repository, supporting pagination.
Input parameters
The page number of the results to retrieve. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository. This name is not case-sensitive.
The number of comments to return per page. Maximum value is 100. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The SHA hash of the commit for which comments are to be listed.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_COMMIT_COMMENTS_FOR_A_REPOSITORYLists all commit comments for a specified repository, which must exist and be accessible.
Input parameters
Page number of the results to fetch (starts at 1).
The name of the repository, without the `.git` extension (not case-sensitive).
The account owner of the repository (not case-sensitive).
Number of results to return per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_COMMITSLists commits for a GitHub repository. Requires 'owner' (username/org) and 'repo' (repository name) parameters. Optionally filter by SHA/branch, path, author, committer, or date range.
Input parameters
SHA hash or branch name to start listing commits from. If not provided, the GitHub API uses the repository's default branch (usually `main` or `master`).
Page number of the results to fetch when using pagination.
Only commits modifying this specific file path will be returned.
The name of the repository without the `.git` extension (repository name only, not the full 'owner/repo' path). Must contain only alphanumeric characters, hyphens (-), underscores (_), and periods (.). Wildcards like '*' are not supported.
The account owner of the repository (username or organization name only, not the full 'owner/repo' path). Must contain only alphanumeric characters and hyphens, cannot start/end with a hyphen, max 39 characters. Wildcards are not supported.
Only commits created on or after this timestamp will be returned. This is a timestamp in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.
Only commits created before this timestamp will be returned. This is a timestamp in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.
Filter commits by the commit author's GitHub login or email address.
Number of results to return per page (max 100).
Filter commits by the commit committer's GitHub login or email address. The committer is the user who applied the patch and may differ from the original author.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_COMMITS_ON_A_PULL_REQUESTLists commits for a pull request; requires the repository and pull request to exist and be accessible, and supports pagination.
Input parameters
The page number of the results to fetch.
Repository name, without the `.git` extension. This name is not case-sensitive.
Account owner of the repository. This name is not case-sensitive.
The number of results per page (maximum 100).
The number that identifies the pull request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_COMMONLY_USED_LICENSESRetrieves a list of commonly used software licenses from GitHub, optionally filtering for 'featured' licenses whose specific selection criteria by GitHub may vary.
Input parameters
The page number for the set of results to retrieve (must be an integer starting from 1). Used for paginating through the list of licenses.
If true, filters for licenses that GitHub considers 'featured', such as popular or recommended licenses. If false or not provided, returns all commonly used licenses.
The number of license results to return per page (must be an integer between 1 and 100, inclusive). Used for paginating through the list of licenses.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_CUSTOM_PROPERTIES_FOR_AN_ORGANIZATIONGets the schema definitions for all custom properties configured for an organization, not the specific values assigned to repositories.
Input parameters
The unique identifier (login name) of the GitHub organization. This name is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_CUSTOM_PROPERTY_VALUES_FOR_A_REPOSITORYGets all custom property values for a repository. Custom properties are defined at the organization level, so this endpoint works with organization-owned repositories. Returns an empty array if no custom properties are set.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The organization name that owns the repository. Custom properties are an organization-level feature, so this endpoint primarily works with organization-owned repositories. This field is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_CUSTOM_PROPERTY_VALUES_FOR_ORG_REPOSLists repositories in an organization with their custom property values. Requires 'Custom properties' organization permission (read).
Input parameters
The organization name (login). Not case-sensitive. Example: 'github', 'microsoft'.
Page number of results to fetch (default 1).
Number of results per page (max 100, default 30).
Optional query string to filter repositories. Uses GitHub's search syntax with keywords and qualifiers like 'is:public', 'topic:security', 'language:python', 'archived:false'. Leave empty to list all repositories.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_DELIVERIES_FOR_AN_ORGANIZATION_WEBHOOKRetrieves a list of webhook deliveries for a specific webhook in an organization, allowing inspection of delivery history and details.
Input parameters
Name of the organization (case-insensitive).
Pagination cursor specifying the starting delivery for the page.
Unique identifier of the webhook.
Number of results to return per page (max 100).
Filter for redeliveries: `true` for only redeliveries, `false` to exclude them.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_DELIVERIES_FOR_A_REPOSITORY_WEBHOOKRetrieves delivery attempts for a specific repository webhook to inspect its history; ensure the webhook ID exists.
Input parameters
The name of the repository, without the `.git` extension. This field is case-insensitive.
The username or organization name that owns the repository. This field is case-insensitive.
Specifies the starting delivery for pagination. The `Link` header in the response provides cursors for the next and previous pages.
The unique identifier of the webhook. This ID can be found in the `X-GitHub-Hook-ID` header of a webhook delivery.
Maximum 100 results per page. For more details, refer to "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)".
If set to `true`, the response will include the latest redelivery attempt for each delivery, rather than the original delivery.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_DEPLOY_KEYSLists deploy SSH keys for a specified repository; the repository must exist.
Input parameters
The page number of the results to fetch, starting from 1.
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository. This name is not case-sensitive.
The number of deploy keys to return per page. Maximum value is 100.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_DEPLOYMENT_BRANCH_POLICIESLists all deployment branch policies for a specified environment in a GitHub repository.
Input parameters
Page number of results (starts at 1).
Repository name, without the `.git` extension; not case sensitive.
Account owner of the repository; not case sensitive.
Number of results per page (max 100).
Name of the environment; URL encode if it contains special characters (e.g., slashes to `%2F`).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_DEPLOYMENTSLists deployments for a specified repository; repository must exist.
Input parameters
Filter by the ref name (branch, tag, or commit SHA).
Filter by the commit SHA recorded when the deployment was created.
The page number of the results to retrieve. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The name of the repository, without the `.git` extension. This name is not case sensitive.
Filter by the task name specified for the deployment.
The account owner of the repository. This name is not case sensitive.
The number of results to display per page (maximum 100). For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
Filter by the environment name to which deployed.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_DEPLOYMENT_STATUSESLists all statuses for a given deployment in a repository.
Input parameters
Page number of the results to fetch.
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
Number of results per page (maximum 100).
The unique identifier of the deployment for which statuses are being requested.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_DISCUSSION_COMMENTSLists all comments for a specific team discussion within an organization. Note: Team discussions are deprecated as of 2023-11-28. Consider using GitHub Discussions instead. This endpoint requires the authenticated user to be a member of the organization and have access to the team's discussions.
Input parameters
The organization name (case-insensitive).
Page number of the results.
Number of comments per page (max 100).
Sort direction for comments: 'asc' (oldest first) or 'desc' (newest first).
The team's slug (URL-friendly identifier).
The unique number identifying the team discussion.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_DISCUSSIONSLists discussions for a specific team within an organization, with options for sorting, pagination, and filtering by pinned status. Note: Team discussions are deprecated as of 2023-11-28. Consider using GitHub Discussions instead. This endpoint requires the authenticated user to be a member of the organization and have access to the team's discussions.
Input parameters
The organization's name (case-insensitive).
Page number for pagination. Defaults to 1.
Filter for pinned discussions. Use 'true' to show only pinned discussions. Omit to show all discussions.
Number of results per page (max 100). Defaults to 30.
Sort direction for results: 'asc' (oldest first) or 'desc' (newest first). Defaults to 'desc'.
The team's slug (URL-friendly name).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_EMAIL_ADDRESSES_FOR_THE_AUTHENTICATED_USERLists all email addresses for the authenticated user, including their primary status, verification status, and visibility. This action retrieves the complete list of email addresses associated with the authenticated user, providing important details such as which email is primary and whether the emails are verified.
Input parameters
Page number of the results to retrieve.
Number of results per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ENVIRONMENT_CUSTOM_DEPLOYMENT_RULESLists all custom deployment protection rule integrations for a repository environment; the `environment_name` must be URL-encoded.
Input parameters
Page number of the results to fetch, starting from 1.
Name of the repository, without the `.git` extension; not case-sensitive.
Account owner of the repository (user or organization); not case-sensitive.
Number of results per page, with a maximum of 100.
Name of the environment, which must be URL-encoded (e.g., slashes `/` replaced with `%2F`).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ENVIRONMENTSRetrieves all deployment environments for a specified repository, which are used to configure protection rules and secrets for different software lifecycle stages.
Input parameters
The page number of the results to retrieve. Starts from 1.
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
The number of results to return per page. Maximum value is 100.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ENVIRONMENT_SECRETSLists the names and metadata (not values) of secrets for a specified, existing environment within an existing GitHub repository.
Input parameters
Page number for results (1-indexed).
Repository name, without the `.git` extension (case-insensitive).
The account owner's username (case-insensitive).
Number of secrets per page (maximum 100).
Name of the environment; URL-encode if it contains special characters (e.g., '/' becomes '%2F').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ENVIRONMENT_VARIABLESLists all environment variables, which are plaintext key-value pairs for GitHub Actions workflows, for a specified environment within a GitHub repository.
Input parameters
Page number of the results to fetch.
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository (e.g., a user or organization). This name is not case-sensitive.
Number of results per page (maximum 30).
The name of the environment. The name must be URL-encoded. For example, any slashes `/` in the name must be replaced with `%2F`.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_EVENTS_FOR_THE_AUTHENTICATED_USERLists public events for the specified GitHub user, or private events if authenticated as that user, in reverse chronological order.
Input parameters
Page number of the results to fetch.
Number of events to return per page (maximum 100).
The GitHub username for whom to list events. For example, 'octocat' or 'torvalds'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_EVENTS_RECEIVED_BY_THE_AUTHENTICATED_USERLists events a specific GitHub user received from followed users and watched repositories; returns private events if authenticated for `username`, otherwise public.
Input parameters
Indicates the page number of the results to fetch. For more information, see GitHub's REST API pagination guide.
Specifies the number of events to return per page (maximum 100). For more information, see GitHub's REST API pagination guide.
The GitHub username for whom to fetch received events.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_FOLLOWERS_OF_A_USERLists followers for a specified, existing GitHub user.
Input parameters
Page number for pagination of results (starts at 1).
Number of results per page (maximum 100). Used for pagination.
The GitHub username (e.g., 'octocat', 'torvalds').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_FOLLOWERS_OF_THE_AUTHENTICATED_USERLists users following the authenticated GitHub user, returning an empty list if the user has no followers.
Input parameters
Page number of the results to fetch.
Number of results per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_FORKSLists forks for a specified repository, which must exist, with options for sorting and pagination.
Input parameters
The page number of the results to retrieve, used for pagination. Defaults to 1.
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The sort order for the returned forks. `stargazers` sorts by the number of stars. Defaults to `newest`.
The username of the account that owns the repository. This field is not case-sensitive.
The number of fork results to return per page. Maximum value is 100. Defaults to 30.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_GIST_COMMENTSLists comments for a specified GitHub Gist.
Input parameters
Page number of the results to fetch.
The unique identifier of the Gist for which comments are to be listed.
Number of comments to return per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_GIST_COMMITSLists all commits for a specified gist.
Input parameters
Page number of the results to fetch.
The unique identifier of the gist.
Number of results per page (maximum 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_GIST_FORKSLists all forks for a given GitHub gist ID.
Input parameters
The page number of the results to retrieve, starting from 1. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The unique identifier (ID) of the gist for which to list forks.
The number of fork results to display per page. Maximum value is 100. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_GISTS_FOR_A_USER_lists public gists for a specified GitHub user._
Input parameters
Indicates the page number of the results to retrieve.
Filters gists to those updated on or after this ISO 8601 timestamp (e.g., `YYYY-MM-DDTHH:MM:SSZ`).
Specifies the number of gists to return per page. Maximum value is 100.
The GitHub username of the user whose gists are to be listed.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_GISTS_FOR_THE_AUTHENTICATED_USERLists gists for the authenticated user, with optional filtering by update time and pagination.
Input parameters
Page number of results to retrieve.
Filters gists to include only those updated at or after this ISO 8601 timestamp (e.g., `YYYY-MM-DDTHH:MM:SSZ`).
Number of gists to return per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_GITHUB_ACTIONS_CACHES_FOR_A_REPOSITORYLists GitHub Actions caches for a repository, with options to filter by Git reference or cache key, and to sort and paginate results.
Input parameters
An explicit key or a prefix to filter caches that match the key or start with the prefix.
Full Git reference for filtering caches (e.g., `refs/heads/<branch_name>` or `refs/pull/<pull_request_number>/merge`).
Page number of results to retrieve (starts from 1).
Name of the repository, without the `.git` extension (case-insensitive).
Property for sorting results: `created_at` (creation time), `last_accessed_at` (last access time), or `size_in_bytes` (cache size).
Username of the account owning the repository (case-insensitive).
Number of cache entries per page (max 100).
Direction for sorting results: `asc` (ascending) or `desc` (descending).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_GITHUB_PAGES_BUILDSLists GitHub Pages builds for a repository; GitHub Pages must be enabled on the repository for builds to be listed.
Input parameters
The page number of the results to fetch. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository (e.g., username or organization). This name is not case-sensitive.
The number of results per page (max 100). For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_GITIGNORE_TEMPLATESRetrieves all available .gitignore template names from GitHub (e.g., 'Python', 'Node', 'Java'), used for generating .gitignore files.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_GLOBAL_SECURITY_ADVISORIESLists GitHub's global security advisories, filterable by various attributes including ID, type, ecosystem, severity, and dates.
Input parameters
Filter by Common Weakness Enumeration (CWE) identifiers. Accepts comma-separated string or multiple parameters. Example: `cwes=79,284`.
Property to sort results by (updated, published, epss_percentage, epss_percentile).
Filter by advisory type (e.g., reviewed, malware). Defaults to 'reviewed'; if this default is active and no other search parameters are used, malware advisories are also excluded.
Pagination cursor to retrieve results after this value.
Pagination cursor to retrieve results before this value.
Filter by Common Vulnerabilities and Exposures (CVE) identifier.
Filter by affected 'package' or 'package@version'. Max 100 items. Example: `affects=pkg1,pkg2@1.0.0`.
Filter by GitHub Security Advisory (GHSA) identifier.
Filter by update date or date range. For syntax, see GitHub's 'understanding the search syntax' documentation.
Filter by last modification (update or publication) date or date range. For syntax, see GitHub's 'understanding the search syntax' documentation.
Number of results per page (max 100).
Filter by advisory severity (e.g., high, critical).
Sort direction for results (asc, desc).
Filter by package ecosystem (e.g., npm, pip).
Filter by publication date or date range. For syntax, see GitHub's 'understanding the search syntax' documentation.
Filter for withdrawn advisories.
Filter by EPSS (Exploit Prediction Scoring System) percentage score. Use comparison operators (e.g., '>0.5', '<=0.1').
Filter by EPSS (Exploit Prediction Scoring System) percentile score. Use comparison operators (e.g., '>0.9', '>=0.5').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_GPG_KEYS_FOR_A_USERTool to list GPG keys for a GitHub user. Use when you need to fetch the public GPG keys associated with a specific GitHub user account.
Input parameters
The page number of the results to fetch. For more information, see "Using pagination in the REST API".
The number of results per page (max 100). For more information, see "Using pagination in the REST API".
The handle for the GitHub user account.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_INSTALLATION_REQUESTS_FOR_THE_AUTHENTICATED_APPLists pending installation requests made by users or organizations for the authenticated GitHub App.
Input parameters
Page number of the results to retrieve.
Number of results to return per page (maximum 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_INSTANCES_OF_A_CODE_SCANNING_ALERTLists all instances of a specific code scanning alert, optionally filtered by Git ref; requires code scanning to be enabled on the repository.
Input parameters
The Git reference for the results you want to list. The `ref` for a branch can be formatted either as `refs/heads/<branch name>` or simply `<branch name>`. To reference a pull request use `refs/pull/<number>/merge`.
The page number of the results to fetch. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The number of results per page (max 100). For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The number that identifies an alert. You can find this at the end of the URL for a code scanning alert within GitHub, and in the `number` field in the response from the `GET /repos/{owner}/{repo}/code-scanning/alerts` operation.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ISSUE_COMMENTSLists comments for a specified issue in a GitHub repository.
Input parameters
Page number of the results to retrieve.
Name of the repository, without the `.git` extension (not case-sensitive).
Username of the account owning the repository (not case-sensitive).
Filters comments to include only those updated at or after this ISO 8601 timestamp (e.g., `YYYY-MM-DDTHH:MM:SSZ`).
Number of comments to return per page (max 100).
Number that identifies the issue.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ISSUE_COMMENTS_FOR_A_REPOSITORYLists issue comments, including those on pull requests, for an accessible repository.
Input parameters
The page number of the results to fetch, used for pagination. Default is 1. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
REQUIRED. The name of the repository, without the `.git` extension. This is a path parameter needed to construct the API URL. This field is not case-sensitive.
Specifies the field by which to sort the issue comments. Valid values are `created` (for creation date, default) or `updated` (for last update date).
REQUIRED. The username of the account or the organization name that owns the repository. This is a path parameter needed to construct the API URL. This field is not case-sensitive.
Filters comments to include only those last updated at or after the specified time. This should be a timestamp in ISO 8601 format (e.g., `YYYY-MM-DDTHH:MM:SSZ`).
The number of issue comments to retrieve per page. Default is 30, maximum is 100. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The direction for sorting results. Valid values are `asc` (ascending) or `desc` (descending). This parameter is effective only when `sort` is also specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ISSUE_DEPENDENCIES_BLOCKED_BYTool to list dependencies an issue is blocked by. Use when you need to retrieve all issues that are blocking a specific issue from being closed or completed.
Input parameters
The page number of the results to fetch. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The number of results per page (max 100). For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The number that identifies the issue.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ISSUE_DEPENDENCIES_BLOCKINGTool to list dependencies an issue is blocking. Use when you need to see which issues are blocked by a specific issue.
Input parameters
The page number of the results to fetch. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The number of results per page (max 100). For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The number that identifies the issue.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ISSUE_EVENTSRetrieves a list of all events for a specific issue within a GitHub repository.
Input parameters
The page number of the results to fetch. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The username of the account that owns the repository. This name is not case-sensitive.
The number of results to return per page. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The unique number that identifies the issue within the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ISSUE_EVENTS_FOR_A_REPOSITORYLists all issue events (e.g., closed, reopened, assigned) for a specified repository.
Input parameters
Page number for pagination.
Repository name, without the `.git` extension; case-insensitive.
Account owner of the repository (username or organization name); case-insensitive. Must match an existing GitHub user or organization exactly.
Number of results per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ISSUES_ASSIGNED_TO_THE_AUTHENTICATED_USERLists GitHub issues for the authenticated user across visible repositories, with filtering by user relationship, state, labels, an ISO 8601 `since` timestamp (YYYY-MM-DDTHH:MM:SSZ), and sorting options; pull requests are typically included.
Input parameters
Page number for results.
Field to sort issues by.
Return issues updated at or after this ISO 8601 timestamp (YYYY-MM-DDTHH:MM:SSZ).
Filter issues by state (e.g., 'open', 'closed').
Specifies the relationship for filtering issues (e.g., 'assigned', 'created').
Comma-separated list of label names for filtering.
Number of results per page (max 100).
Sort direction.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ISSUE_TYPESList all issue types configured for a GitHub organization. Requires read:org scope for OAuth tokens.
Input parameters
The organization name (case-insensitive).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_JOBS_FOR_A_WORKFLOW_RUNLists jobs for a specific workflow run in a GitHub repository.
Input parameters
The page number of the results to fetch. For more details, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The name of the repository, without the .git extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
Filters jobs by their `completed_at` timestamp. `latest` returns jobs from the most recent execution attempt of the workflow run. `all` returns all jobs for a workflow run, including from previous execution attempts.
The unique identifier of the workflow run for which jobs are to be listed.
The number of results to return per page, with a maximum of 100. For more details, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_JOBS_FOR_A_WORKFLOW_RUN_ATTEMPTLists jobs, including details like ID, status, and steps, for a specific attempt of a GitHub Actions workflow run.
Input parameters
Page number of the results to fetch.
Name of the repository, without the `.git` extension (not case-sensitive).
Account owner of the repository (not case-sensitive).
Unique identifier of the workflow run.
Number of results per page (max 100).
Attempt number of the workflow run, corresponding to a specific retry.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_LABELS_FOR_AN_ISSUELists all labels for a specified issue in a GitHub repository.
Input parameters
The page number of the results to fetch. Defaults to 1. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The name of the repository, without the `.git` extension. This is not case-sensitive.
The account owner of the repository (username or organization name). This is not case-sensitive.
The number of results to return per page. Maximum value is 100. Defaults to 30. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The unique number identifying the issue within the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_LABELS_FOR_A_REPOSITORYRetrieves all labels for a specified, existing GitHub repository.
Input parameters
Page number of the results to fetch (starts from 1).
Name of the repository, without the .git extension (case-insensitive).
Username of the account owning the repository (case-insensitive).
Number of results to return per page (maximum 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_LABELS_FOR_A_SELF_HOSTED_RUNNER_FOR_A_REPOSITORYLists all labels assigned to a specific self-hosted runner registered with the given repository.
Input parameters
The name of the repository, without the '.git' extension. This field is not case-sensitive.
The username of the account that owns the repository. This field is not case-sensitive.
The unique identifier (ID) of the self-hosted runner.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_LABELS_FOR_ISSUES_IN_A_MILESTONELists all labels for issues within a specific milestone in a repository.
Input parameters
The page number of the results to retrieve. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The name of the repository, without the `.git` extension. This is case-insensitive.
The username of the account that owns the repository. This is case-insensitive.
The number of results to return per page. The maximum value is 100. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The unique number that identifies the milestone.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_LABELS_FOR_SELF_HOSTED_RUNNER_ORGLists all labels assigned to a specific self-hosted runner within a GitHub organization, which are used to route workflows.
Input parameters
The name of the GitHub organization. This name is not case-sensitive.
The unique identifier (ID) of the self-hosted runner.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_LICENSES_GRAPH_QLTool to fetch all known open source licenses using GitHub's GraphQL API. Use when you need to retrieve the complete list of licenses that can be applied to repositories.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_MACHINE_TYPES_FOR_A_CODESPACELists available machine types for a specific, accessible codespace, enabling it to be transitioned to a new hardware configuration.
Input parameters
The unique name of the codespace for which to list available machine types. This is often a combination of a username, repository name, and a unique identifier.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_MATCHING_REFERENCESLists all Git references (branches or tags) in a repository that start with the provided partial reference path (e.g., `heads/my-feature` or `tags/v1.2`).
Input parameters
Partial Git reference path (e.g., 'heads/main', 'tags/v1.0') to match from the beginning of the reference name; do not include the `refs/` prefix.
Page number of the results to retrieve.
The name of the repository, without the `.git` extension. This is case-insensitive.
The username or organization name that owns the repository. This is case-insensitive.
Number of results to return per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_MILESTONESLists milestones, which track progress for groups of issues and pull requests, for an existing repository, allowing filtering by state and sorting.
Input parameters
Page number for paginated results.
The name of the repository, without the '.git' extension. This field is not case-sensitive.
Sort by `due_on` (due date) or `completeness` (percentage of issues completed).
The username of the account that owns the repository. This field is not case-sensitive.
Filters milestones by their state.
Number of results per page (max 100).
Sort direction: `asc` (ascending) or `desc` (descending).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_NOTIFICATIONSTool to list notification threads for the authenticated user with efficient polling support. Use when you need to fetch the user's GitHub notification inbox with filters like unread/participating/since. Returns notification threads plus polling headers (Last-Modified, ETag, X-Poll-Interval) for efficient polling. IMPORTANT: This endpoint requires a Personal Access Token (classic) with 'notifications' or 'repo' scope. It does NOT work with GitHub App tokens or fine-grained personal access tokens. If the token type is incompatible, a clear error message will be returned.
Input parameters
If true, show notifications marked as read. Default shows only unread notifications.
Page number of results to fetch.
Only show notifications updated after the given ISO 8601 timestamp (YYYY-MM-DDTHH:MM:SSZ).
Only show notifications updated before the given ISO 8601 timestamp (YYYY-MM-DDTHH:MM:SSZ).
Number of results per page (maximum 50).
If true, only shows notifications in which the user is directly participating or mentioned.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_NOTIFICATIONS_FOR_THE_AUTHENTICATED_USERDEPRECATED: Use GITHUB_LIST_NOTIFICATIONS instead. Lists notifications for the authenticated user, sorted by most recent update, with filtering and pagination options.
Input parameters
If `true`, shows all notifications including those marked as read.
Page number of results to fetch.
Only show notifications updated after this ISO 8601 timestamp (e.g., `YYYY-MM-DDTHH:MM:SSZ`).
Only show notifications updated before this ISO 8601 timestamp (e.g., `YYYY-MM-DDTHH:MM:SSZ`).
Number of results per page (max 50).
If `true`, shows only notifications in which the authenticated user is directly participating or has been mentioned.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ORGANIZATION_CODESPACES_SECRETSLists all Codespaces secrets available for a specified organization, which must exist.
Input parameters
The GitHub organization name (case-insensitive).
Page number for pagination.
Number of results per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ORGANIZATION_EVENTS_FOR_THE_AUTHENTICATED_USERLists public events in a specified GitHub organization for the authenticated user's organization dashboard. Returns activities like repository pushes, pull requests, issues, forks, and other public events within the organization. The authenticated user must be a member of the organization to see events.
Input parameters
Name of the GitHub organization (case-insensitive).
The page number of results to retrieve. Page numbering starts at 1. Default is 1.
Number of events to return per page. Must be between 1 and 100. Default is 30.
The GitHub username of the authenticated user. Must match the username of the account associated with the authentication token.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ORGANIZATION_MEMBERSLists public and concealed members of a GitHub organization; viewing concealed members requires authenticated user to be an organization member.
Input parameters
The GitHub organization's name (case-insensitive).
The page number of the results to fetch (1-indexed).
Filter members by their role in the organization.
Filter for members: '2fa_disabled' returns only members without two-factor authentication (available only to organization owners).
The number of results per page (maximum 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ORGANIZATION_MEMBERSHIPS_FOR_THE_AUTHENTICATED_UList organization memberships for authenticated user
Input parameters
The page number of the results to fetch.
Membership state filter options.
The number of results per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ORGANIZATION_PROJECTSLists projects (V2) for a specified GitHub organization, with optional search query and cursor-based pagination.
Input parameters
Limit results to projects of the specified type or matching a search query.
The name of the GitHub organization (e.g., 'octocat', 'microsoft'). This name is not case-sensitive.
A cursor for pagination. Returns results after this cursor.
A cursor for pagination. Returns results before this cursor.
Number of projects to return per page (maximum 100). GitHub Projects V2 uses the GraphQL API and cursor-based pagination.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ORGANIZATION_REPOSITORIESRetrieves a list of repositories for a specified GitHub organization, allowing filtering by type and sorting.
Input parameters
Name of the GitHub organization (not case-sensitive).
Page number for pagination (starts from 1).
Property to sort repositories by: `created`, `updated`, `pushed`, or `full_name`.
Specifies the type of repositories to return: `all`, `public`, `private` (requires permissions), `forks`, `sources` (not forks), or `member` (repositories with explicit user access).
Number of results per page (maximum 100).
Sort order: `asc` (ascending) or `desc` (descending). Defaults to `asc` if `sort` is `full_name`, else `desc`.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ORGANIZATION_ROLES_FOR_AN_ORGANIZATIONLists all custom organization roles for an existing GitHub organization.
Input parameters
The unique name of the GitHub organization. This name is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ORGANIZATIONSLists GitHub organizations for the authenticated user, sorted by ID in ascending order.
Input parameters
An organization ID. If provided, only organizations with an ID greater than this will be returned, for pagination.
Number of results to return per page, max 100.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ORGANIZATION_SECRETSLists GitHub Actions secrets available for a specified organization.
Input parameters
Name of the GitHub organization (case-insensitive).
Page number for results.
Number of secrets to return per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ORGANIZATIONS_FOR_A_USERLists public organizations for a specified GitHub user; the `username` must be a valid GitHub handle.
Input parameters
Page number of the results to fetch.
Number of results per page (maximum 100).
GitHub username (handle) of the user.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ORGANIZATIONS_FOR_THE_AUTHENTICATED_USERLists organizations the authenticated GitHub user is a member of, returning details for each organization.
Input parameters
The page number of the results to retrieve, used for pagination. Default is 1.
The number of organization results to return per page. Default is 30, maximum is 100.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ORGANIZATION_VARIABLESLists all GitHub Actions variables for a specified organization.
Input parameters
The organization name (not case-sensitive).
Page number of results to fetch (starts at 1).
Number of results per page (max 30).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ORGANIZATION_WEBHOOKSLists all webhooks for a specified GitHub organization; the organization must exist.
Input parameters
The GitHub organization name (not case-sensitive).
Page number of results to fetch.
Number of results per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ORG_FINE_GRAINED_PERMISSIONSLists all fine-grained permissions available in a GitHub organization for use in custom organization roles. These permissions define granular access controls that can be combined when creating custom roles. Note: This endpoint requires GitHub Enterprise Cloud with the custom organization roles feature enabled. The authenticated user must be an administrator or have the 'read_organization_custom_org_role' permission.
Input parameters
The organization name (not case-sensitive). Note: This endpoint requires GitHub Enterprise Cloud with custom organization roles enabled.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ORG_ISSUES_FOR_THE_AUTHENTICATED_USERLists issues for the authenticated user within a specified GitHub organization, with options to filter by involvement type, state, labels, and to sort results.
Input parameters
The name of the GitHub organization. This name is not case-sensitive.
Page number of the results to retrieve.
Field to sort results by.
Only issues updated at or after this time are returned. This is a timestamp in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.
Filters issues by their state.
Filter indicating the type of issues to return based on user involvement (e.g., `assigned`, `created`, `mentioned`, `subscribed`, or `all`/`repos` for all accessible issues).
A comma-separated list of label names to filter issues by. For example: `bug,ui,@high`. Issues returned must match all specified labels.
Number of issues to return per page (maximum 100).
Direction for sorting results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ORG_PACKAGE_VERSIONSLists all versions for a specified package, if it exists and is owned by the given GitHub organization.
Input parameters
Name of the GitHub organization owning the package (case-insensitive).
Page number for results (starts at 1).
Filters package versions by state.
Results per page (max 100).
Unique package name within its ecosystem.
Package's ecosystem. Important notes: GitHub Gradle packages use `maven`; images in ghcr.io use `container`; `docker` type can find images from docker.pkg.github.com, including those migrated to ghcr.io.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ORG_PROJECT_VIEW_ITEMSTool to list items for an organization project view. Use when you need to retrieve all items from a specific view within a GitHub organization's Projects V2 project. Returns a list of project items with their content, metadata, and field values.
Input parameters
The organization name. The name is not case sensitive.
A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see 'Using pagination in the REST API'.
A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see 'Using pagination in the REST API'.
Limit results to specific fields, by their IDs. If not specified, the title field will be returned. Example: 'fields\[\]=123&fields\[\]=456&fields\[\]=789' or 'fields=123,456,789'
The number of results per page (max 100). For more information, see 'Using pagination in the REST API'.
The number that identifies the project view.
The project's number (unique identifier within the organization).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ORG_REPOS_WITH_GITHUB_ACTIONS_ENABLEDLists the selected repositories that are enabled for GitHub Actions in an organization. This endpoint only returns results when the organization's 'enabled_repositories' permission policy is configured to 'selected'. Requires admin:org scope and organization admin permissions.
Input parameters
The organization name. The name is not case sensitive.
The page number of the results to fetch.
The number of results per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ORG_RESOURCE_ACCESS_TOKENSLists approved fine-grained personal access tokens (PATs) with access to resources in a GitHub organization, optionally filtering by owner, repository, permissions, or last usage time. AUTHENTICATION REQUIREMENT: This endpoint requires GitHub App authentication with 'Personal access tokens' organization permissions (read). Standard personal access tokens CANNOT use this endpoint. The GitHub App must also have access to the organization.
Input parameters
Name of the GitHub organization (not case-sensitive).
Page number of results to fetch (starts from 1).
Property to sort results by. Currently only 'created_at' is supported.
Filter by a list of owner usernames (max 10 items).
Number of results per page (max 100).
Filter by a list of token IDs (max 50 items). Use this to look up specific tokens.
Sort direction: 'asc' for ascending or 'desc' for descending (default).
Filter by permission string in format 'scope:level' where scope is the permission area (e.g., 'issues', 'actions', 'contents') and level is 'read' or 'write'. Common examples: 'issues:read', 'issues:write', 'actions:read', 'actions:write', 'contents:read', 'contents:write', 'metadata:read', 'pull_requests:write'.
Filter by repository name.
Filter for tokens last used after this ISO 8601 timestamp (YYYY-MM-DDTHH:MM:SSZ).
Filter for tokens last used before this ISO 8601 timestamp (YYYY-MM-DDTHH:MM:SSZ).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ORG_RESOURCES_WITH_PERSONAL_TOKENSLists requests from organization members to access organization resources with fine-grained personal access tokens (pending, approved, or denied). Note: This endpoint requires GitHub App authentication with 'organization_personal_access_token_requests:read' permissions; it cannot be used with personal access tokens.
Input parameters
The GitHub organization name (case-insensitive).
Page number for results (1-based).
Sorts results by 'created_at' (currently the only supported property).
Filter by a list of token owner GitHub usernames.
Number of results per page (max 100).
Filter by a list of token IDs (max 50 items). Use this to look up specific token requests.
Sort direction: 'asc' for ascending or 'desc' for descending.
Filters requests by the specific permission granted to the token.
Filter by repository name for tokens that access this repository.
Filters for tokens last used after this ISO 8601 timestamp.
Filters for tokens last used before this ISO 8601 timestamp.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_ORG_SECRETS_WITHOUT_VALUESLists all Dependabot secrets (metadata like names, creation/update timestamps, but not their encrypted values) for a specified organization, which must exist.
Input parameters
The unique identifier of the GitHub organization. This name is not case-sensitive.
The page number of the results to fetch. Starts from 1. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The number of results to return per page. The maximum value is 100. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_OUTSIDE_COLLABORATORS_FOR_AN_ORGANIZATIONLists outside collaborators for a GitHub organization, with options to filter (e.g., by 2FA status) and paginate results.
Input parameters
The GitHub organization name (not case-sensitive).
Page number for pagination.
Filter for the list: 'all' for every collaborator, '2fa_disabled' for those without two-factor authentication, '2fa_insecure' for those with insecure 2FA.
Number of results per page (maximum 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_OWNED_PACKAGE_VERSIONSLists all versions for an existing package owned by the authenticated user, identified by its type and name.
Input parameters
Page number of the results to fetch, starting from 1.
Filters package versions by state.
Number of results per page (maximum 100).
Unique name of the package.
Packages in GitHub's Gradle registry have the type `maven`. Docker images pushed to GitHub's Container registry (`ghcr.io`) have the type `container`. Use `docker` to find images from GitHub's Docker registry (`docker.pkg.github.com`), even if migrated.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_PACKAGES_FOR_AN_ORGANIZATIONLists GitHub Packages for an organization, noting specific interpretations for package_type and visibility parameters.
Input parameters
Name of the GitHub organization (case-insensitive).
Page number for paginated results.
Number of results per page (maximum 100).
Filter packages by visibility. 'internal' is for registries with granular permissions; otherwise, it's treated as 'private'.
Package type to filter by. Note: Gradle packages use 'maven'; ghcr.io Docker images use 'container'; 'docker' type finds images from docker.pkg.github.com.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_PACKAGES_FOR_A_USERLists packages for a specified GitHub user, filterable by package type and visibility.
Input parameters
Page number of the results to retrieve.
Number of results to return per page (maximum 100).
The GitHub username of the account whose packages are to be listed.
Filters packages by visibility. The `internal` visibility is supported only for GitHub Packages registries allowing granular permissions; for others, `internal` is synonymous with `private`.
Filters by package type. Note: GitHub's Gradle packages are type `maven`. Images in `ghcr.io` (Container registry) are `container`. Use `docker` for images from `docker.pkg.github.com`, including those migrated to the Container registry.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_PACKAGES_FOR_THE_AUTHENTICATED_USERLists packages of a specific type and visibility within the authenticated user's namespace on GitHub.
Input parameters
Page number of the results to fetch.
Number of results to return per page, maximum 100.
Filters packages by visibility. 'internal' is specific to GitHub Packages registries with granular permissions; for others, it's treated as 'private'.
The type of package to list. For GitHub's Gradle registry, use 'maven'; for Docker images from GitHub's Container registry (ghcr.io), use 'container'. 'docker' finds images from the original Docker registry (docker.pkg.github.com), even if migrated.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_PACKAGE_VERSIONS_FOR_A_PACKAGE_OWNED_BY_A_USERLists all versions of a public package owned by a specific GitHub user, identified by package type, package name, and username.
Input parameters
Page number of the results to retrieve.
Number of results to return per page (max 100).
The GitHub username of the account that owns the package (e.g., 'octocat').
The name of the package as it is registered in GitHub Packages.
Type of the package. Valid values: npm, maven, rubygems, docker, nuget, container. Note: GitHub Gradle registry packages use 'maven'. GitHub Container registry (ghcr.io) images use 'container'. The 'docker' type can find images from the older GitHub Docker registry (docker.pkg.github.com), even if migrated to the Container registry.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_PENDING_TEAM_INVITATIONSLists all pending membership invitations for a specified team within an organization. The authenticated user must be an organization member with the read:org scope. The response includes invitation details such as the invitee's login/email, the role they're being invited to, and who sent the invitation. The 'role' field indicates the type of invitation: - 'direct_member': Regular organization member - 'admin': Organization administrator - 'billing_manager': Billing manager role - 'hiring_manager': Hiring manager role - 'reinstate': Reinstating a previous member Note: If the invitee is not a GitHub member, the 'login' field will be null and only the 'email' field will be populated.
Input parameters
The organization name (case-insensitive). The authenticated user must be an organization member with read:org scope.
Page number of results to fetch (1-indexed). Default is 1.
Number of results per page (max 100). Default is 30.
The slug (URL-friendly identifier) of the team name. Typically lowercase and hyphenated (e.g., 'my-team' for 'My Team').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_PROJECT_CARDSLists all project cards for a given column_id in GitHub Projects (classic). DEPRECATION NOTICE: GitHub Projects (classic) and its REST API were sunset on April 1, 2025. This action will return 404 for most requests on GitHub.com. However, it may still work on GitHub Enterprise Server instances where classic projects are enabled. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/ Returns a list of project cards including: id, node_id, url, note (or null for linked cards), creator info, content_url (for issue/PR cards), column_url, project_url, timestamps, and archived status.
Input parameters
Page number of results to retrieve (1-indexed). Default is 1.
Number of project cards to return per page (1-100). Default is 30.
The unique identifier of the project column for which to list cards. This ID can be obtained from the 'list_project_columns' action or from the column's API URL (e.g., /projects/columns/12345).
Filters the project cards based on their archived state. Options: "all" returns all cards, "archived" returns only archived cards, and "not_archived" returns only unarchived/active cards.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_PROJECT_COLLABORATORSLists collaborators for a GitHub Project (classic) by project ID. IMPORTANT: This action uses the Projects (classic) REST API which was sunset on April 1, 2025 for GitHub.com. The API may still be available on GitHub Enterprise Server versions before 3.17. For GitHub.com users: GitHub Projects (classic) has been replaced by the new Projects experience. The new Projects does not have a REST API for listing collaborators - use the GitHub web interface to manage project collaborators instead. You must be an organization owner or a project admin to list collaborators.
Input parameters
Page number for paginated results. Starts at 1.
Number of collaborators to return per page. Maximum is 100.
The unique numeric identifier of the Project (classic). This is a database ID, not the project number shown in URLs.
Filter collaborators by affiliation type: 'outside' returns only outside collaborators (users who are not organization members), 'direct' returns only collaborators with explicit project permissions, 'all' returns all collaborators including organization members with default permissions.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_PROJECT_COLUMNSLists all of a GitHub project's columns (e.g., 'To Do', 'In Progress'); project_id must identify a valid, accessible project. Note: This action uses GitHub's Projects (classic) REST API. The Projects (classic) API was sunset on April 1, 2025. This action will return an empty columns list with an informative message for projects that no longer exist or when the API returns 404.
Input parameters
The page number of the results to fetch. Starts from 1. For more information on pagination, see GitHub's REST API documentation: https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api.
The number of results to return per page. The maximum value is 100. For more information on pagination, see GitHub's REST API documentation: https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api.
The unique identifier of the project for which columns are to be listed.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_PROJECT_FIELDS_FOR_USERTool to list all fields in a GitHub Projects V2 project for a specific user. Use when you need to see available fields in a project.
Input parameters
A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see '\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)'.
A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see '\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)'.
The number of results per page (max 100). For more information, see '\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)'.
The handle for the GitHub user account.
The project's number (visible in the project URL).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_PROJECT_ITEMS_FOR_USERTool to list items for a user-owned GitHub project. Use when you need to retrieve all items (issues, pull requests, draft issues) from a specific project belonging to a user.
Input parameters
Search query to filter items. See GitHub's filtering projects documentation for syntax.
A cursor for pagination. If specified, the query only searches for results after this cursor.
A cursor for pagination. If specified, the query only searches for results before this cursor.
Limit results to specific fields by their IDs. Format: 'fields\[\]=123&fields\[\]=456' or 'fields=123,456,789'. If not specified, the title field will be returned.
The number of results per page (max 100). Defaults to 30.
The handle for the GitHub user account.
The project's number (displayed in the project URL).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_PROJECT_VIEW_ITEMS_FOR_USERTool to list items for a user's GitHub Projects (v2) view. Use when you need to retrieve items from a specific view of a user's project. Supports pagination and field filtering.
Input parameters
A cursor for pagination. If specified, the query only searches for results after this cursor.
A cursor for pagination. If specified, the query only searches for results before this cursor.
Limit results to specific fields by their IDs. If not specified, the title field will be returned. Example: '123,456,789'
The number of results per page (max 100).
The GitHub username that owns the project.
The number that identifies the project view.
The project's number (unique identifier within the user's projects).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_PUBLIC_EMAILS_FOR_AUTH_USERLists the public email addresses for the authenticated user.
Input parameters
Page number of the results to fetch.
Number of results to return per page. Maximum value is 100.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_PUBLIC_EVENTSLists public GitHub events, which may be delayed by up to 5 minutes, with support for pagination.
Input parameters
Specifies the page number of the results to retrieve. Starts from 1. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
Specifies the number of events to return per page. Maximum value is 100. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_PUBLIC_EVENTS_FOR_A_NETWORK_OF_REPOSITORIESRetrieves public events (up to 90 days old, newest first) for a GitHub repository network, including the repository and its forks.
Input parameters
Specifies the page number for the results to be fetched. For further details, consult "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository. This name is not case-sensitive.
Sets the number of results to return per page, with a maximum of 100. For further details, consult "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_PUBLIC_EVENTS_FOR_A_USERRetrieves a list of public events for a specified GitHub user, in reverse chronological order.
Input parameters
Page number for paginated results.
Number of events to return per page (max 100).
The GitHub username (e.g., 'octocat').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_PUBLIC_EVENTS_RECEIVED_BY_A_USERLists public events for a specified GitHub user (e.g., activities in repositories they watch or are involved in); the target user's profile must be public, and if blocked by the authenticated user, a 404 error is returned.
Input parameters
The page number for the set of results to be fetched. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The number of public events to retrieve per page. The maximum value is 100. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The GitHub username for the user whose received public events are to be listed.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_PUBLIC_GISTSLists public gists from GitHub, optionally filtering by a 'since' timestamp and supporting pagination; results are generally newest first.
Input parameters
Page number of the results to fetch for pagination.
Filters results to gists last updated at or after this ISO 8601 timestamp (e.g., `YYYY-MM-DDTHH:MM:SSZ`).
Number of gists to return per page (maximum 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_PUBLIC_KEYS_FOR_A_USERLists the verified public SSH keys for a specified GitHub user.
Input parameters
The page number of the results to fetch. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The number of results to return per page (maximum 100). For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The GitHub username (handle) of the user whose public SSH keys are to be listed. For example, 'octocat'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_PUBLIC_ORGANIZATION_EVENTSLists public events for a specified GitHub organization, which must exist. This action retrieves the events that are publicly accessible for the organization specified. It returns a paginated list of events with details about each event.
Input parameters
The GitHub organization name (case-insensitive).
Page number of results to retrieve (starts from 1).
Number of results per page (maximum 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_PUBLIC_ORGANIZATION_MEMBERSLists users who have publicly declared their membership in a specified, existing GitHub organization.
Input parameters
The name of the GitHub organization. This field is not case-sensitive.
Page number of the results to retrieve.
Number of results to return per page (maximum 100). Defaults to 30.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_PUBLIC_REPOSITORIESLists all public repositories on GitHub; use the `since` parameter with a repository ID from a previous result for pagination.
Input parameters
A repository ID. Returns only repositories with an ID greater than this value, for pagination.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_PULL_REQUESTSLists pull requests for a GitHub repository. REQUIRES 'owner' AND 'repo' parameters - both are MANDATORY and must be provided in every call. Does NOT support filtering by assignee or date range - use GITHUB_FIND_PULL_REQUESTS instead for searching PRs by assignee, author, or across multiple repositories.
Input parameters
Filter by base branch name.
Filter by head user/org and branch name, e.g., `user:ref-name`.
Page number for results.
\[REQUIRED - MUST BE PROVIDED\] The name of the repository (without the `.git` extension). This parameter is mandatory and cannot be omitted. Example: 'Spoon-Knife' or 'vscode'. To search PRs across multiple repos, use GITHUB_FIND_PULL_REQUESTS instead.
Sorts results. Valid values: 'created', 'updated', 'popularity', 'long-running'. 'popularity' is by comment count; 'long-running' by age and recent activity.
\[REQUIRED - MUST BE PROVIDED\] The GitHub username or organization name that owns the repository. This parameter is mandatory and cannot be omitted. Example: 'octocat' or 'microsoft'. To search PRs across all repos without specifying owner, use GITHUB_FIND_PULL_REQUESTS instead.
Filter by pull request state. Valid values: 'open', 'closed', 'all'.
Number of results per page (maximum 100).
Sort direction. Valid values: 'asc', 'desc'. Defaults to 'desc' if sort is 'created' or unspecified, else 'asc'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_PULL_REQUESTS_ASSOCIATED_WITH_A_COMMITLists pull requests for a commit; returns merged PRs that introduced the commit if on the default branch, or open PRs including the commit if on other branches.
Input parameters
Page number of results to retrieve.
Repository name, without the `.git` extension (case-insensitive).
Account owner of the repository (GitHub username or organization name, case-insensitive).
Number of results per page (max 100).
SHA of the commit to list associated pull requests for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_PULL_REQUESTS_FILESLists all files (including additions, modifications, and removals) associated with a specific pull request in a GitHub repository.
Input parameters
Page number of the results to retrieve for pagination.
The name of the repository, without the `.git` extension. This field is not case sensitive.
The account owner of the repository (e.g., a GitHub username or organization name). This field is not case sensitive.
Number of file results to return per page (max 100).
The numeric identifier of the pull request whose files are to be listed.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REACTIONS_FOR_A_COMMIT_COMMENTLists reactions for a specific commit comment; this is a read-only operation.
Input parameters
Page number for the results (1-indexed).
Repository name, excluding the '.git' extension (case-insensitive).
Owner of the repository (username or organization, case-insensitive).
Filter by reaction type. If unspecified, all reaction types for the comment are returned.
Number of results per page (maximum 100).
Identifier of the commit comment.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REACTIONS_FOR_AN_ISSUELists reactions for a specific, existing issue within an accessible GitHub repository, optionally filtering by content type.
Input parameters
The page number of the results to fetch for pagination.
The name of the repository, without the `.git` extension. This is not case-sensitive.
The username of the account that owns the repository. This is not case-sensitive.
Filters reactions by a specific type. If omitted, all reactions to the issue are listed.
The number of results to return per page, up to a maximum of 100.
The unique number identifying the issue within the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REACTIONS_FOR_AN_ISSUE_COMMENTLists reactions for a specific issue comment in a GitHub repository, optionally filtering by content type.
Input parameters
Page number of results to fetch.
The name of the repository, without the `.git` extension. This name is not case sensitive.
The account owner of the repository (e.g., a user or organization). This name is not case sensitive.
Filters reactions by their content type (e.g., '+1', 'laugh'). Omit to list all types of reactions.
Number of results to return per page (max 100).
The unique identifier of the issue comment for which to list reactions.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REACTIONS_FOR_A_PULL_REQUEST_REVIEW_COMMENTLists reactions for a pull request review comment in a repository, optionally filtering by reaction type.
Input parameters
Page number of the results to fetch.
Name of the repository, without the `.git` extension (not case sensitive).
Account owner of the repository (not case sensitive).
Filters reactions by a specific type; if omitted, all reactions are listed.
Number of results per page (max 100).
Unique identifier of the pull request review comment.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REACTIONS_FOR_A_RELEASELists all reactions, or optionally filters reactions by a specific content type, for a given GitHub release.
Input parameters
Page number of the results to fetch. Starts from 1.
The name of the repository, without the `.git` extension (not case-sensitive).
The GitHub account owner of the repository (not case-sensitive).
Supported reaction types for releases (note: -1 and confused are NOT supported for releases).
Number of results per page. Range: 1-100, default: 30.
The unique identifier of the release. Obtain this from the List Releases API or from the release URL.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REACTIONS_FOR_A_TEAM_DISCUSSIONLists reactions for an existing team discussion within an organization. This endpoint allows you to retrieve all reactions (emoji responses) made to a specific team discussion. You can optionally filter by reaction type. Note: OAuth app tokens and personal access tokens (classic) need the `read:discussion` scope to use this endpoint.
Input parameters
The organization name. Account name of the organization (case-insensitive).
The page number of results to fetch. Default: 1.
Valid reaction content types for GitHub team discussions.
The number of results per page (max 100). Default: 30.
The team's slug (URL-friendly identifier). This is the lowercase, hyphenated version of the team name.
The unique number that identifies the team discussion.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REACTIONS_FOR_A_TEAM_DISCUSSION_COMMENTLists reactions for a specific comment in a team discussion within an organization, optionally filtering by content type.
Input parameters
The organization's name (case-insensitive).
Page number of the results to retrieve.
Filters reactions by a specific content type.
Number of results per page (max 100).
URL-friendly slug of the team name.
Unique identifier for the comment within the discussion.
Unique identifier for the team discussion.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_RELEASE_ASSETSLists assets (e.g., compiled binaries, source code archives) for a specific GitHub release, identified by `release_id` which must be valid for an existing release in the repository.
Input parameters
Page number of the results to fetch (starts from 1). For pagination details, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
Name of the repository, excluding the `.git` extension (case-insensitive).
Username or organization name of the repository owner (case-insensitive).
Number of results per page (max 100). For pagination details, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
Unique numerical identifier for the release. Obtainable by listing a repository's releases.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_RELEASESRetrieves a list of all releases (published, draft, and prerelease) for a specified repository.
Input parameters
The page number of the results to fetch. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository. This name is not case-sensitive.
The number of results to return per page. The maximum value is 100. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPO_ACCESS_BY_TOKENLists repositories in an organization that a fine-grained personal access token has requested access to. Only GitHub Apps can use this endpoint. Requires 'Personal access token requests' organization permissions (read).
Input parameters
The organization name. The name is not case sensitive.
The page number of the results to fetch.
The number of results per page (max 100).
Unique identifier of the request for access via fine-grained personal access token. Obtain this from the 'List PAT grant requests' endpoint.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPO_CODESPACESLists Codespaces the authenticated user can access within a specified, existing repository.
Input parameters
Page number of the results to retrieve.
Name of the repository, without the `.git` extension (case-insensitive).
Username or organization name of the account that owns the repository (case-insensitive).
Number of results to return per page. Maximum: 100.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPO_DEV_CONTAINER_CONFIGS_FOR_USERLists the `devcontainer.json` configurations available in a specified repository for use with GitHub Codespaces.
Input parameters
Page number of the dev container configuration results to fetch.
The name of the repository, without the `.git` extension (not case-sensitive).
The username or organization name that owns the repository (not case-sensitive).
Number of dev container configuration results to return per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPO_INVITATIONS_FOR_AUTH_USERLists all pending repository invitations for the authenticated user.
Input parameters
Page number of the results to retrieve.
Number of results to return per page. Maximum allowed value is 100.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPO_NOTIFICATIONS_FOR_AUTH_USERRetrieves notifications for the authenticated user from a specified repository, to which the user must have access.
Input parameters
If `true`, shows notifications marked as read; otherwise, only unread notifications are returned.
The page number of the results to retrieve.
The name of the repository, without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
Only includes notifications last updated on or after this ISO 8601 UTC timestamp (e.g., `YYYY-MM-DDTHH:MM:SSZ`).
Only includes notifications last updated before this ISO 8601 UTC timestamp (e.g., `YYYY-MM-DDTHH:MM:SSZ`).
The number of notifications to return per page. Maximum value is 100.
If `true`, shows only notifications in which the authenticated user is directly participating or was mentioned.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPO_SECRETS_WITHOUT_VALUESLists all Codespaces secrets available in a specific repository, without their encrypted values.
Input parameters
Page number of the results to retrieve. Used for pagination.
The name of the repository, without the `.git` extension. This is not case-sensitive.
The username of the account that owns the repository. This is not case-sensitive.
Number of secrets to return per page. Maximum value is 100.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORIES_ACCESSIBLE_TO_THE_APP_INSTALLATIONLists repositories a GitHub App installation can access. IMPORTANT: This endpoint requires a GitHub App installation access token (ghs_* prefix) for authentication. OAuth/user access tokens (gho_*) or personal access tokens are not supported and will result in a 403 Forbidden error. Returns 'total_count' and 'repositories' array with pagination support.
Input parameters
Page number of the results to fetch.
Number of results per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORIES_FOR_A_USERLists public repositories for a specified GitHub user, who must have an existing account.
Input parameters
Page number for results (starts from 1). See GitHub REST API pagination docs for more info.
Sort criterion: `created` (default), `updated`, `pushed`, or `full_name` (repository name). When not specified, GitHub API defaults to `created`.
Filter for repository type: `all` (owned or member), `owner` (directly owned), `member` (user is a public member), or `public` (public repositories only). When omitted, API returns all public repositories.
Number of results per page (max 100). See GitHub REST API pagination docs for more info.
GitHub username, e.g., 'octocat'.
Sort direction: `asc` (ascending) or `desc` (descending). When not specified, defaults to `asc` for `full_name` sort, and `desc` for all other sort options.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORIES_FOR_THE_AUTHENTICATED_USERLists repositories for the authenticated user; using 'type' with 'visibility' or 'affiliation' API parameters (not in this model) can cause a 422 error.
Input parameters
Page number of results to fetch.
The repository property by which to sort the results.
Filters the results to repositories of the specified type.
Filters for repositories updated at or after this specified time. Provide as an ISO 8601 formatted timestamp.
Filters for repositories updated before this specified time. Provide as an ISO 8601 formatted timestamp.
The number of results to return per page (maximum 100).
The direction of the sort. Defaults to `asc` when `sort` is 'full_name', and `desc` otherwise.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORIES_STARRED_BY_A_USERLists repositories a valid and existing GitHub user has starred.
Input parameters
Page number of the results to retrieve (starts from 1). For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The criteria for sorting the starred repositories. `created` sorts by the date the repository was starred. `updated` sorts by the date the repository was last pushed to.
The number of results to display per page (max 100). For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The GitHub username of the user whose starred repositories are to be listed.
The direction for sorting the results. Can be `asc` for ascending or `desc` for descending.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORIES_STARRED_BY_THE_AUTHENTICATED_USERLists repositories the authenticated user has starred, optionally sorted and paginated, including star creation timestamps via 'application/vnd.github.star+json' media type.
Input parameters
Page number of results (starts from 1).
Sorts starred repositories by 'created' (date starred) or 'updated' (date last pushed).
Number of results per page (max 100). Defaults to 30.
Sort direction: 'asc' (ascending) or 'desc' (descending).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORIES_WATCHED_BY_A_USERLists repositories a given GitHub user is watching; the username must be a valid and existing GitHub user handle.
Input parameters
Page number of results (starts from 1).
Number of results per page (max 100).
The GitHub username (case-sensitive).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORIES_WATCHED_BY_THE_AUTHENTICATED_USERLists repositories the authenticated user is watching (subscribed to for notifications). This action retrieves a list of repositories that the authenticated user is currently watching. It allows the user to manage their watched repositories effectively.
Input parameters
Page number of the results to retrieve.
Number of results per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORIES_WITH_GITHUB_ACTIONS_CACHE_USAGERetrieves a paginated list of GitHub Actions cache usage statistics for repositories within an existing GitHub organization.
Input parameters
The name of the GitHub organization for which to retrieve repository cache usage. This name is not case-sensitive.
The page number for the set of results to fetch.
The number of repository cache usage results to return per page (maximum is 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORY_ACTIVITIESLists activities for a GitHub repository, ensuring the repository exists and is accessible.
Input parameters
The Git reference for which to list activities (e.g., a branch name like `main` or a full ref like `refs/heads/main`). If unspecified, activities from all branches are listed.
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The GitHub username of the person who performed the activity. Filters activities to only those performed by this user.
A pagination cursor. Returns activity items that occurred after this cursor. This cursor is typically obtained from the `Link` header in a previous API response. For more details, see GitHub's REST API documentation on "Using pagination in the REST API" and "Using Link headers".
The account owner of the repository (e.g., a GitHub username or organization name). This name is not case-sensitive.
A pagination cursor. Returns activity items that occurred before this cursor. This cursor is typically obtained from the `Link` header in a previous API response. For more details, see GitHub's REST API documentation on "Using pagination in the REST API" and "Using Link headers".
The number of activity results to return per page. Defaults to 30, maximum is 100. For more information, see the GitHub REST API guide on "Using pagination in the REST API".
The direction to sort the activity results. Use 'asc' for ascending (oldest first) or 'desc' for descending (newest first).
Filters activities based on a predefined time period. For example, 'day' retrieves activities from the last 24 hours, and 'week' from the last 7 days (168 hours).
Filters activities by a specific type, such as 'push' or 'pr_merge'. If unspecified, all relevant activity types are returned.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORY_AUTOLINKSRetrieves all autolinks (e.g., for JIRA issues) configured for a repository; requires admin permissions on the repository.
Input parameters
The repository name, excluding `.git`. Case-insensitive.
The account owner's username. Case-insensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORY_COLLABORATORSLists collaborators for a specified repository, provided it exists and is accessible to the authenticated user.
Input parameters
The page number of the results to retrieve.
The name of the repository, without the `.git` extension. This value is not case sensitive.
The username of the account that owns the repository. This value is not case sensitive.
The number of results to return per page. Maximum value is 100.
Filter collaborators by their repository permission level. If not specified, all collaborators are returned regardless of permission.
Filter collaborators by affiliation: 'outside' (collaborators of an organization-owned repository not part of the org), 'direct' (collaborators with direct permissions to an organization-owned repository), or 'all' (all collaborators visible to the authenticated user).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORY_CONTRIBUTORSLists contributors to a specified repository, sorted by number of contributions in descending order; the repository must exist and be accessible.
Input parameters
Set to '1' or 'true' to include anonymous contributors. If omitted, anonymous contributors are not included.
Page number of results to retrieve (1-based indexing).
Name of the repository (without `.git` extension). Not case-sensitive.
Username of the account owning the repository. Not case-sensitive.
Number of contributor results per page. Maximum value is 100.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORY_EVENTSLists chronological events (e.g., code pushes, issue activities, PR actions, forks) for a specified, existing GitHub repository.
Input parameters
Page number for paginating results.
Repository name, without the `.git` extension (not case-sensitive).
Owner's username or organization name (not case-sensitive).
Number of events to return per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORY_INVITATIONSRetrieves all pending (unaccepted or undeclined) collaboration invitations for a specified GitHub repository.
Input parameters
Page number of the results to retrieve.
The name of the repository, without the '.git' extension. This field is not case-sensitive.
The username of the account that owns the repository. This field is not case-sensitive.
Number of results to return per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORY_ISSUESLists issues (including pull requests) from a GitHub repository. Requires BOTH 'owner' AND 'repo' parameters (e.g., owner='octocat', repo='Hello-World' for github.com/octocat/Hello-World).
Input parameters
Page number for the set of results. Refer to GitHub's REST API documentation for pagination details.
REQUIRED. The name of the repository (without .git extension). For 'octocat/Hello-World', repo is 'Hello-World'. Not case-sensitive. Must be provided together with 'owner'.
The field to sort the results by.
Filter issues by type name. Use '*' for issues with any type, 'none' for issues without a type, or specify a type name.
REQUIRED. The GitHub account owner (user or organization) of the repository. For 'octocat/Hello-World', owner is 'octocat'. Not case-sensitive. Must be provided together with 'repo'.
Filters issues to include only those updated at or after the specified time. This should be a timestamp in ISO 8601 format (e.g., `YYYY-MM-DDTHH:MM:SSZ`).
Filters issues based on their state.
A comma-separated list of label names to filter issues by. Example: 'bug,ui,@high'.
Filter issues by the username of the user who created the issue.
Filter issues by assignee's username. Use 'none' for issues with no assignee, or '*' for issues assigned to any user.
Number of results per page (max 100). Default is 30, which matches GitHub's API default. Refer to GitHub's REST API documentation for pagination details.
The direction of the sort.
Filter issues by a user mentioned in the issue's description or comments. Provide the username.
Filter issues by milestone. Provide the milestone `number` as a string, '*' for issues with any milestone, or 'none' for issues without a milestone.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORY_LANGUAGESLists the programming languages used in a GitHub repository, returning a byte count for each language.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository (username or organization name). This name is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORY_ORGANIZATION_SECRETSLists names of organization-level secrets shared with the specified repository; actual secret values are not returned and visibility depends on token access.
Input parameters
Page number for paginated results.
Name of the repository, without the `.git` extension (case-insensitive).
The username or organization name that owns the repository (case-insensitive).
Number of secrets per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORY_ORGANIZATION_VARIABLESLists organization-level variables that are shared with a specific repository. The repository must belong to an organization (not a personal account).
Input parameters
Page number of results. For pagination details, see GitHub REST API docs.
Name of the repository, without the `.git` extension (case-insensitive).
The organization name that owns the repository (case-insensitive). This endpoint only works for organization repositories, not personal account repositories.
Number of results per page (max 30). For pagination details, see GitHub REST API docs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORY_PROJECTSLists Projects (classic) associated with a specific repository. Note: This action lists GitHub Projects (classic), which is GitHub's legacy project management feature. If the repository has Projects (classic) disabled or uses the newer Projects V2, this will return an empty list. Most modern repositories use Projects V2 (GraphQL API) instead of Projects (classic).
Input parameters
Page number of the results to retrieve.
Name of the repository, without the `.git` extension (case-insensitive).
Username of the account owning the repository (case-insensitive).
Filters projects by their state.
Number of projects to return per page (maximum 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORY_RULESETSRetrieves all rulesets for a GitHub repository, which define conditions and actions for repository interactions (e.g., branch protections).
Input parameters
Page number for pagination.
Name of the repository, without `.git` extension (case-insensitive).
Username or organization name of the repository owner (case-insensitive).
Number of rulesets per page (max 100).
If `True`, also fetches rulesets from parent levels (e.g., organization) applicable to this repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORY_RULE_SUITESLists rule suite evaluations for a repository, allowing filtering by ref (non-wildcard), time period, actor, and result.
Input parameters
The ref (e.g., branch or tag name) to filter by; cannot contain wildcard characters. If provided, only evaluations for this ref are returned.
Page number of results to retrieve.
The name of the repository, without the '.git' extension. This field is not case-sensitive.
The username of the account or the organization name that owns the repository. This field is not case-sensitive.
Number of results per page (max 100).
GitHub username of the actor to filter by. If specified, only evaluations triggered by this user are returned.
Time period to filter rule suites: 'hour' (last hour), 'day' (last 24 hours), 'week' (last 7 days), or 'month' (last 30 days).
Filter rule suites by evaluation outcome (e.g., 'pass', 'fail', 'bypass').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORY_SECRETSLists metadata for all secrets in a GitHub repository, excluding their encrypted values.
Input parameters
Page number of the results to fetch.
The name of the repository, without the `.git` extension. The name is not case-sensitive.
The GitHub account owner of the repository. This is typically a username or organization name. The name is not case-sensitive.
Number of secrets per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORY_SECRETS_WITHOUT_DECRYPTINGLists metadata (e.g., name, creation/update dates) for all Dependabot secrets in a repository; secret values are not included.
Input parameters
Page number of the results to retrieve (starts from 1).
The name of the repository, without the `.git` extension. This field is not case sensitive.
The account owner of the repository (e.g., a GitHub username or organization name). This field is not case sensitive.
Number of secrets to return per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORY_SECURITY_ADVISORIESTool to list security advisories for a repository. Use when you need to retrieve security advisories published for a specific repository, optionally filtered by state.
Input parameters
The name of the repository without the .git extension. The name is not case sensitive.
The property to sort the results by.
A cursor for pagination. If specified, the query only searches for results after this cursor.
The account owner of the repository. The name is not case sensitive.
Filter by state of the repository advisories. Only advisories of this state will be returned.
A cursor for pagination. If specified, the query only searches for results before this cursor.
The number of advisories to return per page.
The direction to sort the results by.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORY_TAGSLists tags for a specified GitHub repository.
Input parameters
The page number of the results to retrieve for pagination.
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
The number of tag results to return per page; maximum 100.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORY_TEAMSLists all teams with explicit permission to access the specified repository; the repository must exist.
Input parameters
Page number of the results to retrieve.
The name of the repository, without the `.git` extension. This value is not case-sensitive.
The username of the account that owns the repository. This value is not case-sensitive.
The number of team results to return per page (maximum 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORY_TOPICSRetrieves all topics for a specified, existing, and accessible repository.
Input parameters
Page number of the results to fetch.
Name of the repository, without the `.git` extension (case-insensitive).
Account owner of the repository (case-insensitive).
Number of results per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORY_VARIABLESLists plain text key-value variables for GitHub Actions workflows within a specific, accessible repository.
Input parameters
Page number of the results to fetch.
The name of the repository, without the `.git` extension. The name is not case sensitive.
The account owner of the repository. This can be a username or an organization name. The name is not case sensitive.
Number of repository variables to return per page (maximum 30).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORY_WEBHOOKSRetrieves a list of webhooks for a repository, which must exist and be accessible.
Input parameters
Page number of the results to retrieve.
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository (e.g., a GitHub username or organization name). This name is not case-sensitive.
Number of webhook results per page. Maximum is 100.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REPOSITORY_WORKFLOWSLists all GitHub Actions workflows for a specified repository, which must exist and be accessible.
Input parameters
The page number of the results to fetch.
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
The number of workflow results to return per page. Maximum value is 100.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REQUESTED_REVIEWERS_FOR_A_PULL_REQUESTGets all users and teams requested to review a specific pull request in a repository.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The number that identifies the pull request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REVIEW_COMMENTS_IN_A_REPOSITORYLists all review comments on all pull requests within a specified repository.
Input parameters
Page number for the results to retrieve.
The name of the repository, without the `.git` extension. This name is not case-sensitive.
Sort field for review comments: `created` (creation time), `updated` (last update time), or `created_at` (creation timestamp). Defaults to API's standard sort order (typically by ID, ascending) if unspecified.
The username of the account that owns the repository. This name is not case-sensitive.
Filters for comments updated at or after this ISO 8601 timestamp (e.g., `YYYY-MM-DDTHH:MM:SSZ`).
Number of review comments per page (max 100).
Sort direction (`asc` or `desc`). Effective only if `sort` is specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REVIEW_COMMENTS_ON_A_PULL_REQUESTLists all review comments on a specific pull request within a GitHub repository.
Input parameters
Page number of results to retrieve.
Name of the repository, without the `.git` extension. Not case sensitive.
Sort review comments by `created` or `updated`.
Username of the account owning the repository. Not case sensitive.
Only include comments updated at or after this ISO 8601 timestamp (`YYYY-MM-DDTHH:MM:SSZ`).
Number of comments per page (max 100).
Sort direction (`asc` or `desc`); ignored if `sort` is not provided.
Unique number identifying the pull request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_REVIEWS_FOR_A_PULL_REQUESTLists submitted reviews chronologically for a specific pull request within a GitHub repository.
Input parameters
The page number for the set of results to retrieve.
The name of the repository, without the `.git` extension. This name is not case sensitive.
The account owner of the repository (e.g., a GitHub username or organization name). This name is not case sensitive.
The number of review results to display per page. Maximum 100.
The unique number identifying the pull request within the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_RUNNER_APPLICATIONS_FOR_AN_ORGANIZATIONLists downloadable GitHub Actions runner application binaries for setting up self-hosted runners in a GitHub organization. Returns download URLs and checksums for various OS/architecture combinations (linux/win/osx on x64/arm/arm64). Requires admin:org scope or fine-grained 'Self-hosted runners' read permission.
Input parameters
The name of the GitHub organization. This name is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_RUNNER_APPLICATIONS_FOR_A_REPOSITORYLists available self-hosted runner application binaries for a specific repository, including their OS, architecture, and download URL.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username of the account or the name of the organization that owns the repository. This field is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_SECRET_SCANNING_ALERTS_FOR_A_REPOSITORYList secret scanning alerts for a GitHub repository using first-party detections. Use this to retrieve detected secrets with filtering by state, type, resolution, and validity. Supports optional hiding of secret literals for security.
Input parameters
Page number of results to fetch.
The name of the repository without .git extension. The name is not case sensitive.
Sort alerts by 'created' or 'updated' timestamp.
Cursor for pagination to fetch results after this cursor.
The account owner of the repository. The name is not case sensitive.
Filter alerts by state: 'open' for unresolved alerts or 'resolved' for resolved alerts.
Cursor for pagination to fetch results before this cursor.
Filter by assignee. Use '*' for any assigned alerts, 'none' for unassigned alerts, or a specific GitHub username.
Number of results per page, maximum 100.
Filter by token validity status: 'active' (token still valid), 'inactive' (token revoked/expired), or 'unknown' (validity cannot be determined).
Sort direction: 'asc' for ascending or 'desc' for descending.
Comma-separated list of resolutions to filter by. Valid values: 'false_positive', 'wont_fix', 'revoked', 'pattern_edited', 'pattern_deleted', 'used_in_tests'.
Hide the literal secret value from API response for security. When true, the 'secret' field will be omitted from results.
Comma-separated list of secret types to filter by (e.g., 'github_personal_access_token,aws_access_key_id').
Filter by multi-repo tag presence. True returns only alerts found in multiple repositories.
Filter by publicly-leaked status. True returns only alerts for secrets that were found publicly exposed.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_SECRETS_FOR_THE_AUTHENTICATED_USERLists all Codespaces secrets accessible to the authenticated user for use within GitHub Codespaces.
Input parameters
The page number of the results to retrieve (starts from 1).
The number of secrets to return per page (up to 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_SECURITY_ADVISORIES_GRAPHQLTool to list GitHub Security Advisories using the GraphQL API. Use when you need to query security vulnerabilities and malware advisories from the GitHub Advisory Database with advanced filtering and pagination options.
Input parameters
Returns the last n elements from the list. Cannot be used with 'first'.
Returns the elements in the list that come after the specified cursor. Used for pagination.
Returns the first n elements from the list. Cannot be used with 'last'.
Returns the elements in the list that come before the specified cursor. Used for pagination.
Ordering options for security advisory connections.
Filter for security advisory identifiers.
Filter advisories to those updated since a time in the past. ISO 8601 datetime string.
The EPSS (Exploit Prediction Scoring System) percentage to filter advisories by. Range: 0.0 to 1.0.
The EPSS percentile to filter advisories by. Range: 0.0 to 1.0.
Filter advisories to those published since a time in the past. ISO 8601 datetime string.
List of classifications to filter advisories by.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_SECURITY_VULNERABILITIESQuery software vulnerabilities documented by GitHub Security Advisories using GraphQL. Use this to find security issues in packages across ecosystems like npm, pip, maven, etc.
Input parameters
Returns the last n elements from the list. Maximum value is 100.
Returns the elements in the list that come after the specified cursor. Use the endCursor from pageInfo in the previous response.
Returns the first n elements from the list. Maximum value is 100.
Returns the elements in the list that come before the specified cursor. Use the startCursor from pageInfo in the previous response.
A package name to filter vulnerabilities by (e.g., 'lodash', 'django').
The possible ecosystems of a security advisory.
A list of severities to filter vulnerabilities by. Can include multiple values.
Properties by which security vulnerability connections can be ordered.
A list of advisory classifications to filter vulnerabilities by.
Possible directions in which to order a list of items.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_SELECTED_REPOSITORIES_FOR_AN_ORGANIZATION_SECRETLists repositories that have been granted access to a Codespaces organization secret. Returns all repositories that have been selected when the visibility for repository access to a Codespaces secret is set to 'selected'. Requires admin:org scope and admin access to the organization. Note: This endpoint only returns results when the secret's visibility is set to 'selected'. Secrets with visibility 'all' or 'private' do not have specific repository selections.
Input parameters
The organization name. The name is not case sensitive.
Page number of the results to fetch (starts at 1).
Number of results per page (max 100).
The name of the Codespaces secret. The secret must have its visibility set to 'selected' to return results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_SELECTED_REPOSITORIES_FOR_A_USER_SECRETLists repositories that have access to the specified user Codespaces secret. This endpoint retrieves all repositories that the authenticated user has granted access to for a specific user-level Codespaces secret. The secret must already exist for this endpoint to work. Use 'list_secrets_for_the_authenticated_user' to discover available secrets first. Note: The authenticated user must have Codespaces access enabled. OAuth tokens and personal access tokens require the 'codespace' or 'codespace:secrets' scope.
Input parameters
Page number of the results to retrieve.
Number of results to return per page (max 100).
The name of the user Codespaces secret. Secret names are case-sensitive and must be alphanumeric with underscores (e.g., 'MY_API_TOKEN', 'DATABASE_URL').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_SELECTED_REPOSITORIES_FOR_SECRET_ACCESSLists repositories within a specified organization that have been granted access to a particular Dependabot secret. Note: This endpoint only returns results when the secret's visibility is set to 'selected'. Secrets with visibility 'all' or 'private' do not have specific repository selections. Requires 'admin:org' scope and the user must have admin access to the organization.
Input parameters
The name of the GitHub organization. This field is not case-sensitive.
The page number of the results to retrieve, starting at 1.
The number of results to return per page, with a maximum of 100.
The name of the Dependabot secret (with visibility set to 'selected') for which to list repository access.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_SELECTED_REPOS_ORG_VARIABLELists repositories in an organization that can access a specific organization variable; supports pagination and returns an empty list if no repositories have been granted access. Note: This endpoint only works for variables with visibility set to 'selected' - attempting to use it on variables with 'all' or 'private' visibility will result in a 409 Conflict error.
Input parameters
The organization's name (case-insensitive).
The name of the variable.
Page number for pagination.
Number of results per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_SELF_HOSTED_RUNNERS_FOR_AN_ORGANIZATIONLists self-hosted runners for a GitHub organization, optionally filtering by name and paginating results, providing details for each runner such as OS, status, and labels.
Input parameters
The GitHub organization name (case-insensitive).
Name to filter the list of self-hosted runners.
Page number for results retrieval (starts at 1).
Number of results per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_SELF_HOSTED_RUNNERS_FOR_A_REPOSITORYLists all self-hosted runners configured for a repository.
Input parameters
The name of a specific self-hosted runner to filter by. If not provided, all runners for the repository are listed.
The page number of the results to fetch, starting from 1. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The number of results per page (maximum 100). For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_SOCIAL_ACCOUNTS_FOR_A_USERLists social media accounts publicly linked to an existing GitHub user's profile.
Input parameters
The page number of the results to fetch when paginating. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The number of social account results to return per page. Maximum is 100. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The handle (username) of the GitHub user (e.g., 'octocat') for whom to list social media accounts.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_SOCIAL_ACCOUNTS_FOR_THE_AUTHENTICATED_USERLists all social media accounts linked to the authenticated user's GitHub profile. This action retrieves the social media accounts associated with the user's GitHub profile, allowing for easy management and visibility of connected accounts. The results include accounts such as Twitter, LinkedIn, and other platforms linked to the GitHub profile.
Input parameters
Page number of the results to retrieve.
Number of social accounts to return per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_SPONSORABLESTool to list users and organizations who can be sponsored via GitHub Sponsors. Use when you need to discover sponsorable entities with optional filtering by dependency ecosystem.
Input parameters
Returns the last n elements from the list. Use for backward pagination.
Returns elements following the specified cursor. Use for forward pagination with first parameter.
Returns the first n elements from the list. Use for forward pagination.
Returns elements preceding the specified cursor. Use for backward pagination with last parameter.
Ecosystem of a dependency graph package.
Field to order sponsorables by.
If true, restricts results to sponsorables owning the authenticated viewer's dependencies. Requires authentication.
Direction for ordering results.
Organization username to check dependencies against. Used with only_dependencies to filter sponsorables owning this organization's dependencies.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_SSH_SIGNING_KEYS_FOR_A_USERLists the public SSH signing keys for a specified GitHub user.
Input parameters
The page number of the results to fetch. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The number of results per page (max 100). For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The handle for the GitHub user account.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_STARGAZERSLists users who have starred the specified GitHub repository, which must exist.
Input parameters
Page number of the results to fetch.
Name of the repository, without the `.git` extension; case-insensitive.
Username of the account owner (user or organization) of the repository; case-insensitive.
Number of results to display per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_STARRED_GISTSRetrieves a list of gists starred by the authenticated user.
Input parameters
Page number of the results to fetch.
Timestamp in ISO 8601 format (`YYYY-MM-DDTHH:MM:SSZ`) to filter gists updated after this time.
Number of results per page (maximum 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_STATUS_CHECK_CONTEXTSFetches all required status check contexts for a protected branch; returns an empty list if the branch isn't protected or has no required checks.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository. This name is not case-sensitive.
The exact name of the branch (case-sensitive). Wildcard characters (e.g., `*`) are not permitted. For operations involving branches with wildcard patterns, the GitHub GraphQL API should be utilized.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_SUB_ISSUESTool to list sub-issues for a specific GitHub issue. Use when you need to retrieve all sub-issues associated with a parent issue, supporting pagination for large hierarchies.
Input parameters
The page number of the results to fetch. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The number of results per page (max 100). For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The number that identifies the issue.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_SUBSCRIPTIONS_FOR_THE_AUTHENTICATED_USERTool to list GitHub Marketplace subscriptions for the authenticated user. Use when you need to retrieve active marketplace app subscriptions including billing details, plan information, and trial status. Returns subscription information with account, plan, billing cycle, and pricing details.
Input parameters
The page number of the results to fetch. For more information, see "Using pagination in the REST API".
The number of results per page (max 100). For more information, see "Using pagination in the REST API".
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_SUBSCRIPTIONS_FOR_THE_AUTHENTICATED_USER_STUBBEDLists the authenticated user's stubbed (test/example data, not live) GitHub Marketplace subscriptions, useful for development or testing.
Input parameters
Page number of results to fetch (starts from 1).
Number of results per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_TAG_PROTECTION_STATES_FOR_A_REPOSITORYDEPRECATED: Lists tag protection rules for a repository. This API was sunset on August 30, 2024. Use GITHUB_GET_ALL_REPOSITORY_RULESETS instead to view tag protection rules via repository rulesets.
Input parameters
The name of the repository, without the `.git` extension. This name is not case sensitive.
The account owner of the repository. This name is not case sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_TEAM_MEMBERSLists members of a specific team within an organization, including members of child teams.
Input parameters
Organization name (case-insensitive).
Page number for results.
Filters members by their role in the team.
Number of results per page (maximum 100).
Team slug (URL-friendly name).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_TEAM_PROJECTSLists GitHub projects accessible to a specific team within an organization.
Input parameters
Name of the GitHub organization (case-insensitive). E.g., 'MyOrg' for github.com/MyOrg.
Page number for pagination.
Number of project results per page (max 100).
The team's URL-friendly slug (e.g., 'web-developers' for 'Web Developers').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_TEAM_REPOSITORIESLists repositories accessible to a specific team within a GitHub organization. Returns a list of repositories that the specified team has access to, including the team's permission level (admin, maintain, push, triage, pull) for each repository. Requires read:org scope and membership in the organization to access team data.
Input parameters
The name of the GitHub organization (case-insensitive). Example: 'octo-org'.
Page number of results to fetch. Default: 1.
Number of results per page (1-100). Default: 30.
The URL-friendly slug of the team name (lowercase with dashes). Example: 'justice-league'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_TEAMSLists teams for a specified GitHub organization.
Input parameters
The name of the GitHub organization. This field is not case-sensitive.
The page number of the results to fetch when paginating through the list of teams.
The number of team results to return per page. Maximum value is 100.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_TEAMS_FOR_THE_AUTHENTICATED_USERLists all teams across all organizations to which the authenticated user belongs, supporting pagination.
Input parameters
Page number of the results to retrieve.
Number of team results to return per page (max 100). For more information, refer to GitHub's documentation on API pagination.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_TEAMS_THAT_ARE_ASSIGNED_TO_AN_ORGANIZATION_ROLELists teams assigned to a specific role within a GitHub organization. This endpoint requires organization administrator privileges. Use this to audit which teams have been granted specific organization-level permissions through roles. Note: Organization roles is a feature for enterprise-level GitHub organizations.
Input parameters
Name of the GitHub organization (case-insensitive). You must be an administrator of this organization.
Page number of results to fetch (starts at 1).
Unique numerical identifier of the organization role. Use 'Get all organization roles' to find valid role IDs.
Number of results per page (1-100). Default is 30.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_THE_PEOPLE_A_USER_FOLLOWSLists GitHub users that a valid GitHub `username` is following, supporting pagination.
Input parameters
Page number for the results to retrieve (starts from 1).
Number of results to return per page (maximum 100).
GitHub username (case-sensitive) of the user.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_THE_PEOPLE_THE_AUTHENTICATED_USER_FOLLOWSLists people the authenticated user follows.
Input parameters
Page number for paginated results.
Number of results per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_TIMELINE_EVENTS_FOR_AN_ISSUELists chronological events (e.g., comments, commits, label changes) for a specific issue in a GitHub repository.
Input parameters
Page number for results.
Name of the repository, without the `.git` extension (not case-sensitive).
Account owner of the repository (not case-sensitive).
Number of events per page (max 100).
Number identifying the issue within the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_TOKEN_ACCESS_REPOSITORIESLists repositories in an organization that a fine-grained personal access token has access to. Requires organization admin permissions or 'Personal access tokens' organization read permission. Only GitHub Apps can use this endpoint.
Input parameters
The organization name (case-insensitive). You must be an organization owner or have the 'Personal access tokens' organization permission to use this endpoint.
Page number of the results to fetch. Default: 1.
The unique numeric identifier of the fine-grained personal access token. You can obtain this ID from the 'list_org_resource_access_tokens' action.
Number of results per page (max 100). Default: 30.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_USER_PROJECTSRetrieves a list of projects for a specified GitHub user, optionally filtering by state and supporting pagination; the username must be a valid GitHub handle. Note: This action uses GitHub's Projects V2 GraphQL API. The legacy Projects V1 REST API has been sunset by GitHub.
Input parameters
Page number for pagination.
Filter projects by state.
Number of results per page (max 100).
GitHub username (handle).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_USERSRetrieves all GitHub users (individuals and organizations) in chronological order of their sign-up date.
Input parameters
A user ID. If provided, only users with an ID greater than this ID will be returned. This parameter facilitates pagination. If omitted, the list starts from the first user.
Specifies the number of user results to return per page. The maximum allowed value is 100.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_USERS_BLOCKED_BY_AN_ORGANIZATIONLists users blocked by a specified GitHub organization.
Input parameters
The organization name. This name is not case sensitive.
Specifies the page number of the results to fetch. Default is 1. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
Specifies the number of results to return per page, with a maximum of 100. Default is 30. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_USERS_BLOCKED_BY_THE_AUTHENTICATED_USERLists users blocked by the authenticated user, returning an empty list if no users are blocked.
Input parameters
The page number of the results to retrieve.
The number of results per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_USERS_THAT_ARE_ASSIGNED_TO_AN_ORGANIZATION_ROLELists users assigned to a specific role within a GitHub organization.
Input parameters
The name of the GitHub organization. This is not case-sensitive.
Page number of results (1-indexed).
The unique identifier for the organization role. Use the 'Get all organization roles' action first to retrieve valid role IDs.
Number of results per page (maximum 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_WATCHERSRetrieves a list of users watching a specific repository; the repository must be accessible to the authenticated user.
Input parameters
Page number of the results to retrieve.
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username of the account that owns the repository. This field is not case-sensitive.
Number of results to return per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_WORKFLOW_RUN_ARTIFACTSLists artifacts (e.g., build outputs, test results) for a specific workflow run in a GitHub repository.
Input parameters
If specified, filters artifacts by this exact name.
Page number of results to fetch.
Repository name, without the `.git` extension (not case sensitive).
Account owner of the repository (not case sensitive).
Unique identifier of the workflow run.
Number of results per page (max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_WORKFLOW_RUNS_FOR_A_REPOSITORYLists workflow runs for a repository, allowing filtering by actor, branch, event, status, creation date, check suite ID, or head SHA; the repository must exist and be accessible.
Input parameters
Page number of the results to fetch.
The name of the repository, without the `.git` extension (not case-sensitive).
Filter by the actor's login (e.g., the user who triggered the `push`).
Filter by the event that triggered the workflow (e.g., `push`, `pull_request`).
The account owner of the repository (not case-sensitive).
Filter by branch name (e.g., `main` or the branch that triggered the `push`).
Filter by `status` or `conclusion` (e.g., `success`, `in_progress`). Note: Only GitHub Actions can set `waiting`, `pending`, or `requested`.
Filter by creation date or date-time range (ISO8601 format: YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ). Supports operators like `>`, `<`, `>=`, `<=`, and `..` for ranges.
Filter to include only runs associated with the specified `head_sha` (commit SHA at the head of the branch).
Number of results per page (maximum 100).
Filter by a specific `check_suite_id`.
Set to `true` to exclude workflow runs triggered by pull request events. Omit or leave as null to include all runs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LIST_WORKFLOW_RUNS_FOR_A_WORKFLOWLists runs for a specified, existing workflow (identified by ID or filename like `main.yml`) in a GitHub repository, with filtering options.
Input parameters
Page number of the results to retrieve.
Repository name, without the `.git` extension (case-insensitive).
Filter by the GitHub username of the actor who initiated the run.
Filter by the event that triggered the run (e.g., `push`, `pull_request`). For more event types, see GitHub's documentation on "Events that trigger workflows".
Account owner of the repository (case-insensitive).
Filter by branch name, typically for `push` events.
Filter by status or conclusion (e.g., `success`, `in_progress`). Note: `waiting`, `pending`, or `requested` statuses are set exclusively by GitHub Actions.
Filter by creation date/time range. For syntax, refer to GitHub's "Understanding the search syntax" guide for dates.
Filter by the head commit's SHA.
Number of results per page (max 100).
The ID of the workflow (integer) or the workflow file name (string, e.g., `main.yml` or `ci.yaml`).
Filter by `check_suite_id` (identifier for a collection of check runs).
If true, exclude workflow runs triggered by pull requests.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LOCK_AN_ISSUELocks an existing GitHub issue's conversation, preventing further comments; an optional reason can be specified.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The username of the account that owns the repository. This name is not case-sensitive.
Optional reason for locking the conversation. Valid values: 'off-topic', 'too heated', 'resolved', 'spam'. If omitted, no reason is displayed.
The number that uniquely identifies the issue to be locked within the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LOOKUP_ENTERPRISE_ADMINISTRATOR_INVITATIONTool to look up a pending enterprise administrator invitation by invitee, enterprise, and role. Use when you need to check if a specific user has a pending invitation to become an enterprise administrator.
Input parameters
The role for the enterprise administrator invitation. Must be one of: OWNER, BILLING_MANAGER, or UNAFFILIATED.
The login (username) of the user invited to join the enterprise as an administrator.
The slug of the enterprise the user was invited to join. This is the URL-friendly identifier for the enterprise.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LOOKUP_GITHUB_RESOURCETool to lookup a GitHub resource by its URL. Use when you need to identify or retrieve information about a GitHub resource from its URL.
Input parameters
The GitHub URL of the resource to lookup. Can be a repository, issue, pull request, or other GitHub resource URL.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LOOKUP_NODES_BY_IDSTool to lookup GitHub nodes by their global node IDs. Use when you need to retrieve multiple objects by their IDs in a single batch query.
Input parameters
A list of GitHub global node IDs to lookup. Each ID must be a valid base64-encoded global node ID (e.g., 'MDQ6VXNlcjU4MzIzMQ==').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LOOKUP_ORGANIZATION_GRAPH_QLTool to lookup a GitHub organization by login using GraphQL. Use when you need organization information via GraphQL API.
Input parameters
The organization's login username to look up. Case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_LOOKUP_TOPIC_BY_NAMETool to look up a GitHub topic by name using GraphQL. Use when you need to find information about a specific GitHub topic including its popularity (stargazer count) and related topics.
Input parameters
The topic's name to look up (e.g., 'python', 'javascript', 'machine-learning').
The number of related topics to fetch (between 1 and 10). Only used if include_related_topics is true.
Whether to include related topics in the response. If true, up to 3 related topics will be returned.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_MANAGE_ACCESS_CONTROL_FOR_ORGANIZATION_CODESPACESSets the Codespaces access control policy for a GitHub organization, determining which members can use them. This endpoint requires admin permissions on the organization. The API returns HTTP 204 No Content on success.
Input parameters
The name of the GitHub organization (case-insensitive). The authenticated user must have admin permissions on this organization.
Defines which users can access Codespaces within the organization. `disabled`: Codespaces are disabled for all users in the organization. `selected_members`: Only users specified in `selected_usernames` can access Codespaces. `all_members`: All members of the organization can access Codespaces. `all_members_and_outside_collaborators`: All members and outside collaborators can access Codespaces.
A list of GitHub usernames who should have access to Codespaces. Required when `visibility` is set to `selected_members`. Providing a list here will replace any existing list of selected usernames. The specified users must be members or outside collaborators of the organization.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_MANAGE_CUSTOM_PROPERTIES_FOR_ORG_REPOSCreates or updates values for an organization's predefined custom properties across multiple repositories (up to 30).
Input parameters
The organization's name (case-insensitive).
JSON string containing an array of custom properties to set. Each must have `property_name` (predefined for the organization) and `value`. Example: '\[{"property_name": "project-status", "value": "active"}\]'
Repository names (max 30) to apply the custom property values to.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_MANAGE_SECRETS_IN_SELECTED_REPOSITORIESLists repositories within an organization that have been explicitly granted access to a specific GitHub Actions organization secret. Returns all repositories that have been selected when the visibility for repository access to an Actions secret is set to 'selected'. Requires admin:org scope and admin access to the organization. Note: This endpoint only returns results when the secret's visibility is set to 'selected'. Secrets with visibility 'all' or 'private' do not have specific repository selections.
Input parameters
The name of the GitHub organization. This name is not case-sensitive.
Page number of the results to fetch. Default is 1. See '\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)' for more details.
Number of results to return per page (maximum 100). Default is 30. See '\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)' for more details.
The name of the organization secret for which to list accessible repositories.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_MAP_A_COMMIT_AUTHORUpdates Git author information (name and/or email) for an `author_id` obtained during a repository import, to correctly attribute commits. NOTE: This endpoint has been deprecated by GitHub as of April 12, 2024, and is no longer available. The Source Imports REST API has been retired due to very low usage levels. Please use the GitHub Importer tool at https://github.com/new/import for repository imports.
Input parameters
New Git author name for the `author_id`. At least one of `email` or `name` must be provided.
Name of the repository, without the `.git` extension (not case-sensitive).
New Git author email for the `author_id`. At least one of `email` or `name` must be provided.
Username of the account owning the repository (not case-sensitive).
Numeric ID of the author to map, identified during a repository import; this ID is specific to the import process.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_MARK_A_THREAD_AS_DONEMarks the GitHub notification thread (identified by `thread_id`) as done or read for the authenticated user, effectively archiving it.
Input parameters
ID of the notification thread to mark as done. Typically obtained from the `id` field in notification list operations (e.g., `GET /notifications`).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_MARK_A_THREAD_AS_READMarks an existing GitHub notification thread, identified by its `thread_id`, as read.
Input parameters
The unique identifier of the notification thread. This ID is obtained from a notification's `id` field, for example, via the 'List notifications for the authenticated user' endpoint.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_MARK_NOTIFICATIONS_AS_READMarks notifications as read or unread, optionally for those updated at or before a `last_read_at` timestamp.
Input parameters
Indicates whether to mark targeted notifications as read (`true`) or unread (`false`). Defaults to `true` (mark as read) if not provided.
If provided, only notifications updated at or before this timestamp are affected. If omitted, all current notifications are targeted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_MARK_REPOSITORY_NOTIFICATIONS_AS_READMarks notifications in a repository as read; if 'last_read_at' is specified, notifications updated after this timestamp are not marked as read.
Input parameters
Name of the repository, without the `.git` extension (case-insensitive).
Username of the account owning the repository (case-insensitive).
Timestamp (ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`). If provided, notifications updated *after* this time will NOT be marked as read. If omitted, all notifications in the repository are marked as read. Defaults to the current time.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_MERGE_A_BRANCHMerges a head branch or commit SHA into a base branch in a repository; fails if there are merge conflicts requiring manual resolution.
Input parameters
The name of the branch to merge the `head` branch into.
Source branch name or full commit SHA to merge into the `base` branch.
Repository name, without the `.git` extension. Not case-sensitive.
Username or organization name of the repository owner. Not case-sensitive.
Commit message for the merge. If omitted, GitHub uses a default message.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_MERGE_A_PULL_REQUESTMerges an open and mergeable pull request in a repository. A 405 error can occur for multiple reasons: (1) The PR is still in draft mode - convert it to ready-for-review first using GITHUB_UPDATE_A_PULL_REQUEST. (2) Branch protection rules are not satisfied - check for required approving reviews, status checks, or other repository rules that must be met before merging. (3) The base branch has been modified since the PR was last synced - update the PR branch first using GITHUB_UPDATE_A_PULL_REQUEST_BRANCH.
Input parameters
SHA of the pull request's head commit. Must match for merge to succeed, ensuring PR hasn't changed since review.
Repository name, without the `.git` extension. Not case-sensitive.
Repository owner's username. Not case-sensitive.
The unique number identifying the pull request. The PR must be mergeable: not a draft, and all branch protection rules (required reviews, status checks, etc.) must be satisfied.
Title for the merge commit message.
Merge strategy: 'merge', 'squash', or 'rebase'. Defaults to repository's setting if unspecified.
Additional details for the merge commit message.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_MOVE_A_PROJECT_CARDMoves a project card to a specified position within a column (GitHub Classic Projects). DEPRECATION NOTICE: GitHub Projects (classic) and its REST API were sunset on April 1, 2025. This action will return 404 for most requests on GitHub.com. It may still work on GitHub Enterprise Server instances where classic projects remain enabled. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/ On success, the API returns HTTP 201 with an empty body, indicating the card was moved.
Input parameters
The unique identifier of the project card to be moved. Obtain this ID from the list_project_cards or get_a_project_card actions.
The target position of the card within the column. Must be one of: 'top' (place card at top of column), 'bottom' (place card at bottom of column), or 'after:<card_id>' (place card immediately after the specified card). When using 'after:<card_id>', the referenced card must exist in the target column.
The unique identifier of the column to move the card to. If omitted, the card stays in its current column but moves to the specified position.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_MOVE_A_PROJECT_COLUMNMoves a column within a GitHub project (classic) to a new position. DEPRECATION NOTICE: GitHub Classic Projects (V1) and its REST API were sunset on April 1, 2025. This action will return a 404 error on GitHub.com. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. The `position` parameter can be: - 'first': Move the column to the beginning of the project - 'last': Move the column to the end of the project - 'after:<column_id>': Place the column after the specified column (e.g., 'after:67890') See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/
Input parameters
The new position for the column within the project. Valid values are: 'first' (move to the beginning), 'last' (move to the end), or 'after:<column_id>' (place after the specified column, e.g., 'after:67890').
The unique identifier of the project column to be moved. Must be a valid column ID from a GitHub project (classic).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_PING_AN_ORGANIZATION_WEBHOOKSends a 'ping' event to a specified, existing organization webhook to test its configuration and ensure it correctly receives events.
Input parameters
The name of the organization. This field is not case-sensitive.
The unique identifier of the webhook. This ID can be found in the `X-GitHub-Hook-ID` header of a webhook delivery.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_PING_A_REPOSITORY_WEBHOOKPings an existing webhook on a repository to test its configuration and reachability by GitHub.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The unique identifier of the hook. You can find this value in the `X-GitHub-Hook-ID` header of a webhook delivery.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_PRIVATELY_REPORT_A_SECURITY_VULNERABILITYPrivately reports a security vulnerability to a repository's maintainers. IMPORTANT: You cannot report vulnerabilities to repositories you own - this API is for third-party security researchers to report to other repositories. The target repository must have private vulnerability reporting enabled. Specify EITHER `severity` OR `cvss_vector_string`, but not both.
Input parameters
The name of the repository without the `.git` extension. This name is not case-sensitive.
The account owner of the repository. This name is not case-sensitive.
A list of Common Weakness Enumeration (CWE) identifiers relevant to the vulnerability.
A short, descriptive summary of the security vulnerability.
The advisory's severity level. Mutually exclusive with `cvss_vector_string`.
A detailed explanation of the security vulnerability, its impact, and potential mitigations.
JSON string representing a list of vulnerability objects detailing the affected packages or products. Each object should specify the package's ecosystem and name, the vulnerable version range, and optionally, patched versions and vulnerable functions.
The CVSS vector string for advisory severity. Mutually exclusive with `severity`.
Whether to create a temporary private fork to collaborate on a fix for the reported vulnerability.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_PUBLISH_SPONSORS_TIER_GRAPH_QLTool to publish a draft GitHub Sponsors tier using GraphQL. Use when you need to make a draft sponsors tier visible to potential sponsors. The tier must already exist in draft status.
Input parameters
The global Relay ID of the draft sponsors tier to publish. Must be a tier that is currently in draft status.
A unique identifier for the client performing the mutation. Used to track requests.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REDELIVER_A_DELIVERY_FOR_AN_ORGANIZATION_WEBHOOKRedelivers a specific webhook delivery for a webhook within an organization, to resend an event that previously failed or was not processed.
Input parameters
The name of the organization. This name is not case-sensitive.
The unique identifier of the webhook. This ID can be found in the `X-GitHub-Hook-ID` header of a webhook delivery or by listing webhooks for an organization.
The unique identifier of the specific webhook delivery to be redelivered. This ID is typically obtained from the `X-GitHub-Delivery` header of the original delivery attempt or by listing deliveries for a webhook.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REDELIVER_A_DELIVERY_FOR_A_REPOSITORY_WEBHOOKRedelivers a specific, previously made webhook delivery (`delivery_id`) for a repository's webhook (`hook_id`).
Input parameters
The repository name, without the `.git` extension (not case-sensitive).
The account username that owns the repository (not case-sensitive).
Unique identifier of the webhook (e.g., from `X-GitHub-Hook-ID` header or by listing repository webhooks).
Unique identifier of a specific past delivery for the webhook (obtainable by listing deliveries for that webhook).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_A_CUSTOM_PROPERTY_FOR_AN_ORGANIZATIONDeletes a custom property, specified by `custom_property_name`, from an existing organization (`org`) for which the property is currently defined, preventing its future assignment to repositories.
Input parameters
The name of the organization. This name is not case sensitive.
The name of the custom property to remove. This name is case sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_A_LABEL_FROM_AN_ISSUERemoves a label currently applied to a specific issue in a repository.
Input parameters
The name of the label to remove from the issue. Emoji reactions will not be removed and names with spaces or special characters must be URL-encoded.
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The number that identifies the issue.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_ALL_LABELS_FROM_AN_ISSUERemoves all labels from a specified issue in a GitHub repository; this operation is idempotent.
Input parameters
The name of the repository, without the '.git' extension. This field is not case-sensitive.
The username of the account that owns the repository. This field is not case-sensitive.
The unique number that identifies the issue from which all labels will be removed.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_ALL_ORGANIZATION_ROLES_FOR_A_TEAMRevokes all organization roles for a team in an organization; this is destructive and succeeds even if the team initially has no roles.
Input parameters
The name of the organization. This field is not case-sensitive.
The slug of the team name. Team slugs are typically all lowercase and replace spaces with hyphens.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_ALL_ORGANIZATION_ROLES_FOR_A_USERRevokes all assigned organization-level roles from a specified user (who must be a member of the organization) within a GitHub organization, without removing the user from the organization or affecting repository-specific roles.
Input parameters
The organization name. This name is not case sensitive.
The handle for the GitHub user account.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_AN_ORGANIZATION_MEMBERRemoves a member from a GitHub organization. This action permanently removes a user's membership from the specified organization, revoking their access to all organization resources, repositories, and teams. Requirements: - The authenticated user must be an organization owner - The target user must currently be a member of the organization Note: This action cannot be used to remove the last owner of an organization.
Input parameters
The organization name (case-insensitive). Must be an organization where the authenticated user has owner permissions.
The GitHub username of the member to remove. The user must currently be a member of the organization.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_AN_ORGANIZATION_ROLE_FROM_A_TEAMRevokes an organization role that a team currently possesses within an organization.
Input parameters
The name of the organization. This value is not case sensitive.
The unique identifier of the organization role to be removed from the team.
The slug (short name) of the team.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_AN_ORGANIZATION_ROLE_FROM_A_USERRemoves a custom organization role from a user within a GitHub organization, provided the organization exists, the user is a member, and the role_id corresponds to a valid custom role in that organization.
Input parameters
The GitHub organization's name (not case-sensitive).
Unique ID of the organization role to be removed. Use the 'Get all organization roles' action to retrieve valid role IDs.
GitHub username of the user.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_APP_ACCESS_RESTRICTIONSRemoves all GitHub App access restrictions from a protected branch in a repository; the branch must have protection rules configured, and this action does not alter user or team restrictions.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username of the account that owns the repository. This field is not case-sensitive.
The name of the branch from which all app access restrictions will be removed. Wildcard characters are not supported; for branches with wildcards, please use the GraphQL API.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_A_PROJECT_FROM_A_TEAMRemoves a project from a team within an organization; this action requires the project to be currently associated with the team.
Input parameters
The organization name. The name is not case sensitive.
The slug of the team name (URL-friendly version, e.g., 'justice-league').
The unique identifier of the project to be removed from the team.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_A_REPOSITORY_COLLABORATORRemoves a collaborator from a specified GitHub repository, provided the repository exists and the user is an existing collaborator.
Input parameters
The name of the repository, without the `.git` extension (not case-sensitive).
The account owner of the repository (not case-sensitive).
The GitHub username of the collaborator to remove.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_A_REPOSITORY_FROM_AN_APP_INSTALLATIONRemoves a repository from a GitHub App installation for the authenticated user, given a valid `installation_id` and the `repository_id` of a repository currently linked to that installation; this operation is idempotent.
Input parameters
The unique identifier of the repository to be removed from the installation.
The unique identifier of the GitHub App installation from which to remove the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_A_REPOSITORY_FROM_A_TEAMDisassociates a repository from a team; team members may lose access permissions, but the repository and team are not deleted.
Input parameters
The name of the organization where the team and repository exist. This field is case-insensitive.
The name of the repository, without the '.git' extension. This field is case-insensitive.
The username of the account that owns the repository. This field is case-insensitive.
The URL-friendly identifier (slug) for the team. Team slugs are typically all lowercase with hyphens instead of spaces (e.g., 'justice-league' for 'Justice League').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_A_SELECTED_REPOSITORY_FROM_A_USER_SECRETRemoves a selected repository's access to a user's Codespaces secret; the secret must exist and the repository must have previously been granted access.
Input parameters
Name of the user's Codespaces secret from which repository access will be revoked.
The unique integer identifier of the repository that will lose access to the specified Codespaces secret.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_ASSIGNEES_FROM_AN_ISSUERemoves specified assignees from a GitHub issue; requires push access, and invalid removal attempts are silently ignored.
Input parameters
The name of the repository, excluding the `.git` extension. This name is not case-sensitive.
The account owner of the repository (username or organization name). This name is not case-sensitive.
Usernames to unassign from the issue. Note: Requires push access to the repository; attempts to remove users without permission or those not currently assigned are silently ignored.
The unique number that identifies the issue within the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_CUSTOM_LABEL_FROM_REPO_RUNNERRemoves a custom label from a repository's self-hosted runner; this operation is idempotent.
Input parameters
Name of the custom label to remove from the self-hosted runner. Note: only custom labels can be removed; read-only system labels (like 'self-hosted', 'linux', 'x64') cannot be removed.
Repository name, without the `.git` extension (case-insensitive).
Account owner of the repository (case-insensitive).
Unique identifier of the self-hosted runner. Get this from listing runners for the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_CUSTOM_LABEL_FROM_SELF_HOSTED_RUNNERRemoves a currently assigned custom label (`name`) from a self-hosted runner (`runner_id`) in an organization (`org`). This action allows the organization to manage the labels associated with their runners effectively.
Input parameters
The name of the organization. This name is not case-sensitive.
The name of the custom label to remove from the self-hosted runner.
Unique identifier of the self-hosted runner.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_CUSTOM_LABELS_FROM_SELF_HOSTED_REPO_RUNNERRemoves all custom labels from a self-hosted runner registered at the repository level, leaving only its default labels and any labels inherited from its runner group or organization.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository. This name is not case-sensitive.
Unique identifier (ID) of the self-hosted runner.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_INTERACTION_RESTRICTIONS_FOR_AN_ORGANIZATIONRemoves all interaction restrictions from public repositories in the specified GitHub organization, allowing all users to resume interactions.
Input parameters
The name of the GitHub organization. This name is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_INTERACTION_RESTRICTIONS_FOR_A_REPOSITORYRemoves all interaction restrictions for a repository, enabling all users to comment, open issues, and create pull requests by lifting any existing temporary interaction limits.
Input parameters
Repository name, without the `.git` extension; case-insensitive.
Username or organization name of the repository owner; case-insensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_ORG_DEV_ENV_SECRET_BY_NAMEDeletes a GitHub Codespaces secret from an organization by its name; this operation is idempotent.
Input parameters
Name of the GitHub organization (case-insensitive).
Name of the Codespaces secret to remove.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_ORG_SECRET_BY_NAMEPermanently removes a specific Dependabot secret, by its `secret_name`, from the GitHub `org`, making it unavailable to Dependabot for that organization.
Input parameters
GitHub organization name (case-insensitive).
Dependabot secret name to remove from the organization.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_OUTSIDE_COLLABORATOR_FROM_AN_ORGANIZATIONRemoves a user, who must be an outside collaborator, from the specified GitHub organization, revoking their access to all its repositories.
Input parameters
The name of the GitHub organization. This name is not case-sensitive.
The GitHub username of the outside collaborator to remove.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_PUBLIC_ORG_MEMBERSHIPRemoves the authenticated user's public organization membership, making it private. The user remains a member of the organization but their membership is no longer publicly visible. This operation is idempotent - calling it when the membership is already private will succeed.
Input parameters
Name of the GitHub organization (case-insensitive). The authenticated user must be a member of this organization.
GitHub username of the authenticated user. Must match the currently authenticated user - you can only modify your own public membership status.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_PUBLIC_REPO_INTERACTION_RESTRICTIONSRemoves all interaction restrictions (limitations on comments, issues, or pull requests) from all public repositories owned by the authenticated user.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_REPO_FROM_ORG_DEV_ENV_SECRETRemoves a repository's access to an organization-level Codespaces secret, if it was previously granted.
Input parameters
The GitHub organization name (not case-sensitive).
The Codespaces secret name.
The unique identifier of the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_REPO_FROM_ORG_SECRET_WITH_SELECTED_VISIBILITYRevokes a specific repository's access to an organization-level Dependabot secret, applicable only when the secret has 'selected' visibility and the specified repository currently has access.
Input parameters
Name of the organization (not case-sensitive).
Name of the Dependabot secret.
Unique numeric ID of the repository (not the repository name).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_REQUESTED_REVIEWERS_FROM_A_PULL_REQUESTRemoves currently assigned user logins and/or team slugs from a GitHub pull request's list of requested reviewers.
Input parameters
Repository name, without the `.git` extension (not case-sensitive).
Username of the repository owner (not case-sensitive).
GitHub user `login`s for removal. At least one of `reviewers` or `team_reviewers` must be specified.
Number of the pull request.
GitHub team `slug`s (URL-friendly names) for removal. At least one of `reviewers` or `team_reviewers` must be specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_SELECTED_REPO_FROM_ORG_SECRETRemoves a specific repository's access to an organization-level secret; the repository must have been previously granted access to this secret.
Input parameters
Organization name (case-insensitive).
Name of the organization secret.
Repository ID to remove from the secret's access.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_SELECTED_REPO_FROM_ORG_VARIABLERemoves a repository's access to an organization variable that has 'selected' visibility. This endpoint removes a specific repository from an organization variable's access list. The variable must have its visibility set to 'selected' for this operation to work. Returns a 409 Conflict error if the variable visibility is not 'selected'.
Input parameters
The organization's name (case-insensitive).
Name of the organization variable.
Unique identifier of the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_STATUS_CHECK_CONTEXTSRemoves specified status check contexts from a protected branch's required status checks. This action removes the specified status check contexts from the existing list of required status checks for a protected branch. The branch must already have branch protection enabled with status checks configured. Note: The 'contexts' parameter is deprecated by GitHub in favor of 'checks' array. For new implementations, consider using update_status_check_protection with the 'checks' parameter instead.
Input parameters
The name of the repository, without the `.git` extension. This name is not case sensitive.
The account owner of the repository. This name is not case sensitive.
The name of the branch. Wildcard characters are not allowed. To use wildcard characters in branch names, refer to the GraphQL API documentation.
The status check contexts to remove from the protected branch. These are the names of CI/CD jobs or other checks that should no longer be required before merging. Can be provided as a single string or a list of strings. Examples: 'ci/test', 'linter', 'continuous-integration/travis-ci'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_STATUS_CHECK_PROTECTIONRemoves status check protection from a branch, disabling required status checks for merging pull requests; will only have an effect if status check protection is currently configured on the branch.
Input parameters
Name of the repository, without the `.git` extension; not case-sensitive.
Account owner (username or organization) of the repository; not case-sensitive.
Name of the branch; wildcard characters are not allowed.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_TEAM_ACCESS_RESTRICTIONSRemoves specified teams from push access to a protected branch. This action removes teams from the list of teams with push access to a protected branch. Removing a team will also remove push access for any child teams. Prerequisites: - The repository must be owned by an organization (not a personal account) - The branch must have protection rules enabled - The branch protection must have restrictions configured - The teams must currently have push access to the branch
Input parameters
The name of the repository, without the `.git` extension. This value is not case-sensitive.
The organization name that owns the repository. Team access restrictions only work for organization-owned repositories, not personal repositories. This value is not case-sensitive.
The list of team slugs to remove from push access to the protected branch. A team slug is the URL-friendly version of the team name (lowercase, hyphens instead of spaces). Removing a team will also remove push access for any child teams. This removes teams from the existing list (does not replace the entire list).
The name of the protected branch to remove team restrictions from. The branch must already have branch protection enabled with restrictions configured. Wildcard characters are not supported. For wildcard branch protection, use the GitHub GraphQL API.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_TEAM_MEMBERSHIP_FOR_A_USERRemoves a user from a specific team within an organization. This action requires admin:org scope permissions. It will fail if: - Team synchronization with an Identity Provider (IdP) is enabled (403 Forbidden) - The organization, team, or user membership doesn't exist (404 Not Found) - You don't have sufficient permissions to manage team memberships (403 Forbidden) Note: If the removed user was the last member and the team is not nested, the team may be deleted automatically.
Input parameters
The name of the GitHub organization that owns the team. Not case-sensitive.
The GitHub username of the user to remove from the team. Must be an exact match of the user's login handle.
The URL-friendly identifier (slug) of the team. This is the hyphenated, lowercase version of the team name as it appears in the team's URL (e.g., 'justice-league' for a team named 'Justice League').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_USER_ACCESS_RESTRICTIONSRemoves specified users from the list of people allowed to push to a protected branch. Important notes: - This action only works on organization-owned repositories (not personal repos) - The branch must have protection rules with push restrictions enabled - Users being removed must currently have push access to the branch - The combined total of users, apps, and teams is limited to 100 items
Input parameters
The name of the repository, without the `.git` extension. Not case-sensitive.
The account owner of the repository. Must be an organization name (user access restrictions only work on organization repositories). Not case-sensitive.
The list of user logins to remove from push access to the protected branch. These users will no longer be able to push directly to this branch. The combined total of users, apps, and teams with restrictions is limited to 100 items.
The name of the branch from which to remove user access restrictions. Wildcard characters (e.g., '*') are not allowed. Use the GitHub GraphQL API for wildcard branch patterns.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_USER_AS_A_COLLABORATORRemoves a user as a collaborator from an organization project (classic). IMPORTANT: This action uses the Projects (classic) REST API which is being deprecated. The Projects (classic) feature was sunset on GitHub.com. This API may still work on GitHub Enterprise Server versions before 3.17. Requirements: - You must be an organization owner or a project admin to remove a collaborator - The user must already be a collaborator on the specified project - The project must be an organization project (classic), not a Projects V2 project For GitHub.com users: Consider using GitHub Projects V2 instead, which can be managed through the GraphQL API.
Input parameters
The GitHub username of the user to remove as a collaborator from the organization project (classic).
The unique database identifier of the organization project (classic). This is a numeric ID returned when listing or creating classic projects, not the project number visible in URLs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REMOVE_USERS_CODESPACES_ACCESS_ORGRemoves selected users from GitHub Codespaces billing access for an existing organization.
Input parameters
The name of the GitHub organization. This field is not case-sensitive.
A list of GitHub usernames, typically organization members. After removal, the organization will no longer be billed for Codespaces created by these users.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_RENAME_A_BRANCHRenames an existing branch in a GitHub repository; the new name must be unique and adhere to GitHub's naming conventions, and the current branch name cannot contain wildcard characters.
Input parameters
The name of the repository, without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The current name of the branch. Wildcard characters (e.g., `*`) are not allowed.
The new name for the branch. Must be unique and adhere to GitHub's branch naming conventions (e.g., no spaces, '..', or leading/trailing slashes).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_RENDER_A_MARKDOWN_DOCUMENTRenders Markdown to HTML; for 'gfm' mode, provide 'context' (owner/repo) to correctly link issues, pull requests, and user mentions.
Input parameters
Rendering mode: 'markdown' for standard Markdown or 'gfm' for GitHub Flavored Markdown.
The Markdown string to convert to HTML.
The repository context (e.g., 'owner/repo') used when `mode` is 'gfm'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_RENDER_MARKDOWN_RAWTool to render raw Markdown text to HTML using GitHub's markdown API. Use when you need to convert plain Markdown content to HTML without GitHub-specific features like issue references or @mentions.
Input parameters
The raw Markdown text to render as HTML. This can include any valid Markdown syntax like headers, lists, links, bold/italic text, code blocks, etc.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REPLACE_ALL_REPOSITORY_TOPICSReplaces all topics of a repository.
Input parameters
The name of the repository, without the `.git` extension. This is case-insensitive.
A list of topic names to replace the current set of topics for the repository. Provide one or more topics to set them. To remove all topics, pass an empty list (`\[\]`). Note: Topic names cannot contain uppercase letters and are limited to 25 characters.
The username of the account that owns the repository. This is case-insensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REPLACE_ORG_SECRET_VISIBILITY_TO_SELECTEDReplaces the list of repositories that can access a Dependabot organization secret when the secret's visibility is already set to 'selected'.
Input parameters
The name of the organization. This parameter is not case-sensitive.
Name of the Dependabot secret (alphanumeric characters and underscores only, no spaces allowed).
Array of repository IDs that can access this organization Dependabot secret. This list completely replaces any current repository associations. For incremental changes (add/remove individual repos), use dedicated add/remove repository secret actions instead.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REPLACE_REPO_ACCESS_ON_ORG_DEV_ENV_SECRET_SETReplaces the list of repositories that can access an organization-level Codespaces secret. This operation completely replaces the existing list of repositories with the provided list. The secret must already have its visibility set to 'selected' for this operation to succeed. Use this when you want to set an exact list of repositories that should have access. Prerequisites: - The organization must exist and you must have admin:org scope - The Codespaces secret must already exist in the organization - The secret's visibility must be set to 'selected' (not 'all' or 'private') Returns HTTP 204 No Content on success, 404 if secret/org not found, 409 if visibility is not 'selected'.
Input parameters
The GitHub organization name (case-insensitive).
Name of the development environment secret for which repository access is being configured.
Array of repository IDs that can access the organization Codespaces secret. This completely replaces any existing list of repositories. Note: The secret's visibility must already be set to 'selected' (not 'all' or 'private') for this operation to succeed; otherwise, a 409 Conflict error is returned.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REQUEST_A_GITHUB_PAGES_BUILDManually triggers a GitHub Pages build for a repository if GitHub Pages is enabled, useful for deployments not automatically built or for retrying failed builds.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository. This name is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REQUEST_REVIEWERS_FOR_A_PULL_REQUESTAdds reviewers to a specific pull request identified by owner, repo, and pull_number. This is NOT a search action - it operates on an already-known PR number. Requires `owner`, `repo`, `pull_number`, and at least one of `reviewers` or `team_reviewers`.
Input parameters
Name of the repository, without the `.git` extension; not case sensitive.
Account owner of the repository (username or organization name); not case sensitive.
GitHub user `login` strings (usernames) to request reviews from. At least one of `reviewers` or `team_reviewers` must be provided.
Number identifying the pull request.
GitHub team `slug` strings (e.g., 'justice-league') to request reviews from. Slugs are typically lowercase and use hyphens for spaces. At least one of `reviewers` or `team_reviewers` must be provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REREQUEST_A_CHECK_RUNTriggers a re-run of a specific check run in a GitHub repository, resetting its status to 'queued', clearing its conclusion, and triggering the `check_run` webhook with `rerequested` action. IMPORTANT: This endpoint requires GitHub App authentication with 'checks:write' permission. The check run can ONLY be re-requested by the same GitHub App that originally created it. OAuth tokens and personal access tokens (PAT) cannot use this endpoint.
Input parameters
The name of the repository, without the `.git` extension. This field is case-insensitive.
The account owner of the repository (username or organization name). This field is case-insensitive.
The unique numerical identifier of the check run to be re-requested. Must be a check run created by the same GitHub App making the request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REREQUEST_A_CHECK_SUITETriggers a new run of an existing check suite within a repository, resetting its status to 'queued', clearing its conclusion, and triggering the `check_suite` webhook with `rerequested` action. IMPORTANT: This endpoint requires GitHub App authentication with 'checks:write' permission. OAuth tokens and classic personal access tokens (PAT) cannot use this endpoint. Only GitHub App user access tokens, GitHub App installation access tokens, or fine-grained personal access tokens with checks:write permission are supported.
Input parameters
The name of the repository without the `.git` extension. This field is case-insensitive.
The account owner of the repository (username or organization name). This field is case-insensitive.
The unique numerical identifier of the check suite to be re-requested. You can obtain this from the list_check_suites_for_a_git_reference endpoint or from a workflow run.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_RE_RUN_A_JOB_FROM_A_WORKFLOW_RUNRe-runs a specific job and any dependent jobs from a GitHub Actions workflow run in the specified repository, optionally enabling debug logging.
Input parameters
The name of the repository, without the `.git` extension. This name is not case sensitive.
The account owner of the repository (e.g., a GitHub username or organization name). This name is not case sensitive.
The unique numerical identifier of the job to be re-run. This ID can be obtained by listing jobs for a workflow run.
If `true`, enables additional debug logging for the re-run of the job. Defaults to `false` if not provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_RE_RUN_A_WORKFLOWRe-runs a specific GitHub Actions workflow run identified by its owner, repository, and run ID, optionally enabling debug logging.
Input parameters
Name of the repository (without the `.git` extension) where the workflow run exists (not case-sensitive).
Account owner of the repository where the workflow run exists (not case-sensitive).
Unique ID of the workflow run to re-execute.
Set to `true` to enable diagnostic logging for the re-run, helpful for troubleshooting.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_RE_RUN_FAILED_JOBS_FROM_A_WORKFLOW_RUNRe-runs all failed jobs and their dependent jobs from a specified workflow run if the run contains previously failed jobs.
Input parameters
The name of the repository, without the `.git` extension; not case-sensitive.
The account owner of the repository (username or organization name); not case-sensitive.
The unique identifier of the workflow run.
Set to `true` to enable extensive debug logging for the re-run, providing additional logs to aid in diagnosing issues.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_RESET_A_TOKENInvalidates the provided OAuth `access_token` and generates a new one for the GitHub OAuth App identified by `client_id`. Used for token rotation when a token may be compromised or for regular security maintenance. Note: This endpoint requires the OAuth App owner's credentials (client_id/client_secret for Basic Auth).
Input parameters
The client ID of the GitHub OAuth App.
The existing OAuth access token that needs to be reset. This token will be invalidated and replaced by a new one.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_RESTORE_A_PACKAGE_FOR_AN_ORGANIZATIONRestores a package in an organization, provided it was deleted within the last 30 days.
Input parameters
Name of the GitHub organization that owns the package (case-insensitive).
Optional token for restoring private packages or specific versions requiring special permissions.
Unique name of the package to be restored.
Type of the package. Gradle packages use `maven`. Docker images in `ghcr.io` use `container`; `docker` finds images from `docker.pkg.github.com`, even if migrated.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_RESTORE_A_PACKAGE_FOR_A_USERRestores a user-owned package previously deleted from GitHub Packages, if restorable under GitHub's data retention policy (typically within 30 days of deletion).
Input parameters
Optional package version token. Only required when restoring packages with versions that have more than 50,000 downloads.
The GitHub username of the account that owns the deleted package.
The unique name of the deleted package to restore.
The type of GitHub package registry. Supported values: npm, maven, rubygems, docker, nuget, container. Use `maven` for Gradle packages. `docker` can be used for images migrated from `docker.pkg.github.com` to the Container registry (`ghcr.io`), while `container` is for images originally pushed to `ghcr.io`.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_RESTORE_A_PACKAGE_FOR_THE_AUTHENTICATED_USERRestores a package deleted by the authenticated user within the last 30 days, if its namespace and version are still available.
Input parameters
Optional token to identify a specific package version to restore, useful if multiple versions were deleted. If omitted, the most recently deleted version is typically restored.
The unique name of the package to be restored within its namespace and type.
The type of the package to be restored, specifying its ecosystem. For example, `npm` for Node.js packages, `maven` for Java packages. Special cases: packages in GitHub's Gradle registry use the type `maven`. Docker images pushed to GitHub's Container registry (`ghcr.io`) use the type `container`. The `docker` type can be used to find images originally pushed to GitHub's Docker registry (`docker.pkg.github.com`), even if they have been migrated to the Container registry.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_RESTORE_A_PACKAGE_VERSION_FOR_THE_AUTHENTICATED_USERRestores a package version that was deleted by the authenticated user within the last 30 days.
Input parameters
Name of the package.
Specifies the package type. Use `maven` for GitHub's Gradle registry. Use `container` for images in GitHub's Container registry (ghcr.io). `docker` can be used for images previously in GitHub's Docker registry (docker.pkg.github.com), even if migrated.
Unique ID of the package version to restore.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_RESTORE_PACKAGE_VERSION_FOR_AN_ORGANIZATIONRestores a package version for an organization, provided it was deleted within the last 30 days.
Input parameters
Organization name (case-insensitive).
Unique name of the package.
The type of package. Supported types include "npm", "maven", "rubygems", "docker", "nuget", and "container". Packages in GitHub's Gradle registry use the `maven` type. Docker images in GitHub's Container registry (`ghcr.io`) use the `container` type. The `docker` type can be used for images previously in GitHub's Docker registry (`docker.pkg.github.com`), even if migrated to the Container registry.
Unique identifier of the package version.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_RESTORE_PACKAGE_VERSION_FOR_A_USERRestores a specific, user-owned package version if it was deleted within the last 30 days and its original namespace and version name are still available.
Input parameters
The GitHub username of the package owner.
The name of the package.
Specifies the package type. Packages in GitHub's Gradle registry have the type `maven`. Docker images pushed to GitHub's Container registry (`ghcr.io`) have the type `container`. Use `docker` for images from GitHub's Docker registry (`docker.pkg.github.com`), even if migrated to the Container registry.
The unique numeric identifier of the package version to be restored. Obtain this by first listing package versions using 'list_package_versions_for_a_package_owned_by_a_user'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_RETIRE_SPONSORS_TIERTool to retire a published payment tier from your GitHub Sponsors profile using GraphQL. Use when you need to prevent a tier from being used for new sponsorships. Existing sponsors at this tier remain unaffected.
Input parameters
The global node ID of the sponsors tier to retire (e.g., 'ST_kwDOCNqc1s4ACOVb'). Once retired, this tier cannot be used to start new sponsorships, but existing sponsors at this tier are unaffected.
A unique identifier for the client performing the mutation. Used to ensure idempotency of mutations and track request origin.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REVIEW_ACCESS_WITH_PERSONAL_TOKENApproves or denies a pending fine-grained personal access token request for organization resources; must be performed by a GitHub App.
Input parameters
The name of the GitHub organization. This field is not case-sensitive.
The action to take on the personal access token request. Must be 'approve' to approve the request or 'deny' to deny it.
An optional comment explaining the reason for approving or denying the request. Maximum length is 1024 characters.
The unique identifier of the pending fine-grained personal access token request that needs to be reviewed.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REVIEW_DEPLOYMENT_PROTECTION_RULESApproves or rejects pending custom deployment protection rules for a workflow run. This endpoint allows GitHub Apps to review their own pending custom deployment protection rules for a specific workflow run. The review can either approve (allowing the deployment to proceed) or reject (blocking the deployment). **Important notes:** - GitHub Apps can only review their own custom deployment protection rules - This endpoint requires GitHub App installation access tokens with Deployments permission (write) - Custom deployment protection rules are available in public repos for all plans; for private/internal repos, GitHub Enterprise is required - Returns 204 No Content on success
Input parameters
Repository name, without `.git` extension (case-insensitive).
Repository owner's username or organization name (case-insensitive).
The review decision: 'approved' to allow the deployment or 'rejected' to block it.
Unique identifier of the workflow run.
Optional comment to include with the review decision.
The name of the deployment environment to review (e.g., 'production', 'staging').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REVIEW_PENDING_DEPLOYMENTS_FOR_A_WORKFLOW_RUNApproves or rejects pending deployments for a specific workflow run that are in a 'waiting' state within specified, configured environments.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
State to apply to the pending deployments.
The unique identifier of the workflow run.
Comment to include with the review decision.
Environments targeted by the review; they must be configured for the repository and be part of the pending deployments for this run.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REVIEW_RESOURCE_REQUESTS_WITH_FINE_GRAINED_TOKENSApproves or denies multiple fine-grained personal access token requests for an organization in bulk. This endpoint processes multiple PAT request approvals or denials in a single API call. All specified pat_request_ids must refer to currently pending requests. Important: This endpoint can ONLY be called by GitHub Apps with the 'organization_personal_access_token_requests:write' permission. It cannot be called with personal access tokens or OAuth apps. On success, returns HTTP 202 Accepted with an empty body.
Input parameters
The organization name where the token requests are pending. Case-insensitive.
The action to perform on the specified token requests. Use 'approve' to grant access or 'deny' to reject the requests.
Optional reason for the decision. Maximum 1024 characters. This reason is stored and may be visible to the requester.
List of unique identifiers for the fine-grained personal access token requests to review. Must contain between 1 and 100 request IDs. Get these IDs from the 'List requests to access organization resources' endpoint.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_REVOKE_AN_INSTALLATION_ACCESS_TOKENRevokes the GitHub App's current installation access token, immediately invalidating it for API authentication. IMPORTANT: This endpoint requires a GitHub App installation access token (ghs_* prefix) for authentication. OAuth tokens (gho_*) or personal access tokens are not supported and will result in a 403 Forbidden error. After successful revocation, the token becomes permanently invalid and cannot be used for any subsequent API calls. To continue API operations, a new installation access token must be generated.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_RUN_GRAPH_QL_QUERYTool to run an arbitrary GitHub GraphQL v4 query or mutation. Use when fetching multiple datasets in one batch. Cost-based rate limit: ~5,000 points/hour; keep field selections narrow, avoid deep nesting, and include rateLimit in responses to monitor quota. Responses are nested under data.data (e.g., data.data.repository.vulnerabilityAlerts); always inspect the errors array even on HTTP 200, as partial failures embed there. Paginate by looping on pageInfo.hasNextPage and advancing with pageInfo.endCursor. Search results cap at ~1,000 items per query; split by label, date range, or repository for full coverage. Use ProjectV2 nodes, not Classic Projects (deprecated). Parallel mutations (e.g., addProjectV2ItemById) can trigger transient conflicts; use sequential execution.
Input parameters
GraphQL query or mutation string. Must comply with GitHub's GraphQL v4 schema.
JSON object mapping variable names to values for use in the query.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_RUN_GRAPH_QL_RELAY_QUERYTool to run a GitHub GraphQL relay query. The relay field is a workaround for re-exposing the root query object. Use when you need to access root query fields through the relay context.
Input parameters
GraphQL query string to execute within the relay context. Must comply with GitHub's GraphQL v4 schema. The relay field re-exposes the root Query object, allowing you to nest any valid root query fields.
JSON object mapping variable names to values for use in the query. Optional - omit if the query has no variables.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SEARCH_CODESearches code file contents and paths on the default branch of GitHub repositories using a query string; searches only files under 384KB, returns max 1000 results by best match, and is optimized for precision.
Input parameters
Code search query, including keywords and qualifiers (e.g., `language:python`, `user:octocat`, `repo:owner/repo`). For full syntax and qualifiers, see GitHub docs: \[Constructing a search query\](https://docs.github.com/rest/search/search#constructing-a-search-query) and \[code search qualifiers\](https://docs.github.com/search-github/searching-on-github/searching-code).
Page number for results. For pagination details, see GitHub docs: \[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).
DEPRECATED. Valid: 'indexed' (sorts by last indexed time) or 'updated' (sorts by last updated time). If unspecified, results sorted by best match. Docs: \[ranking search results\](https://docs.github.com/rest/search/search#ranking-search-results).
DEPRECATED. Order ('asc' or 'desc') for results; effective only if `sort` is specified. Docs: \[ranking search results\](https://docs.github.com/rest/search/search#ranking-search-results).
Results per page (max 100). For pagination details, see GitHub docs: \[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SEARCH_CODE_ALL_PAGESTool to search code across multiple pages using GitHub's code search API. Use when single-page searches may miss matches and you need a full or capped result set. GitHub caps results at ~1,000 total items regardless of pagination; results for broad queries may be silently truncated. Only the default branch is indexed, and very large files may be excluded — treat results as potentially partial. Rate limit: ~30 requests/minute; honor `Retry-After` on 403/429 responses.
Input parameters
The search query string for code search. **IMPORTANT**: While GitHub's documentation mentions boolean operators (AND, OR, NOT) support, the REST API still uses older syntax that frequently rejects queries with operators or parentheses (ERROR_TYPE_QUERY_PARSING_FATAL). For reliable searches, avoid boolean operators and parentheses. Supports qualifiers: `language:`, `repo:`, `path:`, `extension:`, `user:`, `org:`, `in:file`. Multiple terms use implicit AND: `hello world` finds both. Quote exact phrases: `"exact phrase"`. For complex boolean logic, use multiple separate API calls or the GitHub web interface.
Page number to start retrieval (min 1).
Sort field: only 'indexed' is valid (sort by last indexed time).
Optional cap on total number of items to retrieve across pages (min 1).
Sort order for results: 'asc' or 'desc'. Only effective when `sort` is provided.
Custom Accept header for media type (e.g., `application/vnd.github.text-match+json` to include text match metadata).
Number of results per page (min 1, max 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SEARCH_COMMITSFinds commits on GitHub using a query string (q) supporting keywords and qualifiers, with options for sorting and pagination.
Input parameters
Search query with at least one text keyword plus optional qualifiers. GitHub requires actual search text (commit message keywords) - qualifiers alone are not allowed. Common qualifiers: 'repo:owner/name', 'author:username', 'committer:username', 'author-date:YYYY-MM-DD' or 'author-date:>YYYY-MM-DD..YYYY-MM-DD', 'committer-date:YYYY-MM-DD', 'merge:true/false', 'hash:HASH', 'parent:HASH', 'tree:HASH'. IMPORTANT: The 'hash:' qualifier requires a full 40-character hexadecimal commit hash (e.g., 'hash:e5bd3914e2e596debea16f433f57875b5b90bcd6'). Do NOT use branch names, tag names, or short refs with 'hash:' - use 'repo:owner/name' with other filters to search commits on a specific branch.
Page number of results to retrieve.
Sorts results by 'author-date' or 'committer-date'. Use separately with the 'order' parameter (e.g., sort='committer-date' with order='desc'). Do not combine them into a single value. If unspecified, GitHub defaults to 'best match' ranking.
Sort order: 'desc' (newest first) or 'asc' (oldest first). Use with the 'sort' parameter to control direction (e.g., sort='committer-date' with order='desc').
Number of results per page (maximum 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SEARCH_COMMITS_BY_AUTHORSearches commits across GitHub using the Search API (e.g., by author/email/org/date range) without per-repo scanning. Use when you need to find commits by author, committer email, organization, or date ranges across multiple repositories. This avoids the need to list commits per repository and prevents 409 errors on empty repos.
Input parameters
GitHub search query for commits. IMPORTANT: Must include search text (keywords) in addition to qualifiers. Qualifier-only queries are not allowed by the GitHub API. Supports qualifiers like author:, committer-email:, org:, repo:, author-date:, committer-date:, merge:, hash:, parent:, tree:, is:public/private. Examples: 'fix author:octocat', 'bug repo:owner/repo', 'update author:octocat author-date:>=2025-01-01'. If only qualifiers are provided, a wildcard search term will be automatically added.
Page number of results to fetch.
Sort options for commit search.
Order options for search results.
Number of results per page (maximum 100).
Message about any automatic modifications made to the input
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SEARCH_GITHUB_GRAPHQLTool to perform GitHub GraphQL searches across issues, pull requests, repositories, users, and discussions. Returns up to 1,000 results with cursor-based pagination. Use when you need structured search results with specific fields.
Input parameters
The type of resource to search. Determines the structure of returned results.
Cursor string obtained from pageInfo.endCursor in a previous response. Returns results after this cursor for pagination.
Number of results to return (1-100). Returns the first N elements from the result set. Use with 'after' parameter for pagination.
The search query string using GitHub search syntax. Supports qualifiers like 'repo:', 'org:', 'user:', 'is:open', 'is:closed', 'label:', etc. For issues/PRs, use 'is:issue' or 'is:pr'. For repositories, search by name, description, or topics. Maximum 1,000 results can be retrieved across all pages.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SEARCH_ISSUES_AND_PULL_REQUESTSSearches GitHub for issues and pull requests. Supports keywords, qualifiers (repo:, org:, user:, state:, label:, author:, assignee:, mentions:, etc.), and type filters (is:issue, is:pr). Type filters cannot be used alone - they must be combined with at least one keyword or other qualifier. All other qualifiers work independently. The @me shorthand (e.g., assignee:@me, mentions:@me) is automatically resolved to your username. Logical operators (AND, OR, NOT) are supported but limited to a maximum of 5 operators total per query.
Input parameters
Search query using GitHub's search syntax. Supports keywords, qualifiers (repo:, org:, user:, state:, label:, author:, assignee:, mentions:, etc.), and type filters (is:issue, is:pr). IMPORTANT: Type filters (is:issue, is:pr) cannot be used alone - they must be combined with at least one keyword or other qualifier. All other qualifiers work independently (e.g., 'state:open', 'label:bug', 'assignee:octocat'). The @me shorthand (e.g., assignee:@me, mentions:@me, author:@me) can be used to reference the authenticated user. Logical operators (AND, OR, NOT) can be used to combine terms (maximum 5 operators total).
Page number for results.
Field for sorting results. GitHub defaults to 'best match' if unspecified.
Order for sorted results (ascending/descending). Effective only if `sort` is also provided.
Number of results per page.
Level of detail in the response. 'minimal' (default) returns an optimized response for AI agents. 'full' returns the complete GitHub API response.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SEARCH_LABELSSearches for labels within a GitHub repository by keywords in their names or descriptions.
Input parameters
The search keywords or query to find labels. This endpoint does not accept qualifiers in the query. For more details on query construction, refer to GitHub's documentation on \[Constructing a search query\](https://docs.github.com/rest/search/search#constructing-a-search-query).
The page number of the results to retrieve, starting from 1. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
Specifies the field to sort the search results by. Valid options are 'created' or 'updated'. If not provided, results are sorted by best match according to GitHub's default ranking: \[best match\](https://docs.github.com/rest/search/search#ranking-search-results).
Determines the sorting order of results, either 'asc' (ascending) or 'desc' (descending). This parameter is only effective when `sort` is also specified. Defaults to 'desc'.
The number of search results to return per page. The maximum value is 100. For more information, see "\[Using pagination in the REST API\](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
The unique identifier of the repository where labels will be searched.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SEARCH_REPOSITORIESSearches GitHub repositories using a flexible query (keywords, qualifiers) with sorting, ordering, and pagination. IMPORTANT: The 'q' parameter (search query) is REQUIRED and must always be provided.
Input parameters
REQUIRED non-empty search query. Max 5 AND/OR/NOT operators. Qualifiers: `language:LANG`, `stars:N`, `stars:>N`, `forks:N`, `size:N` (KB), `topic:TOPIC`, `license:LICENSE`, `created:DATE`, `pushed:DATE`, `is:public\\|private`, `archived:true\\|false`, `in:name\\|description\\|readme`, `user:USERNAME`, `org:ORGNAME`. Must use real GitHub usernames/orgs (e.g., `user:octocat`), not placeholders. Queries with logical operators must include at least one plain keyword; `topic:solana OR topic:ethereum` fails, use `solana OR ethereum stars:>100` instead.
The page number for pagination of search results. Defaults to 1. Used in conjunction with `per_page` to fetch subsequent sets of results. See GitHub API documentation for more on pagination.
Specifies the field to sort the search results by. Options include `stars`, `forks`, `help-wanted-issues`, `updated` (recency of update), or `created` (creation date). If not provided, results are sorted by GitHub's default 'best match' ranking.
Determines the order of search results: `desc` for descending or `asc` for ascending. This parameter is only effective when `sort` is also specified. Defaults to `desc`.
The number of repository results to return per page. The maximum value is 100. Defaults to 30. See GitHub API documentation for more on pagination.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SEARCH_TOPICSFinds topics on GitHub using keywords and qualifiers with GitHub's search syntax, supporting pagination.
Input parameters
Search query string. Supports keywords, qualifiers, and GitHub's search syntax; see \[Constructing a search query\](https://docs.github.com/rest/search/search#constructing-a-search-query).
Page number of the results to retrieve for pagination.
Number of topic results per page (maximum 100).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SEARCH_USERSSearches for users on GitHub by criteria like username, email, location, followers, or repository associations, using a flexible query string `q`.
Input parameters
Search query string supporting keywords and qualifiers for user attributes (e.g., `username`, `location`, `followers`). See examples for syntax.
Page number for results (1-indexed).
Field to sort results by. If not specified, GitHub's 'best match' algorithm is used.
Sort order for results when `sort` is specified; ignored otherwise.
Number of search results per page. Maximum 100.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_ADMIN_BRANCH_PROTECTIONEnables administrator enforcement on a branch, making existing protection rules also apply to administrators; branch protection rules must already be configured.
Input parameters
Repository name, without the `.git` extension. Not case sensitive.
Account owner of the repository (user or organization name). Not case sensitive.
Branch name. Wildcards not permitted (use GitHub GraphQL API for wildcard patterns).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_APP_ACCESS_RESTRICTIONSReplaces the list of GitHub Apps permitted to push to a protected branch. This action completely replaces the existing list of apps with push access - it does not add to or merge with the current list. Requirements: - The branch must already have protection rules enabled with push restrictions configured - Apps must be installed on the repository and have 'contents' write permission - Push restrictions are only available for organization-owned repositories with GitHub Team or Enterprise Cloud plans
Input parameters
The list of GitHub App slugs to grant push access. This replaces the entire list of apps with push access. Apps must be installed on the repository and have 'contents' write permission. The app slug is the URL-friendly name of the GitHub App (e.g., 'github-actions', 'dependabot').
The name of the repository without the `.git` extension. Not case-sensitive.
The organization or username that owns the repository. Push restrictions are only available for organization-owned repositories.
The name of the protected branch. Wildcards are not permitted. The branch must already have protection rules enabled with push restrictions configured.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_A_REPOSITORY_SUBSCRIPTIONSets the authenticated user's notification subscription for a repository.
Input parameters
The name of the repository without the `.git` extension. The name is not case-sensitive.
The account owner of the repository. The name is not case-sensitive.
Determines if all notifications should be blocked from this repository. If `true`, this repository will be ignored, and the `subscribed` parameter will be disregarded (effectively setting subscribed to `false`).
Determines if notifications should be received from this repository. Set to `true` to watch the repository, `false` to unwatch. This parameter is overridden if `ignored` is set to `true`.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_A_THREAD_SUBSCRIPTIONSets whether a GitHub notification thread is ignored (muted) or unignored (unmuted), for a `thread_id` that must identify an existing notification thread.
Input parameters
Whether to ignore (mute) the thread. `True` blocks notifications; `False` allows them if otherwise subscribed.
Unique identifier of the notification thread (e.g., from `GET /notifications`).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_DEFAULT_WORKFLOW_PERMISSIONS_FOR_AN_ORGANIZATIONUpdates an organization's default GITHUB_TOKEN permissions for workflows and whether GitHub Actions can approve pull requests; note that allowing Actions to approve pull requests (`can_approve_pull_request_reviews: true`) is a security risk.
Input parameters
The name of the GitHub organization. This name is not case-sensitive.
Specifies the default permissions for the GITHUB_TOKEN in GitHub Actions workflows.
Whether GitHub Actions can approve pull requests; enabling this (`true`) can be a security risk. If omitted, the current setting is preserved.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_DEFAULT_WORKFLOW_PERMISSIONS_FOR_A_REPOSITORYSets the default permissions for the GITHUB_TOKEN within a repository and configures whether GitHub Actions can approve pull requests.
Input parameters
The name of the repository, without the `.git` extension. This name is not case sensitive.
The account owner of the repository. This name is not case sensitive.
The default permissions granted to the GITHUB_TOKEN when running workflows in the repository. 'read' allows read-only access, while 'write' allows write access.
Specifies whether GitHub Actions workflows, using the GITHUB_TOKEN, can approve pull requests. Enabling this can pose a security risk by allowing automated processes to approve code changes.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_EMAIL_VISIBILITYSets the visibility ('public' or 'private') of the authenticated user's primary email address on GitHub, if one is configured.
Input parameters
Desired visibility for the authenticated user's primary email. Use 'public' to make the email visible on the user's profile, or 'private' to hide it.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_GITHUB_ACTIONS_PERMISSIONS_FOR_AN_ORGANIZATIONSets the GitHub Actions permissions policy for an organization, specifying which repositories can run Actions and which actions/workflows are allowed; if 'selected' is chosen for either, manage the specific lists via other endpoints.
Input parameters
The organization name (not case-sensitive).
Policy for which actions and reusable workflows are allowed. If 'selected', manage the list of specific actions/workflows via other GitHub API endpoints. Required when enabled_repositories is set to 'all' or 'selected'.
Policy for which repositories can run GitHub Actions. If 'selected', manage the list of specific repositories via other GitHub API endpoints.
Whether actions and reusable workflows must be pinned to full-length commit SHAs. This enforces an additional security requirement for GitHub Actions.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_GITHUB_ACTIONS_PERMISSIONS_FOR_A_REPOSITORYSets GitHub Actions permissions for a repository, enabling/disabling Actions and defining the policy for allowed actions and reusable workflows.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
Specifies whether GitHub Actions is enabled for the repository. Set to `True` to enable, `False` to disable.
Permissions policy: `all` (all actions/workflows allowed), `local_only` (only from this repository), or `selected` (configured in settings). Optional; inherits from organization/enterprise or GitHub defaults if omitted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_INTERACTION_RESTRICTIONS_FOR_AN_ORGANIZATIONLimits interactions (comments, new issues, PRs) in an organization's public repositories by user type and duration, typically to mitigate high traffic or unwanted activity.
Input parameters
Name of the organization (case-insensitive).
Type of GitHub user to be restricted from commenting, opening issues, or creating pull requests in the organization's public repositories.
Duration of the restriction; if omitted, the API defaults to `one_day`. A new limit overwrites any existing one.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_INTERACTION_RESTRICTIONS_FOR_A_REPOSITORYTemporarily limits which GitHub users (e.g., existing_users, contributors_only) can interact (comment, open issues, create pull requests) in a repository for a specified duration.
Input parameters
The name of the repository (without .git extension, case-insensitive).
Specifies which group of GitHub users (e.g., existing_users, contributors_only) can interact with the repository.
The account owner of the repository (username or organization name, case-insensitive).
Duration for the interaction restriction (e.g., one_day, six_months); API defaults to 'one_day' if not provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_INTERACTION_RESTRICTIONS_FOR_YOUR_PUBLIC_REPOSSets or updates temporary interaction restrictions for all public repositories owned by the authenticated user, overriding any repository-specific limits.
Input parameters
Specifies the type of GitHub user that can comment, open issues, or create pull requests in your public repositories while the interaction limit is in effect.
Specifies the duration of the interaction restriction; API defaults to `one_day` if not provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_LABELS_FOR_AN_ISSUEReplaces all existing labels on a GitHub issue with a new set of labels.
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
A list of label names to apply to the issue. This replaces all existing labels on the issue. Providing an empty list will remove all labels from the issue.
The number that identifies the issue within the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_OIDC_SUBJECT_CLAIM_TEMPLATESets the OpenID Connect (OIDC) subject claim template for a GitHub repository, allowing use of the default template or a custom one defined by `include_claim_keys` if `use_default` is `false`.
Input parameters
Repository name, without the `.git` extension (case-insensitive).
Owner of the repository (username or organization name, case-insensitive).
If true, applies the default GitHub-provided OIDC subject claim template (ignoring `include_claim_keys`); if false, a custom template defined by `include_claim_keys` is used.
Array of unique OIDC claim strings (alphanumeric and underscores) for the token. Used only if `use_default` is `false`. Consult GitHub's OIDC documentation for supported claim keys.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_ORG_ALLOWED_ACTIONSSets the GitHub Actions permissions for an existing organization, specifying allowed GitHub-owned actions, verified creator actions, and action/workflow patterns from public repositories.
Input parameters
The name of the organization. This name is not case-sensitive.
String-matching patterns for allowed actions/workflows from public repositories (e.g., `monalisa/octocat@*`, `monalisa/*`); supports wildcards, tags, SHAs.
Whether actions from GitHub Marketplace verified creators are allowed.
Whether GitHub-owned actions (e.g., from the `actions` organization) are allowed.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_ORG_RUNNER_LABELSSets the custom labels for a self-hosted runner in an organization; this operation does not affect default system-assigned labels (e.g., 'self-hosted', 'linux', 'x64').
Input parameters
The name of the organization. This name is not case-sensitive.
A list of custom label names to set for the runner. This replaces all existing custom labels. Provide an empty list to remove all custom labels from the runner.
Unique identifier of the self-hosted runner.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_REPO_ALLOWED_ACTIONSSets allowed GitHub Actions and reusable workflows for a repository, managing permissions for GitHub-owned, verified creator, or specific pattern-matched actions/workflows (note: `patterns_allowed` applies only to public repositories).
Input parameters
The name of the repository without the `.git` extension. The name is not case-sensitive.
The account owner of the repository. The name is not case-sensitive.
String-matching patterns (wildcards, tags, SHAs allowed) for specific actions/workflows; **Note**: Only applies to public repositories.
Determines if actions from GitHub Marketplace verified creators are allowed.
Determines if GitHub-owned actions (e.g., from the `actions` organization) are allowed.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_REPO_RUNNER_LABELSReplaces all custom labels for a specific self-hosted runner in a repository; an empty list for `labels` removes all existing custom labels.
Input parameters
Name of the repository, without the `.git` extension (not case-sensitive).
Account owner of the repository (not case-sensitive).
Custom labels to set for the runner; an empty list removes all custom labels and replaces existing ones.
Unique identifier of the self-hosted runner.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_SELECTED_REPOS_FOR_ORG_VARIABLEReplaces the list of repositories that can access an organization-level variable; the variable's visibility must be 'selected'.
Input parameters
The slug or name of the GitHub organization. This value is not case-sensitive.
The name of the organization variable for which to set repository access.
A list of unique integer identifiers for the repositories that can access the organization variable. This list will replace any current selection of repositories. An empty list will remove access for all repositories.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_SELECTED_REPOSITORIES_FOR_AN_ORGANIZATION_SECRETReplaces the list of repositories that can access an organization secret; only effective if the secret's visibility is 'selected'. Prerequisites: - The organization secret must already exist - The secret's visibility must be set to 'selected' (not 'all' or 'private') - Requires admin:org scope or actions secrets fine-grained permission This action completely replaces the repository access list. To add or remove individual repositories without affecting others, use the dedicated add/remove repository actions instead.
Input parameters
The name of the GitHub organization. This name is not case-sensitive.
The name of the organization secret whose repository access list is being updated.
An array of unique integer IDs for repositories that will be granted access to the organization secret. This completely replaces the existing list. Use dedicated actions to add or remove individual repositories without replacing the entire list.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_SELECTED_REPOSITORIES_FOR_A_USER_SECRETDefines the list of repositories permitted to access a specific Codespaces secret for the authenticated user.
Input parameters
The name of the Codespaces secret for which to set repository access. This secret must already exist for the authenticated user.
A list of repository IDs to which the secret will be granted access. This list completely replaces any existing set of repositories for the secret. Each repository ID must correspond to a repository accessible by the authenticated user.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_STATUS_CHECK_CONTEXTSReplaces required status check contexts for a protected branch, requiring admin permissions; an empty `contexts` array removes all checks.
Input parameters
The name of the repository, without the `.git` extension; not case sensitive.
The account owner (username or organization) of the repository; not case sensitive.
The name of the branch for which to set status check contexts; cannot contain wildcard characters.
Names of the status checks to require; an empty array removes all required status checks.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_TEAM_ACCESS_RESTRICTIONSReplaces the list of teams with push access to a protected branch. This action sets (replaces) the teams that have push access to a protected branch. Unlike 'Add team access restrictions' (POST), this action replaces the entire list rather than adding to it. Use an empty list to remove all team restrictions. Prerequisites: - The repository must be owned by an organization (not a personal account) - The branch must have protection rules enabled - The branch protection must have restrictions configured - The teams must exist in the organization and have repository access
Input parameters
The name of the repository, without the `.git` extension. This value is not case-sensitive.
The organization name that owns the repository. Team access restrictions only work for organization-owned repositories, not personal repositories. This value is not case-sensitive.
The list of team slugs to grant push access to the protected branch. A team slug is the URL-friendly version of the team name (lowercase, hyphens instead of spaces). The teams must already have access to the repository. This REPLACES the entire existing list of teams with push access (use empty list to remove all teams).
The name of the protected branch to set team restrictions on. The branch must already have branch protection enabled with restrictions configured. Wildcard characters are not supported. For wildcard branch protection, use the GitHub GraphQL API.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_USER_ACCESS_RESTRICTIONSReplaces the list of users with push access to a protected branch in an organization repository. Important notes: - This action only works on organization-owned repositories (not personal repos) - The branch must already have protection rules with restrictions enabled - This REPLACES (not adds to) the existing list of users with push access - Users must have write access to the repository to be added - The combined total of users, apps, and teams is limited to 100 items - To add users without replacing, use the 'add_user_access_restrictions' action instead
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository (must be an organization for user restrictions). This name is not case-sensitive.
The list of user logins (usernames) to grant push access to the protected branch. This REPLACES the existing list of users. Users must have write access to the repository. Pass an empty list \[\] to remove all user restrictions. The combined total of users, apps, and teams is limited to 100 items.
The name of the branch. Cannot contain wildcard characters. To use wildcards in branch names, use the GitHub GraphQL API.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_USER_INTERACTION_LIMIT_GRAPH_QLTool to set interaction limits on a user's public repositories using GraphQL. Use when you need to temporarily restrict who can comment, open issues, or create pull requests. Limits apply to the authenticated user or a specified user.
Input parameters
The level of interaction to limit. EXISTING_USERS limits to users with accounts older than 24 hours, CONTRIBUTORS_ONLY limits to prior contributors, COLLABORATORS_ONLY limits to collaborators only.
When the interaction limit expires.
The global ID of the user to set interaction limits for. This is required and must be a valid GitHub user node ID.
A unique identifier for the client performing the mutation. Used to track requests.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SET_WORKFLOW_EXTERNAL_ACCESSSets the access level for workflows outside a repository to use actions and reusable workflows within that repository.
Input parameters
Repository name, without `.git` extension. Not case-sensitive.
Owner's username or organization name. Not case-sensitive.
Specifies the level of access workflows outside this repository have to its actions and reusable workflows. - `none`: Actions and reusable workflows are accessible only from workflows within this repository. - `user`: Actions and reusable workflows can be shared with other private repositories owned by the same user. - `organization`: Actions and reusable workflows can be shared with other repositories within the same organization.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_STAR_A_GISTStars a GitHub gist identified by `gist_id`; this action is idempotent and returns a 204 No Content status upon success, even if the gist is already starred.
Input parameters
The unique identifier of the gist. This ID is the string of characters found at the end of a gist's URL.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USERStars a specified repository (identified by owner and repo name) for the authenticated user; this action is idempotent and succeeds even if the repository is already starred. Requires explicit repository identification via owner and repo parameters.
Input parameters
Required. The name of the repository, without the `.git` extension. This field is not case-sensitive.
Required. The username of the account that owns the repository. This field is not case-sensitive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_START_A_CODESPACE_FOR_THE_AUTHENTICATED_USERInitiates the startup process for an existing GitHub Codespace (identified by `codespace_name`) if it's in a startable state like 'Available' or 'Stopped'.
Input parameters
The unique name of the codespace to be started. This is the identifier for the codespace, often system-generated or user-defined.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_STOP_A_CODESPACE_FOR_AN_ORGANIZATION_USERStops a running codespace for an organization member. This action allows organization administrators to stop a codespace that belongs to a member of their organization. The codespace must be in a running state (e.g., 'Available') to be stopped. Required permissions: - OAuth/PAT: admin:org scope - Fine-grained tokens: 'Organization codespaces' (write) or 'Codespaces lifecycle admin' (write) Common HTTP responses: - 200: Codespace successfully stopped, returns codespace object - 304: Not modified (codespace already stopped) - 401: Authentication required - 403: Insufficient permissions (need admin:org) - 404: Organization, user, or codespace not found
Input parameters
The organization name (login). Case-insensitive. The authenticated user must have admin:org permissions for this organization.
The GitHub username (login) of the organization member whose codespace will be stopped.
The unique name of the codespace to stop. This is typically a hyphenated string like 'username-repo-name-randomchars'. You can obtain this from the 'List codespaces for a user in organization' action.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_STOP_A_CODESPACE_FOR_THE_AUTHENTICATED_USERStops a running or available Codespace for the authenticated user, pausing its execution and billing.
Input parameters
The unique name of the Codespace to be stopped. This name is assigned by GitHub when the Codespace is created.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SUBMIT_A_REVIEW_FOR_A_PULL_REQUESTFinalizes a pending pull request review (identified by `review_id`) with a required `event` (APPROVE, REQUEST_CHANGES, COMMENT) and an optional `body`.
Input parameters
The main textual content of the review. Highly recommended for `COMMENT` events to provide context; can also supplement `APPROVE` or `REQUEST_CHANGES` actions.
The name of the repository, without the `.git` extension. Case-insensitive.
The review action: `APPROVE`, `REQUEST_CHANGES`, or `COMMENT`. An invalid/omitted event will result in an HTTP 422 error and set the review state to `PENDING`, requiring a subsequent valid submission.
The username of the account that owns the repository. Case-insensitive.
Identifier of the pending review to be submitted. Typically obtained when a review is first created or initiated.
The number that uniquely identifies the pull request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_SYNC_FORK_BRANCH_WITH_UPSTREAMSynchronizes a branch in a forked GitHub repository with its upstream counterpart, assuming the repository is a fork, the branch exists, an upstream is configured, and the merge is conflict-free.
Input parameters
The name of the forked repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name of the account that owns the forked repository. This field is not case-sensitive.
The name of the branch in the forked repository that should be updated to match the corresponding branch in the upstream repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_TEST_REPOSITORY_WEBHOOKTriggers a simulated push event to test a repository's push webhook; a test event is only delivered if the webhook is subscribed to 'push' events, otherwise, it returns 204 No Content without sending a POST.
Input parameters
Name of the repository, without the `.git` extension (not case-sensitive).
Account owner of the repository (not case-sensitive).
Unique identifier of the hook, found in the `X-GitHub-Hook-ID` header of a webhook delivery or by listing repository webhooks.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_TRANSFER_A_REPOSITORYInitiates a repository transfer to a new owner (who must accept the request); if the new owner is an organization, it must be configured to allow transfers.
Input parameters
Name of the repository to transfer, without `.git` (case-insensitive).
Current owner's username or organization name (case-insensitive).
Optional new name for the repository post-transfer; retains current name if unspecified.
List of team IDs to add the repository to if `new_owner` is an organization; teams must belong to the `new_owner`.
Target username or organization name for the repository transfer.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UNBLOCK_A_USERUnblocks a GitHub user, provided they are currently blocked by the authenticated user.
Input parameters
The GitHub username (handle) of the user to unblock.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UNBLOCK_USER_FROM_ORGANIZATIONUnblocks a user from an organization, allowing renewed interaction with its resources, provided the user is currently blocked (otherwise, a 404 error may occur).
Input parameters
The name of the organization. This is case-insensitive.
The GitHub username of the user to unblock.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UNFOLLOW_A_USERUnfollows an existing GitHub user; this action is idempotent, succeeding even if the authenticated user is not currently following them.
Input parameters
The GitHub username (handle) of the user whom the authenticated user wishes to unfollow.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UNFOLLOW_ORGANIZATIONTool to unfollow a GitHub organization using GraphQL. Use when you need to stop following a specific organization on GitHub.
Input parameters
The Node ID of the organization to unfollow (e.g., 'MDEyOk9yZ2FuaXphdGlvbjk5MTk='). This is the global GraphQL node ID, not the organization name or numeric ID.
A unique identifier for the client performing the mutation. This value will be returned in the response and can be used for request tracking or idempotency.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UNFOLLOW_USERTool to unfollow a GitHub user using GraphQL. Use when you need to stop following a specific user on GitHub.
Input parameters
The Node ID of the user to unfollow (e.g., 'MDQ6VXNlcjE='). This is the global GraphQL node ID, not the username or numeric user ID.
A unique identifier for the client performing the mutation. This value will be returned in the response and can be used for request tracking or idempotency.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UNLOCK_AN_ISSUEUnlocks a currently locked GitHub issue in the specified repository, allowing new comments and interactions.
Input parameters
The name of the repository, without the `.git` extension. This value is not case-sensitive.
The username (account) or organization name that owns the repository. This value is not case-sensitive.
The number that uniquely identifies the issue within the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UNLOCK_ORGANIZATION_REPOSITORYUnlocks a repository that was locked for migration within a GitHub organization. This action is part of the organization migrations workflow. When you start a migration with `lock_repositories=true`, the source repositories are locked to prevent changes during export. After the migration is complete and applied to the target instance, use this action to unlock the repositories so they can be accessed or deleted. Requirements: - You must be an organization owner to unlock repositories - The repository must be currently locked as part of the specified migration - This endpoint does not work with GitHub App tokens or fine-grained personal access tokens Typical workflow: 1. Start an organization migration with POST /orgs/{org}/migrations 2. Wait for the migration to complete (state: "exported") 3. Apply the migration to your target instance 4. Unlock each migrated repository using this action 5. Delete the source repositories if no longer needed
Input parameters
The name of the GitHub organization that owns the migration. This name is not case-sensitive.
The name of the repository to unlock. Must be one of the repositories included in the specified migration.
The unique numeric identifier of the organization migration. You can find this by listing organization migrations using GET /orgs/{org}/migrations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UNLOCK_USER_REPOSITORYUnlocks a repository (`repo_name`) that was locked as part of a user migration (`migration_id`), making it usable or deletable; this action requires the repository to be currently locked.
Input parameters
The name of the repository to unlock.
The unique identifier of the user migration.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UNSTAR_A_GISTRemoves a star from the specified gist; the action is idempotent and will not error if the gist was not previously starred by the user.
Input parameters
The unique identifier (ID) of the gist to be unstarred. This ID can be retrieved from API endpoints that list gists or from the gist's URL.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UNSTAR_REPOSITORYRemoves the authenticated user's star from a specified repository, which must already be starred by the user.
Input parameters
Repository name, without the `.git` extension (case-insensitive).
Username of the repository owner (case-insensitive).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_A_CHECK_RUNUpdates an existing check run for a specific commit in a repository, allowing modifications to its status, conclusion, output, and other details. NOTE: This endpoint requires GitHub App authentication with 'checks:write' permission - OAuth tokens and personal access tokens cannot update check runs.
Input parameters
Name of the check (e.g., "code-coverage").
Repository name without the `.git` extension (not case sensitive).
Account owner of the repository (not case sensitive).
Current status of the check run. Only GitHub Actions can set `waiting`, `pending`, or `requested`.
JSON string representing user-triggerable actions (max 3), each with `label`, `identifier`, and `description`.
Final conclusion of the check. Required if `completed_at` is provided or `status` is `completed`. Providing `conclusion` sets `status` to `completed`. Users cannot set `stale`.
Timestamp of when the check run started (ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`).
URL of the integrator's site with full check details.
Reference for the run on the integrator's system.
The unique identifier of the check run.
Timestamp of when the check run completed (ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`).
Text for the output, can contain Markdown.
Title for the check run output. Displayed prominently in the GitHub checks UI.
JSON string representing images for the output, displayed in the GitHub PR UI.
Summary of the output, can contain Markdown. Required if the `output` object is provided.
JSON string representing line-specific analysis information, visible in PRs. Max 50 per request (appended to existing). GitHub Actions: 10 warnings/10 errors per step.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_A_CODE_SCANNING_ALERTUpdates a specific code scanning alert in a GitHub repository, primarily to change its state (e.g., 'open' or 'dismissed').
Input parameters
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The new state for the code scanning alert. Must be either 'open' or 'dismissed'. If 'dismissed', `dismissed_reason` is mandatory.
The number that identifies an alert. Found in the alert's URL or the `number` field of the GET alerts API response.
The reason for dismissing or closing the alert. **Required if `state` is 'dismissed'.**
An optional comment to provide further context when dismissing an alert. Maximum 280 characters.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_A_COMMIT_COMMENTChanges the body of an existing commit comment.
Input parameters
The new content of the comment.
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
The unique identifier of the comment.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_A_CUSTOM_ORGANIZATION_ROLEUpdates an existing custom role in an organization by modifying its name, description, or permissions; at least one of these fields must be provided.
Input parameters
The organization name (not case-sensitive).
New name for the custom role. Unchanged if omitted.
Unique identifier of the custom organization role.
The system role from which this role inherits permissions. One of: 'none', 'read', 'triage', 'write', 'maintain', or 'admin'. Unchanged if omitted.
New short description for the role. Unchanged if omitted.
New list of GitHub organization permissions for the role, replacing existing ones. An empty list removes all permissions. Unchanged if omitted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_A_DEPLOYMENT_BRANCH_POLICYUpdates the name pattern of an existing deployment branch policy for a specific environment in a repository.
Input parameters
The new name pattern that branches must match to deploy to this environment. Wildcard characters (`*`) can be used but will not match `/`. For example, to match branches that begin with `release/` and contain an additional single slash, use `release/*/*`. For more information about pattern matching syntax, refer to the Ruby File.fnmatch documentation (https://ruby-doc.org/core-2.5.1/File.html#method-c-fnmatch).
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository. This name is not case-sensitive.
The unique identifier of the deployment branch policy to be updated.
The name of the deployment environment. This name must be URL-encoded if it contains special characters such as slashes (e.g., replace `/` with `%2F`).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_A_DISCUSSIONUpdates the title and/or body of a specific team discussion within an organization.
Input parameters
The organization name (not case-sensitive).
The new body text for the discussion post. Supports markdown formatting. Only provide this if you want to change the body content.
The new title for the discussion post. Only provide this if you want to change the title.
The slug of the team name.
The unique number that identifies the discussion within the team.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_A_DISCUSSION_COMMENTUpdates the body of a comment in a team's discussion within an organization.
Input parameters
The name of the organization. This is not case sensitive.
The new body text for the discussion comment. Supports GitHub Flavored Markdown.
The slug of the team name. This is the team name converted to lowercase with spaces replaced by hyphens (e.g., 'justice-league').
The unique number identifying the comment within the discussion.
The unique number identifying the discussion.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_A_GISTUpdates a gist's description, and/or its files (including content, filename changes, or deletion).
Input parameters
Specifies changes to gist files as a JSON string. Keys are current filenames (e.g., `hello.py`). For each file: update `content`, assign a new `filename` to rename (or both). To delete a file, set its value to `null` or an object without `content` or `filename`. Files not mentioned are preserved.
The unique identifier of the gist to be updated.
A new description for the gist.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_A_GIST_COMMENTUpdates an existing comment on a specified gist.
Input parameters
The new text content for the comment. Supports Markdown formatting.
The unique identifier of the gist. This is typically a 32-character hexadecimal string found in the gist URL.
The unique numeric identifier of the comment to update.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_A_LABELUpdates an existing label's name, color, or description within a specified repository.
Input parameters
Current name of the label to be updated; value is not case-sensitive.
Name of the repository, without the .git extension; value is not case-sensitive.
Hexadecimal color code for the label, without the leading '#' (e.g., 'f29513').
Account owner of the repository; value is not case-sensitive.
New name for the label (not case-sensitive). Emoji can be added using native characters or colon-style markup (e.g., ':strawberry:'). Refer to GitHub's emoji cheat sheet for a full list of codes.
Short description for the label (max 100 characters).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_A_MILESTONEUpdates a milestone in a repository, identified by `owner`, `repo`, and `milestone_number`, by allowing modification of its `title`, `state`, `description`, or `due_on`; at least one of these four attributes must be provided to perform an update.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username of the account that owns the repository. This field is not case-sensitive.
The new state of the milestone. If not provided, the state will remain unchanged. Defaults to 'open'.
The new title for the milestone. If not provided, the title will remain unchanged.
The milestone due date in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`. If not provided, the due date will remain unchanged. To remove the due date, pass an empty string or `null`.
A new description for the milestone. If not provided, the description will remain unchanged.
The unique number that identifies the milestone.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_AN_ENVIRONMENT_VARIABLEUpdates an existing environment variable's name and/or value in a specific GitHub repository environment; requires providing either a new name or a new value.
Input parameters
Current name of the environment variable to update.
The name of the repository without the `.git` extension. The name is not case sensitive.
The account owner of the repository. The name is not case sensitive.
New value for the environment variable; if omitted, the value is not changed.
New name for the environment variable. If provided, the variable will be renamed to this value. If omitted, the name remains unchanged.
The name of the environment. The name must be URL encoded (e.g., replace slashes `/` with `%2F`).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_AN_ISSUEUpdates an existing GitHub issue's title, body, state, milestone, labels, or assignees; `state_reason` is only processed if `state` also changes, and use `null` or `\[\]` to clear applicable fields.
Input parameters
New issue body; send `null` to clear, omit to leave unchanged.
Repository name, without the `.git` extension (case-insensitive).
Owner of the repository (case-insensitive).
New issue state; omit to leave unchanged.
New issue title; send `null` to clear, omit to leave unchanged.
Replaces all existing labels. Send `\[\]` to remove all; omit to leave unchanged. Requires push access for changes.
DEPRECATED: Username to assign; use `assignees`. Send `null` to unassign, omit to leave unchanged.
Replaces all existing assignees. Send `\[\]` to remove all; omit to leave unchanged. Requires push access for changes.
Milestone ID (as string) or title. Send `null` to clear; omit to leave unchanged. Numeric ID recommended.
Unique number identifying the issue.
Reason for state change, considered only if `state` also changes. Valid reasons depend on the new `state`.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_AN_ISSUE_COMMENTUpdates an existing comment on an issue or pull request within a specified repository. You can only update comments that the authenticated user has permission to edit. The comment_id can be obtained from the list_issue_comments or get_an_issue_comment actions.
Input parameters
New content for the issue comment (GitHub Flavored Markdown supported).
Name of the repository, without the `.git` extension (not case-sensitive).
Username of the account owning the repository (not case-sensitive).
Unique ID of the issue comment to update.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_AN_ORGANIZATIONUpdates an organization's settings; changing security-related fields requires admin, owner, or security manager permissions.
Input parameters
The organization's unique, case-insensitive identifier.
URL of the organization's blog.
Display name.
Publicly visible email address.
Company name.
Geographical location.
Short description.
Billing email address (not publicly visible).
Twitter username.
Whether repository-level projects can be used within the organization.
Whether members can create GitHub Pages sites. Does not affect existing sites.
Whether organization-level projects can be used.
Whether web interface commits require sign-off.
Default permission for members on organization repositories.
Whether members can create public GitHub Pages sites. Does not affect existing sites.
Whether non-admin members can create repositories. Overridden by `members_allowed_repository_creation_type`.
Whether members can create private GitHub Pages sites. Does not affect existing sites.
Whether members can fork private repositories of the organization.
Whether members can create public repositories.
Whether members can create private repositories.
Types of repositories non-admin members can create. `private` option only on GitHub Enterprise Cloud. Deprecated; overrides `members_can_create_repositories`.
Whether members can create internal repositories. Only for organizations in an enterprise account.
URL displayed if `secret_scanning_push_protection_custom_link_enabled` is true and a push is blocked.
Automatically enable secret scanning for new repositories.
Automatically enable dependency graph for new repositories.
Automatically enable GitHub Advanced Security for new repositories.
Automatically enable Dependabot alerts for new repositories.
Show custom link to contributors blocked by secret scanning push protection.
Automatically enable Dependabot security updates for new repositories.
Automatically enable secret scanning push protection for new repositories.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_AN_ORGANIZATION_VARIABLEUpdates an existing GitHub Actions organization variable's name, value, or visibility (`all`, `private`, `selected`), requiring `selected_repository_ids` with valid repository IDs if visibility is `selected`.
Input parameters
The organization name. The name is not case sensitive.
The current name of the organization variable to be updated. This name is case-sensitive.
Optional: The new value for the organization variable. If provided, the variable's value will be updated. If omitted or null, the current value is preserved.
Optional: The new name for the organization variable. If provided, the variable will be renamed. If omitted or null, the current name is preserved.
Optional: Specifies the new visibility of the organization variable. Determines which repositories can access this variable: 'all' (all repositories), 'private' (only private repositories), or 'selected' (specific repositories). When set to 'selected', you must also provide `selected_repository_ids`. If omitted or null, visibility remains unchanged.
Optional: A list of repository IDs (integers) that can access this organization variable. Required when `visibility` is set to 'selected'. Ignored for other visibility values. If omitted when visibility='selected', the API may reject the request or use existing repository access list.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_AN_ORGANIZATION_WEBHOOKUpdates the configuration (URL, content type, secret, SSL verification), subscribed events, active status, or name of an existing webhook for a specified organization.
Input parameters
The name of the organization. This value is not case-sensitive.
Must be passed as 'web' for organization webhooks. This is a fixed value required by the GitHub API.
Set to `true` to send notifications, or `false` to disable them.
List of events that trigger this webhook. GitHub REPLACES the full event list when this is sent — omit (leave unset) to preserve the existing event subscription. Use `\['*'\]` to subscribe to all events. See GitHub docs for available event types.
The unique identifier of the webhook. This ID can be found in the `X-GitHub-Hook-ID` header of a webhook delivery.
Target URL for webhook payloads. Required if updating other `config` properties (e.g., `content_type`, `secret`), as GitHub mandates `url` when `config` is modified.
Secret key for HMAC digest to ensure payload integrity. Refer to GitHub documentation on delivery headers for details.
Media type for serializing payloads (`json` or `form`). The API defaults to `form` if this field is not provided.
Controls SSL certificate verification for payload delivery. Set to '1' to skip verification (insecure), or '0' to enforce (API default). Use with caution.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_A_PROJECTUpdates an existing GitHub project (V2) attributes like title, description, visibility, and state. Note: This action uses GitHub's Projects V2 GraphQL API. The legacy Projects (classic) REST API was sunset on April 1, 2025. The project is identified by its number (visible in the project URL) and owner (either a username or organization name). If no owner is specified, the authenticated user is assumed. At least one field to update must be provided.
Input parameters
The organization that owns the project. If provided, this takes precedence over username.
The new title for the project. If not provided, the title will not be changed.
Sets whether the project is closed. `True` closes the project, `False` reopens it. If not provided, the state will not be changed.
Sets the visibility of the project. `True` makes it public (visible to everyone), `False` makes it private. If not provided, the visibility will not be changed.
The project's README content (supports Markdown formatting). If not provided, the README will not be changed.
The GitHub username who owns the project. If not provided, defaults to the authenticated user.
The project's sequential number (e.g., 1, 2, 3). This is displayed in the project URL as https://github.com/users/{username}/projects/{project_number}.
A short description for the project (displayed in project cards and listings). If not provided, the description will not be changed.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_A_PULL_REQUESTUpdates an existing pull request, allowing changes to attributes like title, body, state, base branch, and maintainer modification settings.
Input parameters
The name of the branch to which you want your changes pulled. This must be an existing branch in the current repository. Cannot update the base branch to point to another repository. If None, the base branch remains unchanged.
The new contents of the pull request. To remove the body, pass an empty string. If None, the body remains unchanged.
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository. This name is not case-sensitive.
The new state of the pull request. Can be 'open' or 'closed'. If None, the state remains unchanged.
The new title for the pull request. If None, the title remains unchanged.
The unique number that identifies the pull request within the repository.
Indicates whether \[maintainers can modify\](https://docs.github.com/articles/allowing-changes-to-a-pull-request-branch-created-from-a-fork/) the pull request. If None, this setting remains unchanged.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_A_PULL_REQUEST_BRANCHUpdates an open pull request's head branch by merging the latest changes from its base branch, if mergeable and repository merging is enabled; operates asynchronously.
Input parameters
Repository name, without the `.git` extension (not case-sensitive).
Account owner of the repository (not case-sensitive).
Unique number identifying the pull request.
SHA of the expected head commit of the pull request's branch. If this SHA does not match the actual head SHA, the request fails (422 error), ensuring the branch was not updated unexpectedly. If omitted, the API uses the current head SHA of the branch.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_A_REFERENCEUpdates an existing Git reference (e.g., a branch or tag) to point to a specific commit SHA. By default, only allows fast-forward updates (where the new commit is a descendant of the current one). Set `force=true` to allow non-fast-forward updates that rewrite history. IMPORTANT: The reference must already exist - use 'Create a reference' action to create new refs.
Input parameters
The name of the Git reference to update WITHOUT the 'refs/' prefix. For branches: use 'heads/<branch-name>' (e.g., 'heads/main', 'heads/feature-branch'). For tags: use 'tags/<tag-name>' (e.g., 'tags/v1.0.0'). Note: Branch references require 'heads/' (plural), not 'head/' (singular). Bare branch names will be automatically prefixed with 'heads/'. The reference must already exist - this endpoint only updates existing refs.
The SHA1 commit hash to point this reference to. Must be exactly 40 hexadecimal characters (0-9, a-f) representing a valid commit that exists in the repository.
Repository name, excluding `.git` extension (case-insensitive).
Controls whether to allow non-fast-forward updates. When `false` (default), the new commit must be a direct descendant of the current commit (fast-forward only) - this prevents accidental history rewriting. When `true`, allows moving the reference to any commit, even if it means rewriting history or moving backward. Set to `true` only when you need to force-push changes, reset a branch, or intentionally rewrite commit history.
Account owner of the repository (case-insensitive).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_A_RELEASEUpdates an existing release in a GitHub repository, allowing modification of its attributes; if linking a discussion, the `discussion_category_name` must refer to an existing category in the repository.
Input parameters
Text describing the contents of the release. Supports GitHub Flavored Markdown.
The title of the release.
The name of the repository, without the `.git` extension. This name is not case-sensitive.
Set to `true` to mark the release as a draft, or `false` to publish it. Default: `false`.
The account owner of the repository. This name is not case-sensitive.
The name of the tag. This can be an existing tag or a new tag name.
Set to `true` to identify the release as a pre-release, or `false` for a full release. Default: `false`.
The unique identifier of the release to be updated.
Specifies whether this release should be set as the latest release for the repository. Accepts 'true', 'false', or 'legacy'. Drafts and pre-releases cannot be set as latest. Defaults to `true` for newly published releases. `legacy` specifies that the latest release should be determined based on the release creation date and higher semantic version.
Specifies the commitish value (e.g., branch name or commit SHA) that determines where the Git tag is created from. Can be any branch or commit SHA. This parameter is unused if the Git tag specified by `tag_name` already exists. Defaults to the repository's default branch if omitted.
If specified, a discussion of this category is created and linked to the release. The category must already exist in the repository. This parameter is ignored if a discussion is already linked to the release. For more information, see "\[Managing categories for discussions in your repository\](https://docs.github.com/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository)."
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_A_RELEASE_ASSETUpdates the name, label, or state of a release asset in a GitHub repository, requiring at least one of these properties to be provided for modification.
Input parameters
The new file name for the asset. This updates the display name of the asset.
The name of the repository without the `.git` extension. The name is not case sensitive.
An alternate short description for the asset. This is used in place of the filename if provided, offering a more descriptive label.
The account owner of the repository. The name is not case sensitive.
The new state of the release asset. While the GitHub API documentation primarily shows 'state' in responses (e.g., 'uploaded'), this field allows attempting to update it. The effect and accepted values might be specific.
The unique identifier of the release asset to be updated.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_A_REPOSITORYUpdates settings for an existing GitHub repository, such as name, description, visibility, merge strategies, and security configurations.
Input parameters
New name for the repository (not case-sensitive).
ACTUAL name of an existing repository, without the `.git` extension (not case-sensitive). MUST be a real repository that exists and is accessible - placeholder values like 'your-repo-name' will cause 404 errors.
ACTUAL GitHub username or organization name that owns the repository (not case-sensitive). MUST be a real, existing account - placeholder values like 'your-username' will cause 404 errors.
Whether the repository is private. IMPORTANT: Public forks cannot be made private - this is a GitHub platform restriction. Changing visibility may also be restricted by organization policies.
Archives the repository (making it read-only) or unarchives it.
Enables the GitHub Wiki.
URL of the project's homepage.
Enables GitHub Issues for this repository.
Repository visibility. IMPORTANT: Public forks cannot be made private - this is a GitHub platform restriction.
Brief summary of the repository.
Designates this repository as a template repository.
Enables GitHub Projects. Note: Organization settings might override this and cause an error if projects are disabled organization-wide.
Allows private forks of this repository. IMPORTANT: This setting can ONLY be changed for organization-owned repositories. Attempting to set this for user-owned repositories will result in a 422 error. Omit this field if you don't want to change the forking setting.
Name of the default branch.
Enables auto-merge for pull requests.
Allows merging pull requests via merge commits.
Allows rebase-merging pull requests.
Allows squash-merging pull requests.
Default title for merge commits: 'PR_TITLE' or 'MERGE_MESSAGE'. CONSTRAINT: If set to 'PR_TITLE', merge_commit_message must be 'PR_BODY' or 'BLANK'. If set to 'MERGE_MESSAGE', merge_commit_message must be blank/unset.
Allows updating a pull request's head branch from the base branch if not strictly required for merging.
Default message for merge commits: 'PR_BODY', 'PR_TITLE', or 'BLANK'. CONSTRAINT: If merge_commit_title is 'PR_TITLE', this must be 'PR_BODY' or 'BLANK'. Cannot be set when merge_commit_title is 'MERGE_MESSAGE'.
Automatically deletes head branches after merging pull requests.
Default title for squash merge commits: 'PR_TITLE' or 'COMMIT_OR_PR_TITLE'.
Default message for squash merge commits: 'PR_BODY', 'COMMIT_MESSAGES', or 'BLANK'.
Requires contributors to sign off on web-based commits.
DEPRECATED: Use `squash_merge_commit_title`. If true, squash merge commits use PR title; otherwise, commit message.
Manages secret scanning. Set to 'enabled' or 'disabled'.
Manages GitHub Advanced Security. Set to 'enabled' or 'disabled'.
Manages secret scanning push protection. Set to 'enabled' or 'disabled'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_A_REPOSITORY_INVITATIONUpdates an active repository invitation to modify the invited user's permissions; the specified repository and invitation must exist.
Input parameters
The name of the repository, without the `.git` extension. This name is not case sensitive.
The account owner of the repository (e.g., a username or organization name). This name is not case sensitive.
The new permissions to grant the invited user on the repository.
The unique identifier of the repository invitation to be updated.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_A_REPOSITORY_RULESETUpdates an existing repository ruleset, identified by `ruleset_id` for a given repository, allowing partial updates to its configuration such as name, target, enforcement, bypass actors, conditions, and rules.
Input parameters
The new name for the ruleset.
The name of the repository without the `.git` extension. This name is not case sensitive.
The account owner of the repository. This name is not case sensitive.
String representing rules to enforce. Each rule has a `type` and optional `parameters` (e.g., `\[{'type': 'creation'}, {'type': 'pull_request', 'parameters': {'required_approving_review_count': 2}}\]`). Accepts both JSON format with double quotes or Python list syntax with single quotes. Refer to GitHub API documentation for available rule types and their parameters.
The target of the ruleset (e.g., branch or tag).
The unique identifier of the existing ruleset to be updated.
Specifies the enforcement level: `disabled` (ruleset is ignored), `active` (ruleset is enforced), or `evaluate` (allows testing rules before enforcement - GitHub Enterprise only).
String representing actors that can bypass ruleset. Each actor specifies `actor_id`, `actor_type` (`RepositoryRole`, `Team`, `Integration`, `OrganizationAdmin`), and `bypass_mode` (`always`, `pull_request`). Accepts both JSON format with double quotes or Python list syntax with single quotes. Example: `\[{'actor_id': 1, 'actor_type': 'RepositoryRole', 'bypass_mode': 'always'}\]`.
Ref names or patterns (fnmatch-style globs) to exclude. The ruleset will not apply if any of these patterns match.
Ref names or patterns (fnmatch-style globs) to include for the ruleset to apply. `~DEFAULT_BRANCH` targets the default branch; `~ALL` targets all branches.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_A_REPOSITORY_VARIABLEUpdates the name and/or value of an existing GitHub Actions variable in a repository.
Input parameters
The current name of the Actions variable to update (path parameter). Variable names are case-insensitive and can only contain alphanumeric characters or underscores.
The name of the repository, without the `.git` extension; case-insensitive.
The account owner of the repository (e.g., GitHub username or organization name); case-insensitive.
The new value for the Actions variable. If omitted, the current value is retained. Must be a non-empty string if provided. You must provide either new_name or value (or both).
Optional new name for the variable. If provided, renames the variable. Can only contain alphanumeric characters or underscores; cannot start with GITHUB_ prefix.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_A_REPOSITORY_WEBHOOKUpdates the URL, content type, secret, SSL verification, events, or active status for an existing repository webhook, specified by `owner`, `repo`, and `hook_id`.
Input parameters
Repository name, without the `.git` extension (not case-sensitive).
Username or organization name of the repository owner (not case-sensitive).
Set `true` if active and sending notifications, `false` otherwise.
List of events to trigger the webhook. GitHub REPLACES the full event list when this is sent — omit (leave unset) to preserve the existing subscription. Use `add_events`/`remove_events` for incremental changes. See GitHub webhook event payloads docs for available event types.
Unique identifier of the webhook (found in `X-GitHub-Hook-ID` header of a delivery).
Events to add to current subscriptions.
New URL for webhook payload delivery.
Events to remove from current subscriptions.
Optional secret for HMAC digest of delivery signature headers (see GitHub docs).
Media type for serializing payloads ('json' or 'form').
Set to '1' to disable SSL verification (insecure), '0' to enable.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_A_TEAMUpdates a team's settings (e.g., name, description, privacy, parent team) within a GitHub organization, identified by its slug and organization name.
Input parameters
The organization's name (case-insensitive). This is a required path parameter.
New display name for the team.
The desired privacy level for the team. Editing teams without specifying this parameter leaves `privacy` intact. When a team is nested, the `privacy` for parent teams cannot be `secret`. - For a non-nested team: - `secret`: Visible only to organization owners and members of this team. - `closed`: Visible to all members of this organization. - `public`: Visible to all members of this organization (equivalent to `closed`). - For a parent or child team: - `closed`: Visible to all members of this organization. - `public`: Visible to all members of this organization (equivalent to `closed`).
The team's unique slug identifier (typically URL-friendly version of team name). This is a required path parameter.
**Deprecated**. Default permission (pull, push, or admin) for new repositories added to this team. This may be removed in future versions.
New team description; an empty string clears the existing description.
The unique identifier (ID) of an existing team to set as this team's parent. This establishes a nested team structure. To remove an existing parent team relationship and make this a top-level team, explicitly pass `null` for this field (e.g., by setting this parameter to Python `None`). If this parameter is not provided in the request, the current parent team, if any, remains unchanged.
The notification setting the team has chosen. Editing teams without specifying this parameter leaves `notification_setting` intact. - `notifications_enabled`: Team members receive notifications when the team is @mentioned. - `notifications_disabled`: No one receives notifications for team @mentions.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_BRANCH_PROTECTIONUpdates the protection settings for an existing branch in a repository, which must not contain wildcard characters.
Input parameters
The name of the repository, without the `.git` extension (not case-sensitive).
The account owner of the repository (not case-sensitive).
Name of the branch to protect; wildcard characters are not allowed (use GraphQL API for wildcard support).
If `True`, sets the branch to read-only, preventing pushes.
Enforces configured restrictions for repository administrators. Set to `True` to enforce for admins, or `None`/`null` to disable.
Allows deletion of the protected branch.
If `True`, push restrictions also apply to creating matching new branches, unless pusher has explicit push access.
Permits force pushes to the protected branch. Set to `True` to allow, `None`/`null` to block.
Allows users to pull upstream changes into their fork when the branch is locked.
App `slug`s with push access. Cannot be used with `restrictions_users` or `restrictions_teams`. Empty list removes all.
Team `slug`s with push access. Cannot be used with `restrictions_apps` or `restrictions_users`. Empty list removes all.
User `login`s with push access. Cannot be used with `restrictions_apps` or `restrictions_teams`. Empty list removes all.
Enforces linear commit history by preventing merge commits. Repository must allow squash or rebase merging.
List of status checks required to merge. Each check object needs a `context` string and optionally an `app_id` integer. **Mutually exclusive with `contexts`** - use one or the other, not both.
Require branches to be up to date with the base branch before merging; if `True`, merges are blocked if the head branch is behind the base branch.
Requires all conversations on code to be resolved before merging a pull request.
**Deprecated**: List of status check contexts required to merge. If set by a GitHub App, future checks must come from that app. Use `checks` for finer control. **Mutually exclusive with `checks`** - use one or the other, not both.
If `True`, new commits dismiss previous review approvals on a pull request branch.
Number of approving reviews (0-6) required to merge a pull request; 0 disables.
App `slug`s allowed to bypass pull request requirements. Empty list removes all.
Team `slug`s allowed to bypass pull request requirements. Empty list removes all.
User `login`s allowed to bypass pull request requirements. Empty list removes all.
App `slug`s allowed to dismiss pull request reviews. Empty list removes all.
Team `slug`s allowed to dismiss pull request reviews. Empty list removes all.
User `login`s allowed to dismiss pull request reviews. Empty list removes all.
If `True`, pull requests affecting files with code owners must be reviewed by them.
If `True`, the most recent push must be approved by someone other than the pusher.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_CODE_SCANNING_DEFAULT_SETUPUpdates the default setup configuration for code scanning in a repository; GitHub Advanced Security must be enabled for the repository.
Input parameters
Repository name (case-insensitive, without `.git` extension).
Account owner of the repository (case-insensitive).
Specifies whether to enable ('configured') or disable ('not-configured') code scanning default setup.
CodeQL languages for analysis; if omitted, all supported repository languages are analyzed.
CodeQL query suite to be used ('default' for curated, 'extended' for comprehensive queries).
Type of runner to use for code scanning. 'standard' uses GitHub-hosted runners, 'labeled' uses self-hosted runners with a specific label, 'not_set' resets to default.
Label of the self-hosted runner to use when runner_type is 'labeled'. Ignored when runner_type is 'standard'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_CODESPACEUpdates an existing GitHub Codespace's machine type, display name, or recent folders for the authenticated user; machine type changes take effect on the next start.
Input parameters
Target machine type for the codespace; must be valid and available for the user or organization.
New display name for the codespace.
The unique name of the codespace to be updated (e.g., 'octocat-codespace-githu-org-name-abcdef12').
Up to three recently opened folder paths (e.g., '/workspaces/project/src') to suggest which folder to load upon opening.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_GIT_LFS_PREFERENCESets the Git Large File Storage (LFS) preference for a repository during a source import. NOTE: This endpoint has been deprecated by GitHub as of April 12, 2024, and is no longer available. The Source Imports REST API has been retired due to very low usage levels. Please use the GitHub Importer tool at https://github.com/new/import for repository imports.
Input parameters
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
Specifies whether to store large files using Git LFS during the import. `opt_in` enables Git LFS, storing large files. `opt_out` disables Git LFS, removing large files during the import.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_ISSUE_TYPEUpdate an existing issue type for a GitHub organization. Requires the authenticated user to be an organization administrator. OAuth tokens need admin:org scope.
Input parameters
The organization name (case-insensitive).
The name of the issue type.
The color of the issue type.
Whether the issue type is enabled at the organization level.
A short description of the issue type.
The unique identifier of the issue type to update.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_ORGANIZATION_WEBHOOK_CONFIGURATIONUpdates the configuration (URL, content type, secret, SSL verification) for an existing webhook within a specified organization.
Input parameters
The organization name (not case-sensitive).
The URL to which the webhook payloads will be delivered.
Optional secret for HMAC hex digest in delivery signature headers.
Unique identifier of the webhook (from `X-GitHub-Hook-ID` header of a delivery).
Media type for serializing payloads (`json` or `form`). Defaults to `form`.
Set to `1` to disable SSL certificate verification for the webhook URL, or `0` to enable. Defaults to `0`.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_PROJECT_CARDUpdates an existing project card's note and/or archived status (GitHub Classic Projects). DEPRECATION NOTICE: GitHub Projects (classic) and its REST API were sunset on April 1, 2025. This action will return 404 for most requests on GitHub.com. However, it may still work on GitHub Enterprise Server instances where classic projects are enabled. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/
Input parameters
New note content (supports GitHub Flavored Markdown). Use empty string or `null` to clear the note. If omitted, the note remains unchanged.
The unique identifier of the project card to be updated. This ID must correspond to an existing classic project card.
Archive status: `true` to archive the card, `false` to unarchive it. If omitted, the archived status remains unchanged.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_PROJECT_COLUMNUpdates the name of an existing column, identified by `column_id`, in a GitHub project (classic). DEPRECATION NOTICE: GitHub Classic Projects (V1) and its REST API were sunset on April 1, 2025. This action will return a 404 error on GitHub.com. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/
Input parameters
The new name for the project column.
The unique identifier of the project column to be updated.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_PULL_REQUEST_REVIEWUpdates the body text of an existing pull request review.
Input parameters
The new body text for the pull request review. This will replace the existing review body.
The name of the repository, without the `.git` extension. This is case-insensitive.
The username of the account that owns the repository. This is case-insensitive.
The unique identifier of the pull request review to be updated.
The number that uniquely identifies the pull request within the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_PULL_REQUEST_REVIEW_COMMENTUpdates the body of an existing review comment on a pull request.
Input parameters
The new text of the pull request review comment. Must be a non-empty string.
The name of the repository, without the `.git` extension. This field is not case-sensitive.
The username or organization name that owns the repository. This field is not case-sensitive.
The unique identifier of the pull request review comment to be updated.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_PULL_REQUEST_REVIEW_PROTECTIONUpdates pull request review protection settings (e.g., required approvals, review dismissal, bypass allowances) for a branch; branch protection features must be available for the repository.
Input parameters
Repository name, without the `.git` extension (case-insensitive).
Account owner of the repository (case-insensitive).
Branch name for protection rules (no wildcards; use GraphQL API for wildcards).
If `true`, new commits dismiss previous approving reviews; `false` keeps approvals valid.
If `true`, pull requests affecting files with code owners require their review. See \[about code owners\](https://docs.github.com/articles/about-code-owners/).
If `true`, the most recent push requires approval by someone other than the pusher (GitHub Enterprise feature).
App `slug`s permitted to dismiss pull request reviews. Empty list removes restrictions.
Team `slug`s permitted to dismiss pull request reviews. Empty list removes restrictions.
User `login`s permitted to dismiss pull request reviews. Empty list removes restrictions.
Number of approving reviews (1-6) required for merging; 0 to disable.
App `slug`s allowed to bypass pull request requirements. Empty list removes allowances.
Team `slug`s allowed to bypass pull request requirements. Empty list removes allowances.
User `login`s allowed to bypass pull request requirements. Empty list removes allowances.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_REPOSITORY_PREFERENCES_FOR_CHECK_SUITESUpdates repository preferences for automatic Check Suite creation on code pushes, allowing configuration for specific GitHub Apps that must be installed on the repository with `checks:write` permission.
Input parameters
The name of the repository, without the `.git` extension. The name is not case sensitive.
The account owner of the repository (e.g., username or organization). The name is not case sensitive.
A list of preference objects as a JSON string for configuring automatic CheckSuite creation for specific GitHub Apps. Each object in the list must contain an `app_id` (integer: the ID of the GitHub App) and a `setting` (boolean: `true` to enable automatic triggers for that app on code push, `false` to disable). Example: '\[{"app_id": 12345, "setting": true}\]'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_REPOSITORY_WEBHOOK_CONFIGURATIONUpdates the configuration (e.g., payload URL, content type, secret, SSL verification) for an existing webhook in a specified repository.
Input parameters
The URL to which webhook payloads will be delivered.
The name of the repository, without the `.git` extension (not case-sensitive).
The account owner of the repository (not case-sensitive).
Optional secret for generating an HMAC hex digest of the payload, included in the `X-Hub-Signature-256` header to verify authenticity.
Unique identifier of the webhook, typically found in the `X-GitHub-Hook-ID` header of a webhook delivery.
Media type for payload serialization (e.g., `json`, `form`). GitHub defaults to `form` if this field is not provided.
Specifies SSL certificate verification: '0' for enabled (default behavior if omitted), '1' for disabled (not recommended).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_RESOURCE_ACCESS_WITH_TOKENSRevokes organization access for the personal access tokens identified by `pat_ids`; this action must be performed by a GitHub App, and `pat_ids` must be valid and associated with the organization. AUTHENTICATION REQUIREMENT: This endpoint requires GitHub App authentication with 'Personal access tokens' organization permissions (write). Standard personal access tokens CANNOT use this endpoint. The GitHub App must also have access to the organization.
Input parameters
Organization name (case-insensitive).
Operation to perform on the fine-grained personal access tokens, resulting in removal of their access.
Fine-grained personal access token IDs for which access will be revoked.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_STATUS_CHECK_PROTECTIONUpdates required status checks for a branch, optionally requiring it to be up-to-date before merging.
Input parameters
The name of the repository, without the `.git` extension. This name is not case-sensitive.
The account owner of the repository. This name is not case-sensitive.
The name of the branch (required, cannot be null or empty). Wildcard characters are not allowed. To use wildcard characters in branch names, please use the GraphQL API.
A list of status checks to require in order to merge into this branch. Each check object should have a `context` (string) and an optional `app_id` (integer). Example: `\[{"context": "continuous-integration/jenkins", "app_id": 12345}\]`
Specifies whether to require branches to be up to date before merging.
**Deprecated**: A list of status checks to require in order to merge into this branch. If any of these checks were recently set by a particular GitHub App, they will be required to come from that app in the future for the branch to merge. For more fine-grained control, use `checks` instead of `contexts`. Can be provided as a single string or a list of strings.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_SUBSCRIPTIONTool to update notification subscription state for issues, pull requests, or discussions. Use when you need to subscribe, unsubscribe, or ignore notifications for a specific GitHub item.
Input parameters
The new subscription state. SUBSCRIBED: receive notifications for all activity. UNSUBSCRIBED: stop receiving notifications. IGNORED: never receive notifications even when mentioned.
The Node ID of the subscribable object (issue, pull request, discussion, etc.) to modify. This is a global GraphQL ID, not a repository-local number.
A unique identifier for the client performing the mutation. Used for tracking and deduplication.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_THE_AUTHENTICATED_USERUpdates the authenticated user's GitHub profile; a new public email must be verified, and existing private emails remain private even if specified.
Input parameters
The new short biography for the user. Provide `null` to clear the existing bio.
The new URL for the user's blog. Provide `null` to clear the existing blog URL. For example, 'https://github.blog'.
The new full name for the user. For example, 'Mona Lisa Octocat'.
The user's new publicly visible email address. This email must be verified on the user's GitHub account. If the provided email is not verified or not set to public, the update for this field might be ignored.
The new company affiliation for the user. Provide `null` to clear the existing company. For example, 'GitHub'.
Indicates whether the user is available for hire. Set to `true` if available, or `false` if not.
The new geographical location of the user. Provide `null` to clear the existing location. For example, 'San Francisco'.
The user's new Twitter username (without the leading '@'). Provide `null` to clear the existing Twitter username. For example, 'github'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_TOKEN_ORG_ACCESSRevokes a fine-grained personal access token's access to an organization. IMPORTANT: This endpoint can ONLY be called by GitHub Apps with 'Personal access tokens' organization permissions (write). Personal access tokens (PATs) cannot use this endpoint. Use GITHUB_LIST_ORG_RESOURCE_ACCESS_TOKENS to get valid pat_id values for tokens that have access to your organization.
Input parameters
The organization name (case-insensitive). The authenticated GitHub App must have 'Personal access tokens' organization permissions (write) for this organization.
The action to perform. Currently only 'revoke' is supported, which removes the token's access to the organization.
The unique numeric identifier of the fine-grained personal access token to revoke. Obtain this from the GITHUB_LIST_ORG_RESOURCE_ACCESS_TOKENS action.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_USER_LISTTool to update an existing GitHub user list. Use when you need to modify the name, description, or privacy settings of a user list.
Input parameters
The new name for the user list. Only provide if you want to change the name.
The unique ID of the user list to update. This is the GraphQL node ID (e.g., 'UL_kwDOCNqc1s4AbuJ8').
Whether the list should be private. Set to true to make private, false to make public. Only provide if you want to change visibility.
The new description for the user list. Only provide if you want to change the description.
A unique identifier for the client performing the mutation. Used for idempotency and tracking.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_USER_LISTS_FOR_ITEMTool to update which of the viewer's lists an item belongs to on GitHub. Use when you need to add an item (repository, issue, pull request, etc.) to specific user lists or move it between lists.
Input parameters
The global node ID of the item to add to the lists (e.g., 'R_kgDOKl1DMA' for a repository). This is the GraphQL global identifier returned by GitHub's API.
The list of user list IDs that this item should belong to. The item will be added to these lists and removed from any other lists it previously belonged to.
A unique identifier for the client performing the mutation. This can be used to track the request.
Optional list of suggested list IDs to create and add this item to. These lists will be created if they don't exist.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_USER_PROJECT_ITEMTool to update a field value for an item in a user's GitHub ProjectV2. Use when you need to modify a field value of an existing project item.
Input parameters
The value to set. Use {'text': 'value'} for text fields, {'number': 123} for number fields, {'singleSelectOptionId': 'option_id'} for single select, {'date': '2024-01-01'} for date fields, {'iterationId': 'iteration_id'} for iteration fields.
The global node ID of the project item to update (e.g., 'PVTI_lAHOCNqc1s4BN3oqzgldG_w').
The global node ID of the field to update (e.g., 'PVTSSF_lAHOCNqc1s4BN3oqzg8vTnA').
The global node ID of the Project (e.g., 'PVT_kwHOCNqc1s4BN3oq').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPDATE_USER_STATUSTool to update your status on GitHub. Use when you need to set or clear your GitHub profile status with an emoji, message, and availability indicator.
Input parameters
The emoji to represent your status. Can either be a native Unicode emoji or an emoji name with colons, e.g., :rocket:, :smiley:. If omitted, any existing emoji will be cleared.
A short description of your current status. Maximum 80 characters. If omitted, any existing message will be cleared.
If set, the user status will not be shown after this date. Must be a valid ISO 8601 datetime string (e.g., 2024-12-31T23:59:59Z). If omitted, the status will persist indefinitely.
The global node ID of the organization whose members will be allowed to see the status. If omitted, the status will be publicly visible to everyone. Use this to limit status visibility to organization members only.
A unique identifier for the client performing the mutation. This value will be returned in the response and can be used for request tracking or idempotency.
Whether this status should indicate you are not fully available on GitHub (e.g., you are away or busy). When true, shows a busy indicator. Defaults to false if omitted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPLOAD_RELEASE_ASSETTool to upload a binary asset to an existing GitHub release. Use when you need to attach files like installers or backups to a release programmatically.
Input parameters
Repository name without the .git extension; not case sensitive.
Binary file to upload as the release asset.
Short description for the asset; displayed instead of filename.
Account owner of the repository; not case sensitive.
Unique identifier of the release. The release must have a valid upload URL (i.e., not already finalized without one). Asset size must not exceed 2 GB.
Media type of the asset, for example 'application/zip'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPLOAD_SARIF_ANALYSISUploads a gzipped and Base64 encoded SARIF file to a GitHub repository for a specific commit and reference; use `checkout_uri` if SARIF paths are absolute.
Input parameters
The full Git reference for the analysis, formatted as `refs/heads/<branch name>`, `refs/tags/<tag>`, `refs/pull/<number>/merge`, or `refs/pull/<number>/head`.
The name of the repository, without the `.git` extension. This is case-insensitive.
The account owner of the repository. This is case-insensitive.
A Base64 encoded string of a gzipped SARIF file. For more information, see '\[SARIF support for code scanning\](https://docs.github.com/code-security/secure-coding/sarif-support-for-code-scanning)'.
Specifies whether the uploaded SARIF file should be validated against the code scanning specifications. This is useful for integrators to ensure their SARIF files are correctly processed and rendered by GitHub.
Name of the tool that generated the analysis. GitHub defaults this to "API" if omitted. A tool GUID in the SARIF can be used for filtering alerts.
The SHA of the commit to which the analysis you are uploading relates. Must be a 40-character Git SHA.
The timestamp indicating when the analysis run began, in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.
The base URI of the checkout directory as it appears in the SARIF file. This property is used to convert absolute file paths to relative paths, enabling alerts to be correctly mapped to their location in the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_UPSERT_REPO_CUSTOM_PROPERTY_VALUESCreates or updates up to 30 custom property values for a repository; custom properties must be predefined at the organization or repository level, and setting a property's value to `null` removes it.
Input parameters
The name of the repository, without the `.git` extension. This name is not case sensitive.
The account owner of the repository. This name is not case sensitive.
A list of custom property objects as a JSON string to create or update for the repository. Each object in the list must contain `property_name` (string identifying the custom property) and `value` (the value for the property, which can be a string, number, or a single-select option, matching the property's defined type). Example: '\[{"property_name": "environment", "value": "production"}\]'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GITHUB_VERIFY_DEV_CONTAINER_PERMISSIONS_ACCEPTEDVerifies if the authenticated user has accepted permissions for a specific devcontainer configuration in a repository, typically to ensure awareness before a codespace is created or used.
Input parameters
Git reference (branch, tag, or commit SHA) for the devcontainer configuration.
Repository name, without `.git` extension (case-insensitive).
Username of the repository owner (case-insensitive).
Path to the `devcontainer.json` file in the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 63 agents privately built on Nagent that already use GitHub.
Build on Nagent
Connect GitHub to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find GitHub, and click "Connect Now." You'll authenticate with OAuth — Nagent handles credential storage and refresh automatically. Once connected, GitHub is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once GitHub is connected, you configure its 867 actions and 46 triggers directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop GitHub steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a GitHub event fires, the agent kicks off automatically.
Every GitHub action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While GitHub ships with 867 pre-built developer tools actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching GitHub together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build GitHub-based workflows tailored to your business.