GitHub
GitHub
Section titled “GitHub”Connect GitHub from Integrations in the Workforce AI dashboard, then ask your AI employee to use it as part of a job. The action reference below is normalized from the current GitHub toolkit reference into plain business language.
Good first jobs
Section titled “Good first jobs”- Find a repository, pull request, or issue.
- Turn a reproduced problem into a clear issue draft.
- Summarize recent development activity.
Connect GitHub
Section titled “Connect GitHub”- Open Workforce AI and choose Integrations.
- Find GitHub and select Connect.
- Complete the provider sign-in or connection details shown on screen.
- Return to your AI employee and give it one clear job using GitHub.
The provider controls which accounts and workspaces you can authorize. You can reconnect or remove the connection from the Integrations page.
Available tools
Section titled “Available tools”- Add app access restrictions
- Add assignees to an issue
- Add a repository collaborator
- Add email address for authenticated user
- Add field to user project
- Add item to user project
- Add labels to an issue
- Add org runner labels
- Add or update team membership for user
- Add or update team project permissions
- Add or update team repository permissions
- Add project collaborator
- Add repository to app installation
- Add repo to org secret with selected access
- Add repo to org secret with selected visibility
- Add runner labels
- Add selected repository to organization secret
- Add selected repository to organization variable
- Add selected repository to user secret
- Add social accounts for authenticated user
- Add status check contexts
- Add sub issue
- Add team access restrictions
- Add users to codespaces access for organization
- Add user access restrictions
- Approve workflow run for fork pull request
- Artifact created trigger
- Auth user docker conflict packages list
- Branch changed trigger
- Branch created trigger
- Cancel github pages deployment
- Cancel sponsorship
- Cancel workflow run
- Check following
- Check if a repository is starred by the user
- Check if gist is starred
- Check if pull request has been merged
- Check if pull request merged
- Check if repo starred by auth user
- Check if user can be assigned
- Check if user can be assigned to issue
- Check if user follows another user
- Check if user is blocked by authenticated user
- Check if user is blocked by organization
- Check if user is repository collaborator
- Check person followed by auth user
- Check private vulnerability reporting status
- Check public organization membership for user
- Check repository starred
- Check run status changed trigger
- Check suite status changed trigger
- Check team permissions for a project
- Check team permissions for a repository
- Check token
- Code scanning alert created trigger
- Collaborator added trigger
- Create an autolink reference for a repository
- Create an environment variable
- Create an issue
- Create an issue comment
- Create an organization project
- Create an organization repository
- Create an organization variable
- Create an organization webhook
- Create a blob
- Create a check run
- Create a check suite
- Create a codespace for the authenticated user
- Create a codespace from a pull request
- Create a codespace in a repository
- Create a commit
- Create a commit comment
- Create a commit status
- Create a custom organization role
- Create a deployment
- Create a deployment branch policy
- Create a deployment status
- Create a deploy key
- Create a discussion
- Create a discussion comment
- Create a fork
- Create a gist
- Create a gist comment
- Create a github app from a manifest
- Create a github pages deployment
- Create a github pages site
- Create a label
- Create a milestone
- Create a project card
- Create a project column
- Create a pull request
- Create a reference
- Create a registration token for an organization
- Create a registration token for a repository
- Create a release
- Create a remove token for an organization
- Create a remove token for a repository
- Create a reply for a review comment
- Create a repository dispatch event
- Create a repository for the authenticated user
- Create a repository from an unpublished codespace
- Create a repository project
- Create a repository ruleset
- Create a repository using a template
- Create a repository variable
- Create a repository webhook
- Create a review comment for a pull request
- Create a review for a pull request
- Create a scoped access token
- Create a snapshot of dependencies for a repository
- Create a tag object
- Create a tag protection state for a repository
- Create a team
- Create a temporary private fork
- Create a tree
- Create a user project
- Create a workflow dispatch event
- Create branch
- Create commit signature protection
- Create deployment protection rule
- Create draft item for user project
- Create inference chat completions
- Create inference embeddings
- Create issue type
- Create jit runner config
- Create or update an environment
- Create or update an environment secret
- Create or update an organization secret
- Create or update a repository secret
- Create or update a secret for the authenticated user
- Create or update custom properties for an org
- Create or update custom property org
- Create or update file contents
- Create or update github pages site
- Create or update repo secret with encrypted value
- Create reaction for an issue
- Create reaction for an issue comment
- Create reaction for a commit comment
- Create reaction for a pull request review comment
- Create reaction for a release
- Create reaction for a team discussion
- Create reaction for a team discussion comment
- Create repository
- Create sponsorship
- Create sponsors tier
- Create update org secret with lib sodium
- Create user list
- Create view for user project
- Delete access restrictions
- Delete admin branch protection
- Delete app authorization
- Delete app token
- Delete artifact
- Delete autolink reference
- Delete a file
- Delete a package version for the authenticated user
- Delete a reference
- Delete a release
- Delete a release asset
- Delete a release reaction
- Delete a repository
- Delete a repository invitation
- Delete a repository ruleset
- Delete a repository secret
- Delete a repository subscription
- Delete a repository variable
- Delete a repository webhook
- Delete a review comment for a pull request
- Delete a secret for the authenticated user
- Delete a self hosted runner from an organization
- Delete a self hosted runner from a repository
- Delete a tag protection state for a repository
- Delete a team
- Delete a thread subscription
- Delete a workflow run
- Delete branch protection
- Delete codespace
- Delete code scanning analysis
- Delete commit comment
- Delete commit comment reaction
- Delete commit signature protection
- Delete custom organization role
- Delete dependebot secret by name
- Delete deployment
- Delete deployment branch policy
- Delete deploy key
- Delete discussion
- Delete discussion comment
- Delete email address
- Delete environment
- Delete environment secret
- Delete environment variable
- Delete gist
- Delete gist comment
- Delete github actions cache by ID
- Delete github pages site
- Delete issue comment
- Delete issue comment reaction
- Delete issue reaction
- Delete label
- Delete milestone
- Delete organization
- Delete organization secret
- Delete organization variable
- Delete organization webhook
- Delete org codespace
- Delete org package
- Delete package
- Delete package version
- Delete package version for an organization
- Delete package version for a user
- Delete pending review
- Delete project
- Delete project card
- Delete project column
- Delete project item for user
- Delete pull request comment reaction
- Delete pull request review protection
- Delete repo codespace secret by name
- Delete social accounts for the authenticated user
- Delete team discussion comment reaction
- Delete team discussion reaction
- Delete user list
- Delete user package
- Delete workflow run logs
- Deployment created trigger
- Deployment state changed trigger
- Download an artifact
- Download a repository archive tar
- Download a repository archive zip
- Download job logs for a workflow run
- Download workflow run attempt logs
- Download workflow run logs
- Encrypt and update dev secret
- Find pull requests
- Find repositories
- Force cancel workflow run
- Get access restrictions
- Get admin branch protection
- Get all api versions
- Get all contributor commit activity
- Get all deployment protection rules for an environment
- Get all deployment protection rules for env
- Get all repository rulesets
- Get an app
- Get an artifact
- Get an assignment
- Get an autolink reference of a repository
- Get an environment
- Get an environment public key
- Get an environment secret
- Get an environment variable
- Get an issue
- Get an issue comment
- Get an issue event
- Get an organization
- Get an organization public key
- Get an organization role
- Get an organization secret
- Get an organization variable
- Get an organization webhook
- Get assignment grades
- Get a blob
- Get a branch
- Get a commit
- Get a milestone
- Get a package for an organization
- Get a package for a user
- Get a package for the authenticated user
- Get a package version for an organization
- Get a package version for a user
- Get a package version for the authenticated user
- Get a project
- Get a project card
- Get a project column
- Get a pull request
- Get a reference
- Get a release
- Get a release asset
- Get a release by tag name
- Get a repository
- Get a repository public key
- Get a repository readme
- Get a repository readme for a directory
- Get a repository ruleset
- Get a repository rule suite
- Get a repository secret
- Get a repository subscription
- Get a repository variable
- Get a repository webhook
- Get a review comment for a pull request
- Get a review for a pull request
- Get a secret for the authenticated user
- Get a self hosted runner for an organization
- Get a self hosted runner for a repository
- Get a tag
- Get a team by name
- Get a thread
- Get a thread subscription for the authenticated user
- Get a tree
- Get a user
- Get a webhook configuration for an organization
- Get a webhook configuration for a repository
- Get a webhook delivery for an organization webhook
- Get a workflow
- Get a workflow run
- Get a workflow run attempt
- Get billing usage report user
- Get branch protection
- Get catalog models
- Get check run
- Get check suite
- Get classroom
- Get codeql database
- Get codespace
- Get code of conduct
- Get code of conduct graph ql
- Get code scanning alert
- Get code scanning analysis
- Get code scanning default setup
- Get commit authors
- Get commit comment
- Get commit object
- Get commit signature protection
- Get commit statuses
- Get community profile metrics
- Get contextual information for a user
- Get custom deployment protection rule
- Get default attributes for a codespace
- Get default workflow permissions for an organization
- Get default workflow permissions for a repository
- Get dependency diff
- Get deployment
- Get deployment branch policy
- Get deployment status
- Get deploy key
- Get details about a codespace export
- Get discussion
- Get discussion comment
- Get emojis
- Get enterprise member invitation
- Get feeds
- Get gist
- Get gist comment
- Get gist revision
- Get github actions cache usage for an organization
- Get github actions cache usage for a repository
- Get github actions permissions for an organization
- Get github actions permissions for a repository
- Get github billing premium request usage report user
- Get github billing usage summary for user
- Get github meta information
- Get github pages build
- Get gitignore template
- Get global security advisory
- Get graphql node
- Get graphql rate limit
- Get information about a sarif upload
- Get interaction restrictions for an organization
- Get interaction restrictions for a repository
- Get interaction restrictions for public repos
- Get issue comments
- Get label
- Get large files
- Get latest pages build
- Get license
- Get license graph ql
- Get octocat
- Get oidc subject claim template
- Get organization audit log
- Get organization custom property
- Get organization project item
- Get organization public key
- Get organization public key for dependabot
- Get organization teams
- Get org allowed actions
- Get org dev environment secret safely
- Get org oidc subject claim template
- Get pages dns health check
- Get pages site
- Get page views
- Get pending deployments for a workflow run
- Get project permission for a user
- Get public key for secret encryption
- Get public key for the authenticated user
- Get pull requests
- Get pull request review protection
- Get rate limit status for the authenticated user
- Get raw repository content
- Get repository clones
- Get repository content
- Get repository graph ql
- Get repository owner
- Get repository permissions for a user
- Get repository public key for encryption
- Get repository secret securely
- Get repository security advisory
- Get repository webhook delivery
- Get repos attestations
- Get repo allowed actions
- Get repo dev env secret
- Get rules for a branch
- Get single org secret without decryption
- Get status checks protection
- Get teams with access to the protected branch
- Get team members
- Get team membership for a user
- Get the authenticated user
- Get the combined status for a specific reference
- Get the hourly commit count for each day
- Get the last year of commit activity
- Get the latest release
- Get the license for a repository
- Get the review history for a workflow run
- Get the status of a github pages deployment
- Get the weekly commit activity
- Get the weekly commit count
- Get the zen of github
- Get top referral paths
- Get top referral sources
- Get users attestations
- Get users projects v2
- Get users with access to the protected branch
- Get user by ID
- Get user project item
- Get viewer graphql
- Get workflow external access
- Get workflow run job
- Get workflow run usage
- Get workflow usage
- Git reference created trigger
- Issue assigned to me trigger
- Issue comment changed trigger
- Issue comment created trigger
- Issue created trigger
- Issue event occurred trigger
- Issue label changed trigger
- Issue state changed trigger
- Issue updated trigger
- List accepted assignments for an assignment
- List accessible repositories
- List apps with access to the protected branch
- List app installations
- List artifacts for a repository
- List assignees
- List assignments for a classroom
- List attestation repositories
- List available machine types for a repository
- List branches
- List branches for head commit
- List check runs for a ref
- List check runs in a check suite
- List check run annotations
- List check suites for a git reference
- List child teams
- List classrooms
- List codeowners errors
- List codeql databases for a repository
- List codespaces for a user in organization
- List codespaces for the authenticated user
- List codespaces for the organization
- List codes of conduct
- List codes of conduct graphql
- List code scanning alerts for an organization
- List code scanning alerts for a repository
- List code scanning analyses for a repository
- List comments for a pull request review
- List comment changes
- List commits
- List commits on a pull request
- List commit comments
- List commit comments for a repository
- List commonly used licenses
- List custom properties for an organization
- List custom property values for a repository
- List custom property values for org repos
- List deliveries for an organization webhook
- List deliveries for a repository webhook
- List deployments
- List deployment branch policies
- List deployment statuses
- List deploy keys
- List discussions
- List discussion comments
- List email addresses for the authenticated user
- List environments
- List environment custom deployment rules
- List environment secrets
- List environment variables
- List events for the authenticated user
- List events for user
- List events received by the authenticated user
- List followers of a user
- List followers of the authenticated user
- List following for user
- List forks
- List gists for a user
- List gists for the authenticated user
- List gist comments
- List gist commits
- List gist forks
- List github actions caches for a repository
- List github pages builds
- List gitignore templates
- List global security advisories
- List gpg keys for a user
- List installation requests for the authenticated app
- List instances of a code scanning alert
- List issues assigned to the authenticated user
- List issue comments
- List issue comments for a repository
- List issue dependencies blocked by
- List issue dependencies blocking
- List issue events
- List issue events for a repository
- List issue types
- List jobs for a workflow run
- List jobs for a workflow run attempt
- List labels for an issue
- List labels for a repository
- List labels for a self hosted runner for a repository
- List labels for issues in a milestone
- List labels for self hosted runner org
- List licenses graph ql
- List machine types for a codespace
- List matching references
- List milestones
- List notifications
- List notifications for the authenticated user
- List organizations
- List organizations for a user
- List organizations for the authenticated user
- List organizations for user
- List organization codespaces secrets
- List organization events for the authenticated user
- List organization members
- List organization memberships for the authenticated u
- List organization projects
- List organization repositories
- List organization roles for an organization
- List organization secrets
- List organization variables
- List organization webhooks
- List org fine grained permissions
- List org issues for the authenticated user
- List org package versions
- List org project view items
- List org repos with github actions enabled
- List org resources with personal tokens
- List org resource access tokens
- List org secrets without values
- List outside collaborators for an organization
- List owned package versions
- List packages for an organization
- List packages for a user
- List packages for the authenticated user
- List package versions for a package owned by a user
- List pending team invitations
- List project cards
- List project collaborators
- List project columns
- List project fields for user
- List project items for user
- List project view items for user
- List public emails for auth user
- List public events
- List public events for a network of repositories
- List public events for a user
- List public events received by a user
- List public gists
- List public keys for a user
- List public organization events
- List public organization members
- List public repositories
- List pull requests
- List pull requests associated with a commit
- List pull requests files
- List reactions for an issue
- List reactions for an issue comment
- List reactions for a commit comment
- List reactions for a pull request review comment
- List reactions for a release
- List reactions for a team discussion
- List reactions for a team discussion comment
- List releases
- List release assets
- List repositories
- List repositories accessible to the app installation
- List repositories for a user
- List repositories for the authenticated user
- List repositories starred by a user
- List repositories starred by the authenticated user
- List repositories watched by a user
- List repositories watched by the authenticated user
- List repositories with github actions cache usage
- List repository activities
- List repository autolinks
- List repository collaborators
- List repository contributors
- List repository events
- List repository invitations
- List repository issues
- List repository languages
- List repository organization secrets
- List repository organization variables
- List repository projects
- List repository rulesets
- List repository rule suites
- List repository secrets
- List repository secrets without decrypting
- List repository security advisories
- List repository tags
- List repository teams
- List repository topics
- List repository variables
- List repository webhooks
- List repository workflows
- List repo access by token
- List repo codespaces
- List repo dev container configs for user
- List repo invitations for auth user
- List repo notifications for auth user
- List repo secrets without values
- List requested reviewers for a pull request
- List reviews for a pull request
- List review comments in a repository
- List review comments on a pull request
- List runner applications for an organization
- List runner applications for a repository
- List secrets for the authenticated user
- List secret scanning alerts for a repository
- List security advisories graphql
- List security vulnerabilities
- List selected repositories for an organization secret
- List selected repositories for a user secret
- List selected repositories for secret access
- List selected repos org variable
- List self hosted runners for an organization
- List self hosted runners for a repository
- List social accounts for a user
- List social accounts for the authenticated user
- List sponsorables
- List ssh signing keys for a user
- List stargazers
- List starred gists
- List starred repositories for user
- List status check contexts
- List subscriptions for the authenticated user
- List subscriptions for the authenticated user stubbed
- List sub issues
- List tag protection states for a repository
- List teams
- List teams for the authenticated user
- List teams that are assigned to an organization role
- List team members
- List team projects
- List team repositories
- List the people a user follows
- List the people the authenticated user follows
- List timeline events for an issue
- List token access repositories
- List users
- List users blocked by an organization
- List users blocked by the authenticated user
- List users that are assigned to an organization role
- List user projects
- List watchers
- List workflow runs for a repository
- List workflow runs for a workflow
- List workflow run artifacts
- Lookup enterprise administrator invitation
- Lookup github resource
- Lookup nodes by ids
- Lookup organization graph ql
- Lookup topic by name
- Mark a thread as read
- Mark notifications as read
- Mark repository notifications as read
- Move a project card
- Move a project column
- New stargazer added trigger
- Pr review comment created trigger
- Publish sponsors tier graph ql
- Pull request commit added trigger
- Pull request reviewers changed trigger
- Pull request review submitted trigger
- Pull request state changed trigger
- Readme changed trigger
- Release asset added trigger
- Release state changed trigger
- Remove all labels from an issue
- Remove all organization roles for a team
- Remove all organization roles for a user
- Remove an organization member
- Remove an organization role from a team
- Remove an organization role from a user
- Remove app access restrictions
- Remove assignees from an issue
- Remove a custom property for an organization
- Remove a label from an issue
- Remove a project from a team
- Remove a repository collaborator
- Remove a repository from an app installation
- Remove a repository from a team
- Remove a selected repository from a user secret
- Remove custom labels from self hosted repo runner
- Remove custom label from repo runner
- Remove custom label from self hosted runner
- Remove interaction restrictions for an organization
- Remove interaction restrictions for a repository
- Remove org dev env secret by name
- Remove org secret by name
- Remove outside collaborator from an organization
- Remove public org membership
- Remove public repo interaction restrictions
- Remove repo from org dev env secret
- Remove repo from org secret with selected visibility
- Remove requested reviewers from a pull request
- Remove review request
- Remove selected repo from org secret
- Remove selected repo from org variable
- Remove status check contexts
- Remove status check protection
- Remove team access restrictions
- Remove team membership
- Remove team membership for a user
- Remove users codespaces access org
- Remove user access restrictions
- Remove user as a collaborator
- Replace repo access on org dev env secret set
- Repository content changed trigger
- Repository notification received trigger
- Repository tag created trigger
- Rerequest a check run
- Rerequest a check suite
- Review pending deployments for a workflow run
- Re run a job from a workflow run
- Re run a workflow
- Re run failed jobs from a workflow run
- Run graph ql query
- Run graph ql relay query
- Search code
- Search code all pages
- Search commits
- Search commits by author
- Search github graphql
- Search issues
- Search issues and pull requests
- Search labels
- Search repositories
- Search topics
- Search users
- Secret scanning alert detected trigger
- Set admin branch protection
- Set app access restrictions
- Set a repository subscription
- Set a thread subscription
- Set default workflow permissions for an organization
- Set default workflow permissions for a repository
- Set email visibility
- Set github actions permissions for an organization
- Set github actions permissions for a repository
- Set interaction restrictions for an organization
- Set interaction restrictions for a repository
- Set interaction restrictions for your public repos
- Set labels for an issue
- Set oidc subject claim template
- Set org allowed actions
- Set org runner labels
- Set repo allowed actions
- Set repo runner labels
- Set selected repositories for an organization secret
- Set selected repositories for a user secret
- Set selected repos for org variable
- Set status check contexts
- Set team access restrictions
- Set user access restrictions
- Set user interaction limit graph ql
- Set workflow external access
- Update an environment variable
- Update an issue
- Update an issue comment
- Update an organization
- Update an organization variable
- Update an organization webhook
- Update a check run
- Update a code scanning alert
- Update a commit comment
- Update a custom organization role
- Update a deployment branch policy
- Update a discussion
- Update a discussion comment
- Update a gist
- Update a gist comment
- Update a label
- Update a milestone
- Update a project
- Update a pull request
- Update a pull request branch
- Update a reference
- Update a release
- Update a release asset
- Update a repository
- Update a repository invitation
- Update a repository ruleset
- Update a repository variable
- Update a repository webhook
- Update a team
- Update branch protection
- Update codespace
- Update code scanning default setup
- Update git lfs preference
- Update issue type
- Update organization webhook configuration
- Update project card
- Update project column
- Update pull request review
- Update pull request review comment
- Update pull request review protection
- Update repository preferences for check suites
- Update repository webhook configuration
- Update resource access with tokens
- Update status check protection
- Update subscription
- Update the authenticated user
- Update token org access
- Update user list
- Update user lists for item
- Update user project item
- Update user status
- Upload release asset
- Upload sarif analysis
- Workflow added trigger
- Workflow job added trigger
- Workflow run artifact added
- Workflow run created
- Workflow run state changed trigger
Workforce AI applies its approval rules to actions that create, change, send, publish, move, or remove information. When an action needs approval, you will see it in Approvals before it runs.
How to ask for the work
Section titled “How to ask for the work”Use the result you want and the record or audience involved:
Using GitHub, find a repository, pull request, or issue. Show me the result here.
For recurring work, add the timing, the information to use, and the finish line. You can save a successful job as a schedule when it should run on a regular rhythm.
Common questions
Section titled “Common questions”Does Workforce AI need my GitHub password?
Section titled “Does Workforce AI need my GitHub password?”Use the provider sign-in or connection screen shown by Workforce AI. OAuth providers keep your password with the provider.
Why is a proposed action waiting?
Section titled “Why is a proposed action waiting?”Open Approvals in Workforce AI. Review the complete proposal, then approve or deny it.
How do I switch to another GitHub account?
Section titled “How do I switch to another GitHub account?”Open Integrations, remove or reconnect GitHub, and choose the account you want during the provider sign-in.
Can I use GitHub in a scheduled job?
Section titled “Can I use GitHub in a scheduled job?”Yes. Once the connection and job work the way you want, tell your AI employee when the job should run.