Gitea

Gitea Repository API

The repository API from Gitea — 133 operation(s) for repository.

Documentation GitHub OpenAPI

Business capability

Software Construction Management BC-4200.40

Operations 197

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /repos/migrate Migrate a remote git repository · Migrate a remote git repository #

Ask an LLM

“How do I import an existing repository from another git server into Gitea?”

“Can a migration also bring over issues, labels, milestones, releases and the wiki?”

Tell an agent

Migrate the repository at {clone_addr} into a new repo called {repo_name}.

Import {clone_addr} as {repo_name} under {repo_owner}, including its issues and pull requests.

GET /repos/search Search repositories · Search for repositories #

Ask an LLM

“What's the way to find repositories matching a keyword across the whole instance?”

“Can I search repos by topic and include their descriptions in the match?”

Tell an agent

Search all repositories for {q}.

Find repositories tagged with topic {q}, sorted by {sort}.

GET /repos/{owner}/{repo} Get a repository's details · Get a repository #

Ask an LLM

“How can I look up the details of a single repository, like its default branch and visibility?”

“What settings and metadata does a repository expose when I fetch it by owner and name?”

Tell an agent

Show me the details of repository {owner}/{repo}.

Get the default branch and visibility of {owner}/{repo}.

DELETE /repos/{owner}/{repo} Delete a repository · Delete a repository #

Ask an LLM

“How do I permanently delete a repository?”

“Can a deleted repository be recovered afterwards?”

Tell an agent destructive · confirm first

Delete the repository {owner}/{repo}.

Permanently remove {owner}/{repo} and all of its content.

PATCH /repos/{owner}/{repo} Change a repository's settings · Edit a repository's properties. Only fields that are set will be changed #

Ask an LLM

“Can I rename a repository or change its description and website?”

“How do I archive a repo or make it private after it was created?”

Tell an agent

Rename repository {owner}/{repo} to {name}.

Archive the repository {owner}/{repo}.

GET /repos/{owner}/{repo}/actions/artifacts List a repository's Actions artifacts · Lists all artifacts for a repository #

Ask an LLM

“What build artifacts have Actions workflows produced in this repository?”

“Can I filter a repository's workflow artifacts by name?”

Tell an agent

List all Actions artifacts in {owner}/{repo}.

Find artifacts named {name} across every run in {owner}/{repo}.

GET /repos/{owner}/{repo}/actions/artifacts/{artifact_id} Get one Actions artifact · Gets a specific artifact for a workflow run #

Ask an LLM

“How do I see the metadata of a single workflow artifact, like its size and expiry?”

“Which run produced a given artifact?”

Tell an agent

Show artifact {artifact_id} in {owner}/{repo}.

Get the size and expiry details of artifact {artifact_id} from {owner}/{repo}.

DELETE /repos/{owner}/{repo}/actions/artifacts/{artifact_id} Delete an Actions artifact · Deletes a specific artifact for a workflow run #

Ask an LLM

“How can I delete a workflow artifact I no longer need to free up storage?”

“Can I remove a single build artifact without deleting the whole run?”

Tell an agent destructive · confirm first

Delete artifact {artifact_id} from {owner}/{repo}.

Remove the workflow artifact {artifact_id} in {owner}/{repo} to free space.

GET /repos/{owner}/{repo}/actions/artifacts/{artifact_id}/zip Download an Actions artifact as a zip · Downloads a specific artifact for a workflow run redirects to blob url #

Ask an LLM

“How do I download the zip file of a workflow artifact?”

“Where does the artifact download redirect me to get the actual file?”

Tell an agent

Download artifact {artifact_id} from {owner}/{repo} as a zip.

Fetch the zip archive for artifact {artifact_id} in {owner}/{repo}.

GET /repos/{owner}/{repo}/actions/jobs List a repository's workflow jobs · Lists all jobs for a repository #

Ask an LLM

“Which Actions jobs have run across the whole repository recently?”

“Can I list only the jobs in a certain status, such as queued or failed, for a repo?”

Tell an agent

List all workflow jobs in {owner}/{repo}.

Show jobs in {owner}/{repo} with status {status}.

GET /repos/{owner}/{repo}/actions/jobs/{job_id} Get one workflow job · Gets a specific workflow job for a workflow run #

Ask an LLM

“How do I check the status and steps of a single Actions job?”

“What runner did a particular workflow job run on?”

Tell an agent

Show workflow job {job_id} in {owner}/{repo}.

Get the status and steps of job {job_id} in {owner}/{repo}.

GET /repos/{owner}/{repo}/actions/jobs/{job_id}/logs Download a workflow job's logs · Downloads the job logs for a workflow run #

Ask an LLM

“How can I get the log output of an Actions job to see why it failed?”

“Can I download the full logs of one job in a workflow run?”

Tell an agent

Download the logs for job {job_id} in {owner}/{repo}.

Fetch the log output of workflow job {job_id} from {owner}/{repo}.

GET /repos/{owner}/{repo}/actions/runners List a repository's Actions runners · Get repo-level runners #

Ask an LLM

“Which self-hosted runners are registered to this repository?”

“Can I list only the disabled runners attached to a repo?”

Tell an agent

List the Actions runners registered to {owner}/{repo}.

Show disabled runners for {owner}/{repo}, filtering on {disabled}.

POST /repos/{owner}/{repo}/actions/runners/registration-token Get a runner registration token for a repo · Get a repository's actions runner registration token #

Ask an LLM

“How do I get a token to register a new self-hosted runner for a repository?”

“Where does the registration token for connecting a runner to one repo come from?”

Tell an agent

Generate a runner registration token for {owner}/{repo}.

Create a new Actions runner registration token in {owner}/{repo}.

GET /repos/{owner}/{repo}/actions/runners/{runner_id} Get a repository runner · Get a repo-level runner #

Ask an LLM

“How can I check the status and labels of one runner attached to a repo?”

“Is a specific repository runner online or disabled?”

Tell an agent

Show runner {runner_id} in {owner}/{repo}.

Check whether runner {runner_id} for {owner}/{repo} is online.

DELETE /repos/{owner}/{repo}/actions/runners/{runner_id} Remove a repository runner · Delete a repo-level runner #

Ask an LLM

“How do I unregister a self-hosted runner from a repository?”

“Can I remove a runner that's no longer used by one repo?”

Tell an agent destructive · confirm first

Delete runner {runner_id} from {owner}/{repo}.

Unregister the Actions runner {runner_id} in {owner}/{repo}.

PATCH /repos/{owner}/{repo}/actions/runners/{runner_id} Enable or disable a repository runner · Update a repo-level runner #

Ask an LLM

“Can I temporarily disable a repository's runner so it stops picking up jobs?”

“How do I re-enable a runner I previously disabled on a repo?”

Tell an agent

Disable runner {runner_id} in {owner}/{repo} by setting disabled to {disabled}.

Re-enable Actions runner {runner_id} for {owner}/{repo} with disabled {disabled}.

GET /repos/{owner}/{repo}/actions/runs List a repository's workflow runs · Lists all runs for a repository run #

Ask an LLM

“Which Actions runs have happened in a repo, and can I filter them by branch or event?”

“How can I find the workflow runs triggered by a specific commit SHA or actor?”

Tell an agent

List workflow runs in {owner}/{repo}.

Show runs in {owner}/{repo} on branch {branch} with status {status}.

GET /repos/{owner}/{repo}/actions/runs/{run} Get a workflow run · Gets a specific workflow run #

Ask an LLM

“How do I check the outcome and timing of one workflow run?”

“What triggered a particular Actions run and did it succeed?”

Tell an agent

Show workflow run {run} in {owner}/{repo}.

Get the conclusion of run {run} in {owner}/{repo}.

DELETE /repos/{owner}/{repo}/actions/runs/{run} Delete a workflow run · Delete a workflow run #

Ask an LLM

“Can I delete an old workflow run from a repository's Actions history?”

“How do I clean up a run I no longer want to keep?”

Tell an agent destructive · confirm first

Delete workflow run {run} from {owner}/{repo}.

Remove Actions run {run} and its history in {owner}/{repo}.

GET /repos/{owner}/{repo}/actions/runs/{run}/artifacts List artifacts from one workflow run · Lists all artifacts for a repository run #

Ask an LLM

“Which artifacts did a single workflow run upload?”

“Can I filter the artifacts of one run by artifact name?”

Tell an agent

List the artifacts produced by run {run} in {owner}/{repo}.

Find the artifact named {name} from run {run} in {owner}/{repo}.

GET /repos/{owner}/{repo}/actions/runs/{run}/jobs List jobs in a workflow run · Lists all jobs for a workflow run #

Ask an LLM

“What jobs make up a particular workflow run and how did each one do?”

“Can I see only the failed jobs inside one run?”

Tell an agent

List the jobs in workflow run {run} of {owner}/{repo}.

Show jobs with status {status} in run {run} of {owner}/{repo}.

POST /repos/{owner}/{repo}/actions/runs/{run}/jobs/{job_id}/rerun Rerun a single job in a workflow run · Reruns a specific workflow job in a run #

Ask an LLM

“Can I rerun just one job in a run instead of the whole workflow?”

“How do I retry a single flaky job?”

Tell an agent

Rerun job {job_id} in run {run} of {owner}/{repo}.

Retry only job {job_id} from workflow run {run} in {owner}/{repo}.

POST /repos/{owner}/{repo}/actions/runs/{run}/rerun Rerun an entire workflow run · Reruns an entire workflow run #

Ask an LLM

“How do I rerun every job in a workflow run from scratch?”

“Is there a way to restart a whole Actions run?”

Tell an agent

Rerun the entire workflow run {run} in {owner}/{repo}.

Restart all jobs of run {run} in {owner}/{repo}.

POST /repos/{owner}/{repo}/actions/runs/{run}/rerun-failed-jobs Rerun the failed jobs of a workflow run · Reruns all failed jobs in a workflow run #

Ask an LLM

“Can I rerun only the jobs that failed in a run and keep the ones that passed?”

“What's the quickest way to retry the failures from one workflow run?”

Tell an agent

Rerun the failed jobs of run {run} in {owner}/{repo}.

Retry every failed job from workflow run {run} in {owner}/{repo}.

GET /repos/{owner}/{repo}/actions/secrets List a repository's Actions secrets · List an repo's actions secrets #

Ask an LLM

“Which Actions secrets are defined on a repository?”

“Can I see the names of repo secrets without their values?”

Tell an agent

List the Actions secrets for {owner}/{repo}.

Show the secret names configured in {owner}/{repo}.

PUT /repos/{owner}/{repo}/actions/secrets/{secretname} Create or update a repository secret · Create or Update a secret value in a repository #

Ask an LLM

“How do I add an Actions secret, like a deploy token, to a repository?”

“Can I overwrite the value of an existing repo secret?”

Tell an agent

Set secret {secretname} in {owner}/{repo} to {data}.

Create the Actions secret {secretname} for {owner}/{repo} with value {data} and description {description}.

DELETE /repos/{owner}/{repo}/actions/secrets/{secretname} Delete a repository secret · Delete a secret in a repository #

Ask an LLM

“How can I remove an Actions secret from a repository?”

“Will deleting a repo secret break workflows that reference it?”

Tell an agent destructive · confirm first

Delete the secret {secretname} from {owner}/{repo}.

Remove Actions secret {secretname} in {owner}/{repo}.

GET /repos/{owner}/{repo}/actions/tasks List a repository's Actions tasks · List a repository's action tasks #

Ask an LLM

“What Actions tasks have been executed for a repository?”

“Can I page through the task history of a repo's Actions?”

Tell an agent

List the Actions tasks for {owner}/{repo}.

Show the next {limit} Actions tasks for {owner}/{repo}.

GET /repos/{owner}/{repo}/actions/variables List a repository's Actions variables · Get repo-level variables list #

Ask an LLM

“Which Actions configuration variables does a repository define?”

“Can I list all repo-level variables available to workflows?”

Tell an agent

List the Actions variables in {owner}/{repo}.

Show all repo-level workflow variables for {owner}/{repo}.

GET /repos/{owner}/{repo}/actions/variables/{variablename} Get a repository Actions variable · Get a repo-level variable #

Ask an LLM

“How do I read the current value of one repo-level variable?”

“What is a specific Actions variable set to on a repository?”

Tell an agent

Get the variable {variablename} in {owner}/{repo}.

Show the value of Actions variable {variablename} for {owner}/{repo}.

PUT /repos/{owner}/{repo}/actions/variables/{variablename} Update a repository Actions variable · Update a repo-level variable #

Ask an LLM

“Can I change the value of a repo variable that already exists?”

“How do I rename an existing Actions variable on a repository?”

Tell an agent

Change existing variable {variablename} in {owner}/{repo} to {value}.

Rename Actions variable {variablename} in {owner}/{repo} to {name} with value {value}.

POST /repos/{owner}/{repo}/actions/variables/{variablename} Create a repository Actions variable · Create a repo-level variable #

Ask an LLM

“How do I add a new configuration variable for a repo's workflows?”

“Can I give a new repo-level variable a description when creating it?”

Tell an agent

Create a new variable {variablename} in {owner}/{repo} with value {value}.

Add Actions variable {variablename} = {value} to {owner}/{repo} described as {description}.

DELETE /repos/{owner}/{repo}/actions/variables/{variablename} Delete a repository Actions variable · Delete a repo-level variable #

Ask an LLM

“How can I remove a repo-level Actions variable?”

“Is it possible to delete a workflow variable I no longer use?”

Tell an agent destructive · confirm first

Delete the variable {variablename} from {owner}/{repo}.

Remove Actions variable {variablename} in {owner}/{repo}.

GET /repos/{owner}/{repo}/actions/workflows List a repository's workflows · List repository workflows #

Ask an LLM

“Which workflow files are defined in a repository?”

“Can I see all Actions workflows a repo has and whether they're enabled?”

Tell an agent

List the workflows in {owner}/{repo}.

Show every Actions workflow file defined in {owner}/{repo}.

GET /repos/{owner}/{repo}/actions/workflows/{workflow_id} Get a workflow · Get a workflow #

Ask an LLM

“How do I look up one workflow's details, like its path and state?”

“Is a particular workflow currently active?”

Tell an agent

Show workflow {workflow_id} in {owner}/{repo}.

Get the state and path of workflow {workflow_id} in {owner}/{repo}.

PUT /repos/{owner}/{repo}/actions/workflows/{workflow_id}/disable Disable a workflow · Disable a workflow #

Ask an LLM

“How do I stop a workflow from running without deleting its file?”

“Can I pause a scheduled workflow in a repository?”

Tell an agent

Disable workflow {workflow_id} in {owner}/{repo}.

Turn off the workflow {workflow_id} for {owner}/{repo}.

POST /repos/{owner}/{repo}/actions/workflows/{workflow_id}/dispatches Manually trigger a workflow · Create a workflow dispatch event #

Ask an LLM

“How do I kick off a workflow manually on a chosen branch or tag?”

“Can I pass inputs when triggering a workflow dispatch event?”

Tell an agent

Trigger workflow {workflow_id} in {owner}/{repo} on {ref}.

Dispatch workflow {workflow_id} in {owner}/{repo} on {ref} with inputs {inputs}.

PUT /repos/{owner}/{repo}/actions/workflows/{workflow_id}/enable Enable a workflow · Enable a workflow #

Ask an LLM

“How can I turn a disabled workflow back on?”

“Can I resume a workflow that was paused?”

Tell an agent

Enable workflow {workflow_id} in {owner}/{repo}.

Re-activate the disabled workflow {workflow_id} for {owner}/{repo}.

GET /repos/{owner}/{repo}/activities/feeds List a repository's activity feed · List a repository's activity feeds #

Ask an LLM

“What has been happening in a repository lately, like pushes and merged PRs?”

“Can I see a repo's activity for one specific date?”

Tell an agent

Show the activity feed for {owner}/{repo}.

List activity in {owner}/{repo} on {date}.

GET /repos/{owner}/{repo}/archive/{archive} Download a repository archive · Get an archive of a repository #

Ask an LLM

“How do I download a repo snapshot as a zip or tarball at a given branch or tag?”

“Can I archive just one subdirectory of a repository?”

Tell an agent

Download the archive {archive} of {owner}/{repo}.

Get archive {archive} of {owner}/{repo} limited to path {path}.

GET /repos/{owner}/{repo}/assignees List users who can be assigned to issues · Return all users that have write access and can be assigned to issues #

Ask an LLM

“Who can I assign issues to in a repository?”

“Which users have write access and are valid issue assignees?”

Tell an agent

List the possible issue assignees for {owner}/{repo}.

Show everyone in {owner}/{repo} who can be assigned issues.

POST /repos/{owner}/{repo}/avatar Update a repository's avatar · Update avatar #

Ask an LLM

“Can I set a custom avatar image for a repository?”

“How do I change a repo's picture?”

Tell an agent

Set the avatar of {owner}/{repo} to image {image}.

Upload {image} as the new avatar for {owner}/{repo}.

DELETE /repos/{owner}/{repo}/avatar Remove a repository's avatar · Delete avatar #

Ask an LLM

“How do I remove a repository's custom avatar?”

“Can I reset a repo back to the default picture?”

Tell an agent destructive · confirm first

Delete the avatar of {owner}/{repo}.

Remove the custom repository image from {owner}/{repo}.

GET /repos/{owner}/{repo}/branch_protections List branch protection rules · List branch protections for a repository #

Ask an LLM

“Which branch protection rules are set up on a repository?”

“What branches are protected in this repo?”

Tell an agent

List the branch protections for {owner}/{repo}.

Show every branch protection rule in {owner}/{repo}.

POST /repos/{owner}/{repo}/branch_protections Create a branch protection rule · Create a branch protections for a repository #

Ask an LLM

“How do I protect the main branch so nobody can force-push to it?”

“Can a protection rule require a number of approvals and passing status checks before merging?”

Tell an agent

Protect branch {branch_name} in {owner}/{repo}.

Create protection rule {rule_name} in {owner}/{repo} requiring {required_approvals} approvals.

POST /repos/{owner}/{repo}/branch_protections/priority Reorder branch protection priorities · Update the priorities of branch protections for a repository #

Ask an LLM

“When several protection rules match a branch, how do I set which one wins?”

“Can I change the order of a repo's branch protection rules?”

Tell an agent

Reorder the branch protection rules of {owner}/{repo} to {ids}.

Set branch protection priority in {owner}/{repo} to the order {ids}.

GET /repos/{owner}/{repo}/branch_protections/{name} Get a branch protection rule · Get a specific branch protection for the repository #

Ask an LLM

“What exactly does a specific branch protection rule enforce?”

“How many approvals does a given protection rule require?”

Tell an agent

Show the branch protection rule {name} in {owner}/{repo}.

Get the settings of protection rule {name} for {owner}/{repo}.

DELETE /repos/{owner}/{repo}/branch_protections/{name} Delete a branch protection rule · Delete a specific branch protection for the repository #

Ask an LLM

“How do I remove protection from a branch?”

“Can I delete a single branch protection rule?”

Tell an agent destructive · confirm first

Delete the branch protection rule {name} in {owner}/{repo}.

Remove protection rule {name} from {owner}/{repo}.

PATCH /repos/{owner}/{repo}/branch_protections/{name} Edit a branch protection rule · Edit a branch protections for a repository. #

Ask an LLM

“Can I change the required approvals on an existing protection rule?”

“How do I add users to the push allowlist of a protected branch that's already set up?”

Tell an agent

Change protection rule {name} in {owner}/{repo} to require {required_approvals} approvals.

Allow {push_whitelist_usernames} to push to protected rule {name} in {owner}/{repo}.

GET /repos/{owner}/{repo}/branches List a repository's branches · List a repository's branches #

Ask an LLM

“What branches exist in a repository?”

“Can I page through all branches of a large repo?”

Tell an agent

List the branches in {owner}/{repo}.

Show {limit} branches per page for {owner}/{repo}.

POST /repos/{owner}/{repo}/branches Create a branch · Create a branch #

Ask an LLM

“How do I create a new branch from an existing one?”

“Can I start a branch from a specific tag or commit instead of a branch?”

Tell an agent

Create branch {new_branch_name} in {owner}/{repo}.

Create branch {new_branch_name} in {owner}/{repo} from {old_branch_name}.

GET /repos/{owner}/{repo}/branches/{branch} Get a branch · Retrieve a specific branch from a repository, including its effective branch… #

Ask an LLM

“Which commit is a branch currently pointing at?”

“Is a particular branch protected, and by what rule?”

Tell an agent

Show branch {branch} in {owner}/{repo}.

Get the latest commit and effective protection of {branch} in {owner}/{repo}.

PUT /repos/{owner}/{repo}/branches/{branch} Point a branch at a different commit · Update a branch reference to a new commit #

Ask an LLM

“Can I move a branch to point at a different commit?”

“Is a force update allowed when resetting a branch to a commit that isn't a descendant?”

Tell an agent

Move branch {branch} in {owner}/{repo} to commit {new_commit_id}.

Force-reset {branch} in {owner}/{repo} to {new_commit_id}, setting force to {force}.

DELETE /repos/{owner}/{repo}/branches/{branch} Delete a branch · Delete a specific branch from a repository #

Ask an LLM

“How do I delete a branch after its work is merged?”

“Can I remove a stale branch from a repository?”

Tell an agent destructive · confirm first

Delete branch {branch} from {owner}/{repo}.

Remove the stale branch {branch} in {owner}/{repo}.

PATCH /repos/{owner}/{repo}/branches/{branch} Rename a branch · Rename a branch #

Ask an LLM

“Can I rename a branch, say from master to main?”

“What happens to a branch's name when I rename it through the API?”

Tell an agent

Rename branch {branch} in {owner}/{repo} to {name}.

Change the name of {branch} in {owner}/{repo} to {name}.

GET /repos/{owner}/{repo}/collaborators List a repository's collaborators · List a repository's collaborators #

Ask an LLM

“Who has been added as a collaborator on a repository?”

“Can I page through a repo's collaborator list?”

Tell an agent

List the collaborators on {owner}/{repo}.

Show everyone added as a collaborator to {owner}/{repo}.

GET /repos/{owner}/{repo}/collaborators/{collaborator} Check if a user is a collaborator · Check if a user is a collaborator of a repository #

Ask an LLM

“Is a particular user a collaborator on this repository?”

“Can I verify someone's collaborator status on a repo?”

Tell an agent

Check whether {collaborator} is a collaborator on {owner}/{repo}.

Confirm {collaborator} has collaborator access to {owner}/{repo}.

PUT /repos/{owner}/{repo}/collaborators/{collaborator} Add or update a collaborator · Add or Update a collaborator to a repository #

Ask an LLM

“How do I give another user access to my repository?”

“Can I change a collaborator's permission level to read, write or admin?”

Tell an agent

Add {collaborator} as a collaborator on {owner}/{repo}.

Give {collaborator} {permission} permission on {owner}/{repo}.

DELETE /repos/{owner}/{repo}/collaborators/{collaborator} Remove a collaborator · Delete a collaborator from a repository #

Ask an LLM

“How do I revoke someone's collaborator access to a repo?”

“Can I remove a user from a repository's collaborators?”

Tell an agent destructive · confirm first

Remove {collaborator} as a collaborator from {owner}/{repo}.

Revoke collaborator access for {collaborator} on {owner}/{repo}.

GET /repos/{owner}/{repo}/collaborators/{collaborator}/permission Get a user's permission on a repository · Get repository permissions for a user #

Ask an LLM

“What permission level does a given user have on a repository?”

“Does this user have admin, write or only read rights on the repo?”

Tell an agent

Get the repository permission of {collaborator} on {owner}/{repo}.

Tell me what access level {collaborator} has in {owner}/{repo}.

GET /repos/{owner}/{repo}/commits List commits in a repository · Get a list of all commits from a repository #

Ask an LLM

“How can I see the commit history of a repository or a single file?”

“Can I list commits between two dates or starting from a specific branch?”

Tell an agent

List the commits in {owner}/{repo}.

Show commits on {sha} in {owner}/{repo} that touched {path}.

GET /repos/{owner}/{repo}/commits/{ref}/status Get a ref's combined commit status · Get a commit's combined status, by branch/tag/commit reference #

Ask an LLM

“Did all CI checks pass on a branch or tag overall?”

“What's the single combined status of the latest commit on a ref?”

Tell an agent

Get the combined status of {ref} in {owner}/{repo}.

Tell me whether all checks passed overall for {ref} in {owner}/{repo}.

GET /repos/{owner}/{repo}/commits/{ref}/statuses List commit statuses for a branch or tag · Get a commit's statuses, by branch/tag/commit reference #

Ask an LLM

“Which individual CI statuses were reported on the tip of a branch or tag?”

“Can I filter the statuses on a ref by state, like only failures?”

Tell an agent

List every status reported on branch or tag {ref} in {owner}/{repo}.

Show {state} statuses for ref {ref} in {owner}/{repo}.

GET /repos/{owner}/{repo}/commits/{sha}/pull Find the pull request that merged a commit · Get the merged pull request of the commit #

Ask an LLM

“Which pull request brought a given commit into the repository?”

“Can I trace a commit SHA back to its merged PR?”

Tell an agent

Find the merged pull request for commit {sha} in {owner}/{repo}.

Show which PR merged {sha} into {owner}/{repo}.

GET /repos/{owner}/{repo}/compare/{basehead} Compare two branches or commits · Get commit comparison information #

Ask an LLM

“How do I compare two branches to see which commits differ?”

“What changed between two tags or commits in a repo?”

Tell an agent

Compare {basehead} in {owner}/{repo}.

Show the commit differences for {basehead} in {owner}/{repo}.

GET /repos/{owner}/{repo}/contents List the root directory's entries · Gets the metadata of all the entries of the root dir #

Ask an LLM

“What files and folders are at the top level of a repository?”

“Can I list the root directory entries at a particular branch or tag?”

Tell an agent

List the root directory entries of {owner}/{repo}.

Show the top-level files of {owner}/{repo} at ref {ref}.

POST /repos/{owner}/{repo}/contents Change multiple files in one commit · Modify multiple files in a repository #

Ask an LLM

“Can I create, update and delete several files in a single commit?”

“How do I commit a batch of file changes to a new branch?”

Tell an agent

Commit the file changes {files} to {owner}/{repo} with message {message}.

Apply {files} to {owner}/{repo} on new branch {new_branch} in one commit.

GET /repos/{owner}/{repo}/contents-ext/{filepath} Get file metadata or list a directory (extended) · The extended "contents" API, to get file metadata and/or content, or list a… #

Ask an LLM

“What's the recommended way to fetch a file's metadata or list a directory in one call?”

“Can the extended contents call include file content or LFS metadata on request?”

Tell an agent

Get extended contents for {filepath} in {owner}/{repo}.

Fetch {filepath} in {owner}/{repo} at {ref} including {includes}.

GET /repos/{owner}/{repo}/contents/{filepath} Get a file or directory's contents · Gets the metadata and contents (if a file) of an entry in a repository, or a… #

Ask an LLM

“How do I read a file's content and metadata, or list a subfolder, in a repo?”

“Can I get the contents of a path as of an older branch or commit?”

Tell an agent

Get the contents of {filepath} in {owner}/{repo}.

Show {filepath} from {owner}/{repo} as it was at ref {ref}.

PUT /repos/{owner}/{repo}/contents/{filepath} Update or create a single file · Update a file in a repository if SHA is set, or create the file if SHA is not… #

Ask an LLM

“How do I edit an existing file in a repository and commit the change?”

“Can I move a file to a new path while updating it?”

Tell an agent

Update {filepath} in {owner}/{repo} with {content} using blob sha {sha}.

Overwrite {filepath} in {owner}/{repo} with {content} and message {message}.

POST /repos/{owner}/{repo}/contents/{filepath} Create a new file · Create a file in a repository #

Ask an LLM

“How do I add a new file to a repository through the API?”

“Can I create a file on a new branch rather than the default one?”

Tell an agent

Create file {filepath} in {owner}/{repo} with content {content}.

Add new file {filepath} to {owner}/{repo} on branch {branch} with {content}.

DELETE /repos/{owner}/{repo}/contents/{filepath} Delete a file · Delete a file in a repository #

Ask an LLM

“How do I delete a single file from a repository in a commit?”

“What do I need to supply to delete a file, such as its current SHA?”

Tell an agent destructive · confirm first

Delete {filepath} from {owner}/{repo} with blob sha {sha}.

Remove file {filepath} in {owner}/{repo}, sha {sha}, message {message}.

POST /repos/{owner}/{repo}/diffpatch Apply a diff patch · Apply diff patch to repository #

Ask an LLM

“Can I apply a unified diff or patch directly to a repository?”

“How do I commit changes from a patch file onto a branch?”

Tell an agent

Apply the patch {content} to {owner}/{repo}.

Apply diff {content} to branch {branch} of {owner}/{repo} with message {message}.

GET /repos/{owner}/{repo}/editorconfig/{filepath} Get a file's EditorConfig settings · Get the EditorConfig definitions of a file in a repository #

Ask an LLM

“What EditorConfig rules apply to a given file, like indentation and line endings?”

“Can I resolve the .editorconfig definitions for one path at a specific ref?”

Tell an agent

Get the EditorConfig definitions for {filepath} in {owner}/{repo}.

Show the editor settings that apply to {filepath} in {owner}/{repo} at {ref}.

GET /repos/{owner}/{repo}/file-contents Get several files by query string · Get the metadata and contents of requested files #

Ask an LLM

“Can I fetch multiple files at once with a GET request by passing the file list in the query?”

“How do I batch-read files when I can only send GET requests?”

Tell an agent

Fetch the files listed in {body} from {owner}/{repo} using the GET variant.

Batch-read files {body} from {owner}/{repo} at {ref} via query string.

POST /repos/{owner}/{repo}/file-contents Get several files' contents in one request · Get the metadata and contents of requested files #

Ask an LLM

“How do I retrieve the content of many files in one request?”

“What happens to files that are too large in a batch file read?”

Tell an agent

Read the files {files} from {owner}/{repo} in one POST request.

Batch-fetch contents of {files} in {owner}/{repo} at ref {ref}.

GET /repos/{owner}/{repo}/forks List a repository's forks · List a repository's forks #

Ask an LLM

“Who has forked a repository?”

“Can I page through all forks of a popular repo?”

Tell an agent

List the forks of {owner}/{repo}.

Show every fork created from {owner}/{repo}.

POST /repos/{owner}/{repo}/forks Fork a repository · Fork a repository #

Ask an LLM

“How do I fork a repository into my account or an organization?”

“Can I give my fork a different name?”

Tell an agent

Fork {owner}/{repo}.

Fork {owner}/{repo} into organization {organization} as {name}.

GET /repos/{owner}/{repo}/git/blobs/{sha} Get a git blob · Gets the blob of a repository #

Ask an LLM

“How do I fetch a raw git blob object by its SHA?”

“Can I get the base64 content of a blob without knowing its file path?”

Tell an agent

Get blob {sha} from {owner}/{repo}.

Fetch the git blob object {sha} in {owner}/{repo}.

GET /repos/{owner}/{repo}/git/commits/{sha} Get a single commit · Get a single commit from a repository #

Ask an LLM

“How do I look up one commit's author, message and changed files?”

“Can I skip stats or verification info when fetching a commit to make it faster?”

Tell an agent

Show commit {sha} in {owner}/{repo}.

Get commit {sha} in {owner}/{repo} with the changed files list.

GET /repos/{owner}/{repo}/git/commits/{sha}.{diffType} Download a commit's diff or patch · Get a commit's diff or patch #

Ask an LLM

“Can I download the raw diff or patch file for one commit?”

“What format options exist for exporting a commit's changes?”

Tell an agent

Download the {diffType} for commit {sha} in {owner}/{repo}.

Get commit {sha} of {owner}/{repo} as a {diffType} file.

GET /repos/{owner}/{repo}/git/notes/{sha} Get a commit's git note · Get a note corresponding to a single commit from a repository #

Ask an LLM

“Is there a git note attached to a particular commit?”

“How can I read the notes stored against a commit?”

Tell an agent

Get the git note for commit {sha} in {owner}/{repo}.

Show the note attached to {sha} in {owner}/{repo}.

GET /repos/{owner}/{repo}/git/refs List all git refs · Get specified ref or filtered repository's refs #

Ask an LLM

“What are all the raw git refs in a repository, including heads and tags?”

“Can I dump every reference a repo has?”

Tell an agent

List all git refs in {owner}/{repo}.

Show every head and tag reference in {owner}/{repo}.

GET /repos/{owner}/{repo}/git/refs/{ref} Get git refs matching a prefix · Get specified ref or filtered repository's refs #

Ask an LLM

“Can I get only the refs matching a given prefix, like heads/feature?”

“What SHA does one specific git ref resolve to?”

Tell an agent

Get the git refs matching {ref} in {owner}/{repo}.

Resolve reference {ref} in {owner}/{repo} to its SHA.

GET /repos/{owner}/{repo}/git/tags/{sha} Get an annotated tag object · Gets the tag object of an annotated tag (not lightweight tags) #

Ask an LLM

“How do I read an annotated tag's message and tagger?”

“Does fetching a tag object work for lightweight tags too?”

Tell an agent

Get the annotated tag object {sha} in {owner}/{repo}.

Show the tagger and message of annotated tag {sha} in {owner}/{repo}.

GET /repos/{owner}/{repo}/git/trees/{sha} Get a git tree · Gets the tree of a repository #

Ask an LLM

“How do I list a git tree, optionally recursively, for a commit or tree SHA?”

“Can I page through a very large tree?”

Tell an agent

Get tree {sha} of {owner}/{repo}.

Recursively list tree {sha} in {owner}/{repo} with recursive set to {recursive}.

GET /repos/{owner}/{repo}/hooks List a repository's webhooks · List the hooks in a repository #

Ask an LLM

“Which webhooks are configured on a repository?”

“Can I see where a repo sends its webhook events?”

Tell an agent

List the webhooks on {owner}/{repo}.

Show all web hooks configured for {owner}/{repo}.

POST /repos/{owner}/{repo}/hooks Create a webhook · Create a hook #

Ask an LLM

“How do I set up a webhook so a repo notifies my service on push?”

“Which events can a repository webhook subscribe to, and can I filter by branch?”

Tell an agent

Create a {type} webhook on {owner}/{repo} with config {config}.

Add a {type} webhook to {owner}/{repo} for events {events} with config {config}.

GET /repos/{owner}/{repo}/hooks/git List server-side git hooks · List the Git hooks in a repository #

Ask an LLM

“Which server-side git hooks, like pre-receive, are available on a repository?”

“Can I see the git hooks configured for a repo?”

Tell an agent

List the git hooks in {owner}/{repo}.

Show the server-side git hooks for {owner}/{repo}.

GET /repos/{owner}/{repo}/hooks/git/{id} Get a server-side git hook · Get a Git hook #

Ask an LLM

“How do I view the script of one git hook, like post-receive?”

“Is a specific git hook active on this repository?”

Tell an agent

Show git hook {id} in {owner}/{repo}.

Get the script content of git hook {id} for {owner}/{repo}.

DELETE /repos/{owner}/{repo}/hooks/git/{id} Delete a server-side git hook · Delete a Git hook in a repository #

Ask an LLM

“How do I remove a server-side git hook script?”

“Can I clear a pre-receive hook from a repo?”

Tell an agent destructive · confirm first

Delete git hook {id} from {owner}/{repo}.

Clear the server-side git hook {id} in {owner}/{repo}.

PATCH /repos/{owner}/{repo}/hooks/git/{id} Edit a server-side git hook · Edit a Git hook in a repository #

Ask an LLM

“Can I change the script that runs in a repository's git hook?”

“How do I write a new update hook script?”

Tell an agent

Set the script of git hook {id} in {owner}/{repo} to {content}.

Replace git hook {id} in {owner}/{repo} with {content}.

GET /repos/{owner}/{repo}/hooks/{id} Get a webhook · Get a hook #

Ask an LLM

“How can I see one webhook's URL, events and active state?”

“What does a specific repository webhook subscribe to?”

Tell an agent

Show webhook {id} in {owner}/{repo}.

Get the configuration of web hook {id} for {owner}/{repo}.

DELETE /repos/{owner}/{repo}/hooks/{id} Delete a webhook · Delete a hook in a repository #

Ask an LLM

“How do I remove a webhook from a repository?”

“Can I stop a repo from sending events to an endpoint permanently?”

Tell an agent destructive · confirm first

Delete webhook {id} from {owner}/{repo}.

Remove the web hook {id} in {owner}/{repo}.

PATCH /repos/{owner}/{repo}/hooks/{id} Edit a webhook · Edit a hook in a repository #

Ask an LLM

“Can I deactivate a webhook without deleting it?”

“How do I change which events or branches an existing webhook fires on?”

Tell an agent

Update webhook {id} in {owner}/{repo} to fire on {events}.

Set webhook {id} in {owner}/{repo} active to {active}.

POST /repos/{owner}/{repo}/hooks/{id}/tests Send a test push to a webhook · Test a push webhook #

Ask an LLM

“How do I test that a webhook endpoint receives push events correctly?”

“Can I fire a test delivery for a specific ref?”

Tell an agent

Send a test push delivery to webhook {id} in {owner}/{repo}.

Test webhook {id} of {owner}/{repo} using ref {ref}.

GET /repos/{owner}/{repo}/issue_config Get a repository's issue config · Returns the issue config for a repo #

Ask an LLM

“What issue form configuration, such as contact links or blank issues, does a repo use?”

“Are blank issues allowed in this repository?”

Tell an agent

Get the issue config of {owner}/{repo}.

Show whether {owner}/{repo} allows blank issues.

GET /repos/{owner}/{repo}/issue_config/validate Validate a repository's issue config · Returns the validation information for a issue config #

Ask an LLM

“Is my repo's issue config file valid?”

“What errors are in the issue template configuration?”

Tell an agent

Validate the issue config for {owner}/{repo}.

Check {owner}/{repo} for issue config errors.

GET /repos/{owner}/{repo}/issue_templates List available issue templates · Get available issue templates for a repository #

Ask an LLM

“Which issue templates can people choose from when opening an issue?”

“Does this repository have any issue templates defined?”

Tell an agent

List the issue templates of {owner}/{repo}.

Show the available templates for new issues in {owner}/{repo}.

GET /repos/{owner}/{repo}/issues/pinned List pinned issues · List a repo's pinned issues #

Ask an LLM

“Which issues are pinned at the top of a repository?”

“Can I see a repo's pinned issues?”

Tell an agent

List the pinned issues in {owner}/{repo}.

Show issues pinned in {owner}/{repo}.

GET /repos/{owner}/{repo}/keys List a repository's deploy keys · List a repository's keys #

Ask an LLM

“Which deploy keys have access to a repository?”

“Can I find a deploy key by its fingerprint?”

Tell an agent

List the deploy keys on {owner}/{repo}.

Find the deploy key with fingerprint {fingerprint} in {owner}/{repo}.

POST /repos/{owner}/{repo}/keys Add a deploy key · Add a key to a repository #

Ask an LLM

“How do I add an SSH deploy key so a server can pull a repo?”

“Can a deploy key be restricted to read-only access?”

Tell an agent

Add deploy key {title} with public key {key} to {owner}/{repo}.

Add read-only deploy key {title} ({key}) to {owner}/{repo}, read_only {read_only}.

GET /repos/{owner}/{repo}/keys/{id} Get a deploy key · Get a repository's key by id #

Ask an LLM

“How can I see one deploy key's title, fingerprint and access?”

“Is a given deploy key read-only?”

Tell an agent

Show deploy key {id} in {owner}/{repo}.

Get details of deploy key {id} on {owner}/{repo}.

DELETE /repos/{owner}/{repo}/keys/{id} Remove a deploy key · Delete a key from a repository #

Ask an LLM

“How do I revoke a deploy key from a repository?”

“Can I delete an SSH key that no longer should access the repo?”

Tell an agent destructive · confirm first

Delete deploy key {id} from {owner}/{repo}.

Revoke deploy key {id} on {owner}/{repo}.

GET /repos/{owner}/{repo}/languages Get a repository's language breakdown · Get languages and number of bytes of code written #

Ask an LLM

“Which programming languages is a repository written in?”

“How many bytes of each language are in the codebase?”

Tell an agent

Show the language breakdown of {owner}/{repo}.

Get bytes of code per language for {owner}/{repo}.

GET /repos/{owner}/{repo}/licenses Get a repository's licenses · Get repo licenses #

Ask an LLM

“What license is a repository published under?”

“Can I detect every license file in a repo?”

Tell an agent

Get the licenses of {owner}/{repo}.

Show which licenses {owner}/{repo} is released under.

GET /repos/{owner}/{repo}/media/{filepath} Download a file, resolving LFS objects · Get a file or it's LFS object from a repository #

Ask an LLM

“How do I download a file stored in Git LFS rather than its pointer?”

“Can I get the real binary of a large file tracked with LFS?”

Tell an agent

Download {filepath} from {owner}/{repo}, resolving the LFS object.

Get the LFS media for {filepath} in {owner}/{repo} at {ref}.

POST /repos/{owner}/{repo}/merge-upstream Sync a fork with its upstream · Merge a branch from upstream #

Ask an LLM

“How do I pull the latest upstream changes into my fork's branch?”

“Can I require a fast-forward only when syncing a fork?”

Tell an agent

Merge upstream changes into {owner}/{repo}.

Sync branch {branch} of fork {owner}/{repo} from upstream, fast-forward only {ff_only}.

POST /repos/{owner}/{repo}/mirror-sync Sync a pull mirror now · Sync a mirrored repository #

Ask an LLM

“Can I force a mirrored repository to pull from its source right now?”

“How do I refresh a pull mirror without waiting for the interval?”

Tell an agent

Sync the mirror {owner}/{repo} now.

Trigger a pull mirror update for {owner}/{repo}.

GET /repos/{owner}/{repo}/new_pin_allowed Check if more issues can be pinned · Returns if new Issue Pins are allowed #

Ask an LLM

“Can I pin another issue or pull request in this repo, or is the limit reached?”

“Is there room for a new pinned issue?”

Tell an agent

Check whether new pins are allowed in {owner}/{repo}.

Tell me if {owner}/{repo} can take another pinned issue.

GET /repos/{owner}/{repo}/pulls List a repository's pull requests · List a repo's pull requests #

Ask an LLM

“How do I list the open pull requests in a repository?”

“Can I filter pull requests by base branch, label, milestone or author?”

Tell an agent

List open pull requests in {owner}/{repo}.

Show pull requests in {owner}/{repo} with state {state} targeting {base_branch}.

POST /repos/{owner}/{repo}/pulls Open a pull request · Create a pull request #

Ask an LLM

“How do I open a pull request from one branch into another?”

“Can I set reviewers, labels and a milestone when I create a PR?”

Tell an agent

Open a pull request in {owner}/{repo} from {head} into {base} titled {title}.

Create a PR in {owner}/{repo} from {head} to {base} titled {title} and request {reviewers}.

POST /repos/{owner}/{repo}/pulls/comments/{id}/resolve Resolve a review comment · Resolve a pull request review comment #

Ask an LLM

“How do I mark a pull request review comment as resolved?”

“Can I resolve a code review conversation once it's addressed?”

Tell an agent

Resolve review comment {id} in {owner}/{repo}.

Mark PR review comment {id} in {owner}/{repo} as resolved.

POST /repos/{owner}/{repo}/pulls/comments/{id}/unresolve Unresolve a review comment · Unresolve a pull request review comment #

Ask an LLM

“Can I reopen a review comment thread that was marked resolved?”

“How do I unresolve a pull request conversation?”

Tell an agent

Unresolve review comment {id} in {owner}/{repo}.

Reopen the resolved PR review comment {id} in {owner}/{repo}.

GET /repos/{owner}/{repo}/pulls/pinned List pinned pull requests · List a repo's pinned pull requests #

Ask an LLM

“Which pull requests are pinned in a repository?”

“Can I see only the PRs pinned to the top?”

Tell an agent

List the pinned pull requests in {owner}/{repo}.

Show PRs pinned in {owner}/{repo}.

GET /repos/{owner}/{repo}/pulls/{base}/{head} Find a pull request by base and head · Get a pull request by base and head #

Ask an LLM

“Is there already a pull request from a given branch into another?”

“How do I look up a PR when I know only its base and head branches?”

Tell an agent

Find the pull request from {head} into {base} in {owner}/{repo}.

Get the PR with base {base} and head {head} in {owner}/{repo}.

GET /repos/{owner}/{repo}/pulls/{index} Get a pull request · Get a pull request #

Ask an LLM

“How can I see the status, branches and mergeability of one pull request?”

“Is a given PR still open or already merged?”

Tell an agent

Show pull request #{index} in {owner}/{repo}.

Get details of PR {index} in {owner}/{repo}.

PATCH /repos/{owner}/{repo}/pulls/{index} Update a pull request · Update a pull request. #

Ask an LLM

“Can I change a pull request's title, description or target branch after opening it?”

“How do I close a PR without merging it?”

Tell an agent

Change the title of PR {index} in {owner}/{repo} to {title}.

Close pull request {index} in {owner}/{repo} by setting state to {state}.

GET /repos/{owner}/{repo}/pulls/{index}.{diffType} Download a pull request's diff or patch · Get a pull request diff or patch #

Ask an LLM

“Can I download a pull request as a raw diff or patch file?”

“Does a PR diff download include binary changes?”

Tell an agent

Download PR {index} of {owner}/{repo} as a {diffType}.

Get the {diffType} for pull request {index} in {owner}/{repo} including binary {binary}.

GET /repos/{owner}/{repo}/pulls/{index}/commits List a pull request's commits · Get commits for a pull request #

Ask an LLM

“Which commits are included in a pull request?”

“Can I see the commits of a PR with their changed files?”

Tell an agent

List the commits in PR {index} of {owner}/{repo}.

Show commits on pull request {index} in {owner}/{repo}.

GET /repos/{owner}/{repo}/pulls/{index}/files List files changed in a pull request · Get changed files for a pull request #

Ask an LLM

“What files does a pull request change?”

“Can I ignore whitespace-only changes when listing a PR's files?”

Tell an agent

List the changed files in PR {index} of {owner}/{repo}.

Show files changed by pull request {index} in {owner}/{repo} with whitespace mode {whitespace}.

GET /repos/{owner}/{repo}/pulls/{index}/merge Check if a pull request is merged · Check if a pull request has been merged #

Ask an LLM

“Has a particular pull request been merged yet?”

“Can I quickly confirm a PR's merge status?”

Tell an agent

Check whether PR {index} in {owner}/{repo} has been merged.

Confirm the merge status of pull request {index} in {owner}/{repo}.

POST /repos/{owner}/{repo}/pulls/{index}/merge Merge a pull request · Merge a pull request #

Ask an LLM

“How do I merge a pull request with squash or rebase instead of a merge commit?”

“Can I schedule a PR to merge automatically once checks succeed?”

Tell an agent

Merge pull request {index} in {owner}/{repo} using {do}.

Squash-merge PR {index} in {owner}/{repo} with style {do} and title {merge_title_field}.

DELETE /repos/{owner}/{repo}/pulls/{index}/merge Cancel a scheduled auto-merge · Cancel the scheduled auto merge for the given pull request #

Ask an LLM

“How do I stop a pull request from auto-merging when checks pass?”

“Can I cancel an auto-merge I scheduled earlier?”

Tell an agent destructive · confirm first

Cancel the scheduled auto-merge for PR {index} in {owner}/{repo}.

Stop pull request {index} in {owner}/{repo} from merging automatically.

POST /repos/{owner}/{repo}/pulls/{index}/requested_reviewers Request reviewers on a pull request · create review requests for a pull request #

Ask an LLM

“How do I ask specific people or teams to review a pull request?”

“Can I request a team review on a PR that's already open?”

Tell an agent

Request reviews from {reviewers} on PR {index} in {owner}/{repo}.

Ask team {team_reviewers} to review pull request {index} in {owner}/{repo}.

DELETE /repos/{owner}/{repo}/pulls/{index}/requested_reviewers Cancel review requests on a pull request · cancel review requests for a pull request #

Ask an LLM

“Can I withdraw a review request I sent to someone on a PR?”

“How do I remove a team from a pull request's requested reviewers?”

Tell an agent destructive · confirm first

Cancel the review request for {reviewers} on PR {index} in {owner}/{repo}.

Remove team {team_reviewers} from requested reviewers on PR {index} in {owner}/{repo}.

GET /repos/{owner}/{repo}/pulls/{index}/reviews List a pull request's reviews · List all reviews for a pull request #

Ask an LLM

“Who has reviewed a pull request and did they approve or request changes?”

“Can I list every review submitted on a PR?”

Tell an agent

List the reviews on PR {index} in {owner}/{repo}.

Show all approvals and change requests for pull request {index} in {owner}/{repo}.

POST /repos/{owner}/{repo}/pulls/{index}/reviews Create a pull request review · Create a review to a pull request #

Ask an LLM

“How do I leave a review with inline code comments on a pull request?”

“Can I approve or request changes when creating a review?”

Tell an agent

Create a review on PR {index} in {owner}/{repo} with event {event} and body {body}.

Review PR {index} in {owner}/{repo} with inline comments {comments}.

GET /repos/{owner}/{repo}/pulls/{index}/reviews/{id} Get a pull request review · Get a specific review for a pull request #

Ask an LLM

“How can I read the state and summary of one specific review on a PR?”

“Was a particular review an approval?”

Tell an agent

Show review {id} on PR {index} in {owner}/{repo}.

Get the state of review {id} for pull request {index} in {owner}/{repo}.

POST /repos/{owner}/{repo}/pulls/{index}/reviews/{id} Submit a pending review · Submit a pending review to a pull request #

Ask an LLM

“I started a pending review; how do I submit it?”

“Can I choose approve or request changes when submitting a draft review?”

Tell an agent

Submit pending review {id} on PR {index} in {owner}/{repo} as {event}.

Finish draft review {id} on pull request {index} in {owner}/{repo} with {event} and {body}.

DELETE /repos/{owner}/{repo}/pulls/{index}/reviews/{id} Delete a pull request review · Delete a specific review from a pull request #

Ask an LLM

“Can I delete a review I left on a pull request?”

“How do I remove a pending review?”

Tell an agent destructive · confirm first

Delete review {id} from PR {index} in {owner}/{repo}.

Remove pull request review {id} on PR {index} of {owner}/{repo}.

GET /repos/{owner}/{repo}/pulls/{index}/reviews/{id}/comments List a review's inline comments · Get a specific review for a pull request #

Ask an LLM

“What inline code comments were left as part of one review?”

“Can I read every line comment from a specific PR review?”

Tell an agent

List the comments in review {id} on PR {index} of {owner}/{repo}.

Show inline code comments from review {id} of pull request {index} in {owner}/{repo}.

POST /repos/{owner}/{repo}/pulls/{index}/reviews/{id}/dismissals Dismiss a pull request review · Dismiss a review for a pull request #

Ask an LLM

“How do I dismiss a stale or blocking review on a PR?”

“Can I leave a message explaining why a review was dismissed?”

Tell an agent

Dismiss review {id} on PR {index} in {owner}/{repo}.

Dismiss review {id} on pull request {index} of {owner}/{repo} with message {message}.

POST /repos/{owner}/{repo}/pulls/{index}/reviews/{id}/undismissals Undo a review dismissal · Cancel to dismiss a review for a pull request #

Ask an LLM

“Can I restore a review that was dismissed by mistake?”

“How do I cancel a dismissal on a PR review?”

Tell an agent

Undismiss review {id} on PR {index} in {owner}/{repo}.

Restore dismissed review {id} on pull request {index} of {owner}/{repo}.

POST /repos/{owner}/{repo}/pulls/{index}/update Update a PR branch from its base · Merge PR's baseBranch into headBranch #

Ask an LLM

“How do I bring a pull request's branch up to date with the base branch?”

“Can I rebase the head branch instead of merging the base into it?”

Tell an agent

Update the branch of PR {index} in {owner}/{repo} with its base.

Bring PR {index} in {owner}/{repo} up to date using style {style}.

GET /repos/{owner}/{repo}/push_mirrors List push mirrors · Get all push mirrors of the repository #

Ask an LLM

“Which remote push mirrors is a repository replicating to?”

“Can I see all push mirror destinations for a repo?”

Tell an agent

List the push mirrors of {owner}/{repo}.

Show every remote {owner}/{repo} push-mirrors to.

POST /repos/{owner}/{repo}/push_mirrors Add a push mirror · add a push mirror to the repository #

Ask an LLM

“How do I make a repository automatically push to another remote?”

“Can a push mirror sync on every commit or on an interval?”

Tell an agent

Add a push mirror from {owner}/{repo} to {remote_address}.

Push-mirror {owner}/{repo} to {remote_address} every {interval}, sync on commit {sync_on_commit}.

POST /repos/{owner}/{repo}/push_mirrors-sync Sync all push mirrors now · Sync all push mirrored repository #

Ask an LLM

“Can I push a repo to all of its mirrors immediately?”

“How do I trigger every push mirror to sync right away?”

Tell an agent

Sync all push mirrors of {owner}/{repo} now.

Push {owner}/{repo} to every configured push mirror.

GET /repos/{owner}/{repo}/push_mirrors/{name} Get a push mirror by remote name · Get push mirror of the repository by remoteName #

Ask an LLM

“How do I check the status of one push mirror, like its last update or error?”

“Where does a given push mirror remote point?”

Tell an agent

Show push mirror {name} of {owner}/{repo}.

Get last sync status of the push mirror remote {name} in {owner}/{repo}.

DELETE /repos/{owner}/{repo}/push_mirrors/{name} Remove a push mirror · deletes a push mirror from a repository by remoteName #

Ask an LLM

“How do I stop a repository from pushing to a mirror?”

“Can I delete a push mirror by its remote name?”

Tell an agent destructive · confirm first

Delete push mirror {name} from {owner}/{repo}.

Remove the push mirror remote {name} in {owner}/{repo}.

GET /repos/{owner}/{repo}/raw/{filepath} Download a raw file · Get a file from a repository #

Ask an LLM

“How do I get the raw bytes of a file in a repository?”

“Can I download a raw file from a given branch, tag or commit?”

Tell an agent

Download the raw file {filepath} from {owner}/{repo}.

Get raw {filepath} in {owner}/{repo} at ref {ref}.

GET /repos/{owner}/{repo}/releases List a repository's releases · List a repo's releases #

Ask an LLM

“What releases has a project published?”

“Can I exclude drafts or pre-releases when listing releases?”

Tell an agent

List the releases of {owner}/{repo}.

Show releases in {owner}/{repo} with pre-release set to {pre-release}.

POST /repos/{owner}/{repo}/releases Create a release · Create a release #

Ask an LLM

“How do I publish a new release for a tag?”

“Can I create a release as a draft or mark it as a pre-release?”

Tell an agent

Create release {tag_name} in {owner}/{repo}.

Create draft release {name} for tag {tag_name} in {owner}/{repo} with notes {body}.

GET /repos/{owner}/{repo}/releases/latest Get the latest release · Gets the most recent non-prerelease, non-draft release of a repository, sorted… #

Ask an LLM

“What's the most recent stable release of a project?”

“Does the latest-release lookup skip drafts and pre-releases?”

Tell an agent

Get the latest release of {owner}/{repo}.

Show the newest stable release published by {owner}/{repo}.

GET /repos/{owner}/{repo}/releases/tags/{tag} Get a release by tag name · Get a release by tag name #

Ask an LLM

“How do I find the release associated with a specific version tag?”

“Can I look up release notes using the tag, like v1.2.0?”

Tell an agent

Get the release for tag {tag} in {owner}/{repo}.

Show release notes for tag {tag} of {owner}/{repo}.

DELETE /repos/{owner}/{repo}/releases/tags/{tag} Delete a release by tag name · Delete a release by tag name #

Ask an LLM

“Can I delete a release by its tag name instead of its numeric id?”

“How do I remove the release for a given version tag?”

Tell an agent destructive · confirm first

Delete the release tagged {tag} in {owner}/{repo}.

Remove the release for tag {tag} from {owner}/{repo}, looked up by tag name.

GET /repos/{owner}/{repo}/releases/{id} Get a release by id · Get a release #

Ask an LLM

“How do I fetch a release's details when I have its numeric id?”

“What assets and notes does a particular release id have?”

Tell an agent

Get release {id} in {owner}/{repo}.

Show details of release id {id} for {owner}/{repo}.

DELETE /repos/{owner}/{repo}/releases/{id} Delete a release by id · Delete a release #

Ask an LLM

“How do I delete a release using its numeric id?”

“Does deleting a release by id also remove its tag?”

Tell an agent destructive · confirm first

Delete release {id} from {owner}/{repo}.

Remove release id {id} in {owner}/{repo}.

PATCH /repos/{owner}/{repo}/releases/{id} Update a release · Update a release #

Ask an LLM

“Can I edit a release's notes or title after publishing it?”

“How do I turn a draft release into a published one?”

Tell an agent

Update the notes of release {id} in {owner}/{repo} to {body}.

Publish draft release {id} in {owner}/{repo} by setting draft to {draft}.

GET /repos/{owner}/{repo}/releases/{id}/assets List a release's attachments · List release's attachments #

Ask an LLM

“What downloadable files are attached to a release?”

“Can I list the binaries uploaded to one release?”

Tell an agent

List the attachments of release {id} in {owner}/{repo}.

Show files attached to release {id} of {owner}/{repo}.

POST /repos/{owner}/{repo}/releases/{id}/assets Upload a release attachment · Create a release attachment #

Ask an LLM

“How do I upload a binary or zip to a release?”

“Can I give an uploaded release asset a custom file name?”

Tell an agent

Upload {attachment} to release {id} of {owner}/{repo}.

Attach {attachment} to release {id} in {owner}/{repo} named {name}.

GET /repos/{owner}/{repo}/releases/{id}/assets/{attachment_id} Get a release attachment · Get a release attachment #

Ask an LLM

“How can I see the size and download count of one release asset?”

“Where is the download URL for a specific release attachment?”

Tell an agent

Show attachment {attachment_id} on release {id} in {owner}/{repo}.

Get the download URL of asset {attachment_id} from release {id} of {owner}/{repo}.

DELETE /repos/{owner}/{repo}/releases/{id}/assets/{attachment_id} Delete a release attachment · Delete a release attachment #

Ask an LLM

“Can I remove a wrong file I uploaded to a release?”

“How do I delete one asset from a release?”

Tell an agent destructive · confirm first

Delete attachment {attachment_id} from release {id} in {owner}/{repo}.

Remove asset {attachment_id} on release {id} of {owner}/{repo}.

PATCH /repos/{owner}/{repo}/releases/{id}/assets/{attachment_id} Rename a release attachment · Edit a release attachment #

Ask an LLM

“Can I rename a file attached to a release?”

“How do I fix the name of an uploaded release asset?”

Tell an agent

Rename attachment {attachment_id} on release {id} in {owner}/{repo} to {name}.

Change asset {attachment_id} of release {id} in {owner}/{repo} to be called {name}.

GET /repos/{owner}/{repo}/reviewers List users who can review pull requests · Return all users that can be requested to review in this repo #

Ask an LLM

“Who can I request a pull request review from in this repository?”

“Which users are eligible reviewers for PRs here?”

Tell an agent

List the possible reviewers for {owner}/{repo}.

Show users who can be asked to review PRs in {owner}/{repo}.

GET /repos/{owner}/{repo}/signing-key.gpg Get the repository GPG signing key · Get signing-key.gpg for given repository #

Ask an LLM

“What GPG key does the server use to sign commits in this repository?”

“How can I get the public key to verify commits the instance signs?”

Tell an agent

Get the GPG signing key for {owner}/{repo}.

Download signing-key.gpg for {owner}/{repo}.

GET /repos/{owner}/{repo}/signing-key.pub Get the repository SSH signing key · Get signing-key.pub for given repository #

Ask an LLM

“Which SSH public key signs commits made by the server in a repo?”

“Can I fetch the SSH signing key to verify signed commits?”

Tell an agent

Get the SSH signing key for {owner}/{repo}.

Download signing-key.pub for {owner}/{repo}.

GET /repos/{owner}/{repo}/stargazers List a repository's stargazers · List a repo's stargazers #

Ask an LLM

“Who has starred a repository?”

“Can I page through the list of users who starred a repo?”

Tell an agent

List the stargazers of {owner}/{repo}.

Show everyone who starred {owner}/{repo}.

GET /repos/{owner}/{repo}/statuses/{sha} List statuses for a commit SHA · Get a commit's statuses #

Ask an LLM

“Which CI statuses were reported on one exact commit SHA?”

“Can I sort or filter the statuses of a commit by state?”

Tell an agent

List the statuses on commit {sha} in {owner}/{repo}.

Show {state} statuses reported for commit sha {sha} in {owner}/{repo}.

POST /repos/{owner}/{repo}/statuses/{sha} Report a commit status · Create a commit status #

Ask an LLM

“How does my CI system mark a commit as pending, success or failure?”

“Can I attach a link to build details when posting a status?”

Tell an agent

Set status {state} on commit {sha} in {owner}/{repo} for context {context}.

Report {state} on {sha} in {owner}/{repo} with target URL {target_url} and description {description}.

GET /repos/{owner}/{repo}/subscribers List a repository's watchers · List a repo's watchers #

Ask an LLM

“Who is watching a repository for notifications?”

“How many people follow changes to this repo?”

Tell an agent

List the watchers of {owner}/{repo}.

Show users subscribed to notifications from {owner}/{repo}.

GET /repos/{owner}/{repo}/subscription Check if I'm watching a repository · Check if the current user is watching a repo #

Ask an LLM

“Am I currently watching this repository?”

“Can I verify whether I'm subscribed to a repo's notifications?”

Tell an agent

Check if I'm watching {owner}/{repo}.

Tell me whether my account is subscribed to {owner}/{repo}.

PUT /repos/{owner}/{repo}/subscription Watch a repository · Watch a repo #

Ask an LLM

“How do I start watching a repository to get notifications?”

“Can I subscribe to all activity on a repo?”

Tell an agent

Watch {owner}/{repo}.

Subscribe me to notifications for {owner}/{repo}.

DELETE /repos/{owner}/{repo}/subscription Stop watching a repository · Unwatch a repo #

Ask an LLM

“How do I stop getting notifications from a repo I'm watching?”

“Can I unwatch a repository?”

Tell an agent destructive · confirm first

Unwatch {owner}/{repo}.

Unsubscribe me from {owner}/{repo} notifications.

GET /repos/{owner}/{repo}/tag_protections List tag protection rules · List tag protections for a repository #

Ask an LLM

“Which tag protection rules does a repository have?”

“Who is allowed to create protected tags here?”

Tell an agent

List the tag protections for {owner}/{repo}.

Show all tag protection rules in {owner}/{repo}.

POST /repos/{owner}/{repo}/tag_protections Create a tag protection rule · Create a tag protections for a repository #

Ask an LLM

“How do I stop anyone but release managers from creating version tags?”

“Can a tag protection rule match a pattern like v*?”

Tell an agent

Protect tags matching {name_pattern} in {owner}/{repo}.

Create tag protection {name_pattern} in {owner}/{repo} allowing users {whitelist_usernames}.

GET /repos/{owner}/{repo}/tag_protections/{id} Get a tag protection rule · Get a specific tag protection for the repository #

Ask an LLM

“What pattern and allowlist does one tag protection rule have?”

“Which teams may push tags under a given protection rule?”

Tell an agent

Show tag protection {id} in {owner}/{repo}.

Get the pattern and allowlist of tag protection {id} for {owner}/{repo}.

DELETE /repos/{owner}/{repo}/tag_protections/{id} Delete a tag protection rule · Delete a specific tag protection for the repository #

Ask an LLM

“How do I remove a tag protection rule?”

“Can I unprotect tags that match a pattern?”

Tell an agent destructive · confirm first

Delete tag protection {id} from {owner}/{repo}.

Remove tag protection rule {id} in {owner}/{repo}.

PATCH /repos/{owner}/{repo}/tag_protections/{id} Edit a tag protection rule · Edit a tag protections for a repository. #

Ask an LLM

“Can I change the pattern or allowed teams on an existing tag protection?”

“How do I add a user to a tag protection allowlist?”

Tell an agent

Change tag protection {id} in {owner}/{repo} to pattern {name_pattern}.

Allow teams {whitelist_teams} under tag protection {id} in {owner}/{repo}.

GET /repos/{owner}/{repo}/tags List a repository's tags · List a repository's tags #

Ask an LLM

“What tags exist in a repository?”

“Can I page through all version tags of a project?”

Tell an agent

List the tags in {owner}/{repo}.

Show {limit} tags per page from {owner}/{repo}.

POST /repos/{owner}/{repo}/tags Create a git tag · Create a new git tag in a repository #

Ask an LLM

“How do I tag a commit with a version number?”

“Can I create an annotated tag with a message on a specific branch or commit?”

Tell an agent

Create tag {tag_name} in {owner}/{repo}.

Tag {target} in {owner}/{repo} as {tag_name} with message {message}.

GET /repos/{owner}/{repo}/tags/{tag} Get a tag by name · Get the tag of a repository by tag name #

Ask an LLM

“Which commit does a particular tag point to?”

“How do I look up a tag's details by its name?”

Tell an agent

Show tag {tag} in {owner}/{repo}.

Get the commit that tag {tag} points at in {owner}/{repo}.

DELETE /repos/{owner}/{repo}/tags/{tag} Delete a git tag · Delete a repository's tag by name #

Ask an LLM

“How do I delete a git tag from a repository?”

“Can I remove a tag that was pushed by mistake?”

Tell an agent destructive · confirm first

Delete tag {tag} from {owner}/{repo}.

Remove the git tag {tag} in {owner}/{repo}.

GET /repos/{owner}/{repo}/teams List teams with access to a repository · List a repository's teams #

Ask an LLM

“Which organization teams have access to a repository?”

“Can I see all teams assigned to a repo?”

Tell an agent

List the teams on {owner}/{repo}.

Show every team with access to {owner}/{repo}.

GET /repos/{owner}/{repo}/teams/{team} Check if a team is assigned to a repository · Check if a team is assigned to a repository #

Ask an LLM

“Does a particular team have access to this repository?”

“Is a given team already assigned to a repo?”

Tell an agent

Check whether team {team} is assigned to {owner}/{repo}.

Confirm team {team} has access to {owner}/{repo}.

PUT /repos/{owner}/{repo}/teams/{team} Give a team access to a repository · Add a team to a repository #

Ask an LLM

“How do I grant an organization team access to a repo?”

“Can I assign a team to a repository?”

Tell an agent

Add team {team} to {owner}/{repo}.

Grant team {team} access to {owner}/{repo}.

DELETE /repos/{owner}/{repo}/teams/{team} Remove a team from a repository · Delete a team from a repository #

Ask an LLM

“How do I take a team's access away from a repository?”

“Can I unassign a team from a repo?”

Tell an agent destructive · confirm first

Remove team {team} from {owner}/{repo}.

Revoke team {team}'s access to {owner}/{repo}.

GET /repos/{owner}/{repo}/times List time tracked in a repository · List a repo's tracked times #

Ask an LLM

“How much time has been logged on issues in a repository?”

“Can I filter tracked time by user or by a date range?”

Tell an agent

List the tracked times in {owner}/{repo}.

Show time tracked in {owner}/{repo} by {user} since {since}.

GET /repos/{owner}/{repo}/times/{user} List one user's tracked time in a repo · List a user's tracked times in a repo #

Ask an LLM

“How much time did a specific person log in one repository?”

“Can I get a single user's time entries for a repo?”

Tell an agent

List the time entries for user {user} in {owner}/{repo}.

Show what {user} has tracked on {owner}/{repo} via their dedicated times endpoint.

GET /repos/{owner}/{repo}/topics List a repository's topics · Get list of topics that a repository has #

Ask an LLM

“Which topics is a repository tagged with?”

“Can I see the topic labels on a repo?”

Tell an agent

List the topics of {owner}/{repo}.

Show topic tags applied to {owner}/{repo}.

PUT /repos/{owner}/{repo}/topics Replace all of a repository's topics · Replace list of topics for a repository #

Ask an LLM

“Can I set a repository's full list of topics in one go?”

“How do I overwrite every topic on a repo with a new set?”

Tell an agent

Replace the topics of {owner}/{repo} with {topics}.

Set the full topic list of {owner}/{repo} to {topics}.

PUT /repos/{owner}/{repo}/topics/{topic} Add a topic to a repository · Add a topic to a repository #

Ask an LLM

“How do I add one more topic to a repository?”

“Can I tag a repo with a single new topic without touching the others?”

Tell an agent

Add topic {topic} to {owner}/{repo}.

Tag {owner}/{repo} with the topic {topic}.

DELETE /repos/{owner}/{repo}/topics/{topic} Remove a topic from a repository · Delete a topic from a repository #

Ask an LLM

“How do I remove one topic from a repo?”

“Can I untag a repository from a topic?”

Tell an agent destructive · confirm first

Remove topic {topic} from {owner}/{repo}.

Delete the topic {topic} on {owner}/{repo}.

POST /repos/{owner}/{repo}/transfer Transfer repository ownership · Transfer a repo ownership #

Ask an LLM

“How do I move a repository to another user or organization?”

“Can I choose which teams get access when transferring a repo to an org?”

Tell an agent

Transfer {owner}/{repo} to {new_owner}.

Move {owner}/{repo} to organization {new_owner} and give teams {team_ids} access.

POST /repos/{owner}/{repo}/transfer/accept Accept a repository transfer · Accept a repo transfer #

Ask an LLM

“Someone wants to transfer a repo to me; how do I accept it?”

“Can I approve a pending repository transfer?”

Tell an agent

Accept the pending transfer of {owner}/{repo}.

Approve the transfer of {owner}/{repo} to me.

POST /repos/{owner}/{repo}/transfer/reject Reject a repository transfer · Reject a repo transfer #

Ask an LLM

“How do I decline a repository someone tried to transfer to me?”

“Can I refuse a pending repo transfer?”

Tell an agent

Reject the pending transfer of {owner}/{repo}.

Decline the transfer of {owner}/{repo}.

POST /repos/{owner}/{repo}/wiki/new Create a wiki page · Create a wiki page #

Ask an LLM

“How do I add a new page to a repository's wiki?”

“Does a new wiki page's content need to be base64 encoded?”

Tell an agent

Create wiki page {title} in {owner}/{repo} with content {content_base64}.

Add a new wiki page {title} to {owner}/{repo} with commit message {message}.

GET /repos/{owner}/{repo}/wiki/page/{pageName} Get a wiki page · Get a wiki page #

Ask an LLM

“How do I read the content of one wiki page?”

“Who last edited a specific wiki page?”

Tell an agent

Show wiki page {pageName} in {owner}/{repo}.

Get the content of the {pageName} wiki page for {owner}/{repo}.

DELETE /repos/{owner}/{repo}/wiki/page/{pageName} Delete a wiki page · Delete a wiki page #

Ask an LLM

“How do I delete a page from a repository wiki?”

“Can I remove an outdated wiki page?”

Tell an agent destructive · confirm first

Delete wiki page {pageName} from {owner}/{repo}.

Remove the {pageName} page from the wiki of {owner}/{repo}.

PATCH /repos/{owner}/{repo}/wiki/page/{pageName} Edit a wiki page · Edit a wiki page #

Ask an LLM

“Can I update the text or title of an existing wiki page?”

“How do I rename a wiki page?”

Tell an agent

Update wiki page {pageName} in {owner}/{repo} with {content_base64}.

Rename wiki page {pageName} in {owner}/{repo} to {title}.

GET /repos/{owner}/{repo}/wiki/pages List wiki pages · Get all wiki pages #

Ask an LLM

“What pages does a repository's wiki contain?”

“Can I page through all wiki pages of a repo?”

Tell an agent

List the wiki pages of {owner}/{repo}.

Show every page in the {owner}/{repo} wiki.

GET /repos/{owner}/{repo}/wiki/revisions/{pageName} List a wiki page's revisions · Get revisions of a wiki page #

Ask an LLM

“What is the edit history of a wiki page?”

“Can I see who changed a wiki page and when?”

Tell an agent

List the revisions of wiki page {pageName} in {owner}/{repo}.

Show edit history for {pageName} in the {owner}/{repo} wiki.

POST /repos/{template_owner}/{template_repo}/generate Create a repository from a template · Create a repository using a template #

Ask an LLM

“How do I create a new repository from a template repo?”

“Can I copy a template's labels, webhooks and git hooks into the new repo?”

Tell an agent

Generate repository {name} for {owner} from template {template_owner}/{template_repo}.

Create {owner}/{name} from template {template_owner}/{template_repo} including git content {git_content}.

GET /repositories/{id} Get a repository by numeric id · Get a repository by id #

Ask an LLM

“Can I look up a repository when I only have its numeric id?”

“How do I resolve a repo id to its owner and name?”

Tell an agent

Get the repository with id {id}.

Find which repo has numeric id {id}.

GET /topics/search Search repository topics · search topics via keyword #

Ask an LLM

“Which topics exist on the instance that match a keyword?”

“Can I look up topic names before tagging a repo?”

Tell an agent

Search topics for {q}.

Find repository topics matching the keyword {q}.

POST /user/repos Create a repository for myself · Create a repository #

Ask an LLM

“How do I create a new repository under my own account?”

“Can I initialize a new repo with a README, license and .gitignore?”

Tell an agent

Create a repository named {name}.

Create private repo {name} with visibility private set to {private}.

Gitea Repository API

Operations 197

Documentation

Specifications

Code Examples

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification