How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Gitea

Gitea Repository API

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

Documentation Provider Profile APIs.io OpenAPI GitHub

Gitea Repository API is one of 13 APIs that Gitea publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 32 JSON Schema definitions.

Tagged areas include Repository. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, code examples, and 32 JSON Schemas.

This API exposes 197 operations across 133 paths, and defines 146 schemas. It is described by OpenAPI 3.2.0, at version 1.27.0+dev-89-gf52b6f3315.

Requests are made against a single base URL, /api/v1.

197 operations 133 paths 146 schemas 27 DELETE104 GET11 PATCH44 POST11 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.27.0+dev-89-gf52b6f3315
Base URL
https://gitea.com/api/v1
Authentication
API Key, API Key, HTTP Basic, API Key, API Key, API Key, API Key
License
MIT
Resource Areas
1

Authentication & Security 7

Gitea Repository API declares 7 security schemes for authenticating requests. An API key is passed in the query as access_token (AccessToken). An API key is passed in the header as Authorization (AuthorizationHeaderToken). It accepts HTTP basic authentication (BasicAuth). An API key is passed in the header as Sudo (SudoHeader). An API key is passed in the query as sudo (SudoParam). An API key is passed in the header as X-GITEA-OTP (TOTPHeader). An API key is passed in the query as token (Token). By default, every request must be authenticated.

  • AccessToken — This authentication option is deprecated for removal in Gitea 1.23. Please use AuthorizationHeaderToken instead.
  • AuthorizationHeaderToken — API tokens must be prepended with "token" followed by a space.
  • SudoHeader — Sudo API request as the user provided as the key. Admin privileges are required.
  • SudoParam — Sudo API request as the user provided as the key. Admin privileges are required.
  • TOTPHeader — Must be used in combination with BasicAuth if two-factor authentication is enabled.
  • Token — This authentication option is deprecated for removal in Gitea 1.23. Please use AuthorizationHeaderToken instead.

Paths & Operations 197

Across 133 paths, the API surfaces 197 operations — 27 DELETE, 104 GET, 11 PATCH, 44 POST, 11 PUT. Each is listed below with its method, path, parameters, and response codes.

Repository 197
POST
/repos/migrate
Migrate a remote git repository
repoMigrate body → 201403409422
GET
/repos/search
Search for repositories
repoSearch 17 params → 200422
GET
/repos/{owner}/{repo}
Get a repository
repoGet 2 params → 200404
DELETE
/repos/{owner}/{repo}
Delete a repository
repoDelete 2 params → 204403404
PATCH
/repos/{owner}/{repo}
Edit a repository's properties. Only fields that are set will be changed
repoEdit 2 params body → 200403404422
GET
/repos/{owner}/{repo}/actions/artifacts
Lists all artifacts for a repository
getArtifacts 3 params → 200400404
GET
/repos/{owner}/{repo}/actions/artifacts/{artifact_id}
Gets a specific artifact for a workflow run
getArtifact 3 params → 200400404
DELETE
/repos/{owner}/{repo}/actions/artifacts/{artifact_id}
Deletes a specific artifact for a workflow run
deleteArtifact 3 params → 204400404
GET
/repos/{owner}/{repo}/actions/artifacts/{artifact_id}/zip
Downloads a specific artifact for a workflow run redirects to blob url
downloadArtifact 3 params → 302400404
GET
/repos/{owner}/{repo}/actions/jobs
Lists all jobs for a repository
listWorkflowJobs 5 params → 200400404
GET
/repos/{owner}/{repo}/actions/jobs/{job_id}
Gets a specific workflow job for a workflow run
getWorkflowJob 3 params → 200400404
GET
/repos/{owner}/{repo}/actions/jobs/{job_id}/logs
Downloads the job logs for a workflow run
downloadActionsRunJobLogs 3 params → 200400404
GET
/repos/{owner}/{repo}/actions/runners
Get repo-level runners
getRepoRunners 3 params → 200400404
POST
/repos/{owner}/{repo}/actions/runners/registration-token
Get a repository's actions runner registration token
repoCreateRunnerRegistrationToken 2 params → 200
GET
/repos/{owner}/{repo}/actions/runners/{runner_id}
Get a repo-level runner
getRepoRunner 3 params → 200400404
DELETE
/repos/{owner}/{repo}/actions/runners/{runner_id}
Delete a repo-level runner
deleteRepoRunner 3 params → 204400404
PATCH
/repos/{owner}/{repo}/actions/runners/{runner_id}
Update a repo-level runner
updateRepoRunner 3 params body → 200400404422
GET
/repos/{owner}/{repo}/actions/runs
Lists all runs for a repository run
getWorkflowRuns 9 params → 200400404
GET
/repos/{owner}/{repo}/actions/runs/{run}
Gets a specific workflow run
GetWorkflowRun 3 params → 200400404
DELETE
/repos/{owner}/{repo}/actions/runs/{run}
Delete a workflow run
deleteActionRun 3 params → 204400404
GET
/repos/{owner}/{repo}/actions/runs/{run}/artifacts
Lists all artifacts for a repository run
getArtifactsOfRun 4 params → 200400404
GET
/repos/{owner}/{repo}/actions/runs/{run}/jobs
Lists all jobs for a workflow run
listWorkflowRunJobs 6 params → 200400404
POST
/repos/{owner}/{repo}/actions/runs/{run}/jobs/{job_id}/rerun
Reruns a specific workflow job in a run
rerunWorkflowJob 4 params → 201400403404422
POST
/repos/{owner}/{repo}/actions/runs/{run}/rerun
Reruns an entire workflow run
rerunWorkflowRun 3 params → 201400403404422
POST
/repos/{owner}/{repo}/actions/runs/{run}/rerun-failed-jobs
Reruns all failed jobs in a workflow run
rerunFailedWorkflowRun 3 params → 201400403404422
GET
/repos/{owner}/{repo}/actions/secrets
List an repo's actions secrets
repoListActionsSecrets 4 params → 200404
PUT
/repos/{owner}/{repo}/actions/secrets/{secretname}
Create or Update a secret value in a repository
updateRepoSecret 3 params body → 201204400404
DELETE
/repos/{owner}/{repo}/actions/secrets/{secretname}
Delete a secret in a repository
deleteRepoSecret 3 params → 204400404
GET
/repos/{owner}/{repo}/actions/tasks
List a repository's action tasks
ListActionTasks 4 params → 200400403404409422
GET
/repos/{owner}/{repo}/actions/variables
Get repo-level variables list
getRepoVariablesList 4 params → 200400404
GET
/repos/{owner}/{repo}/actions/variables/{variablename}
Get a repo-level variable
getRepoVariable 3 params → 200400404
PUT
/repos/{owner}/{repo}/actions/variables/{variablename}
Update a repo-level variable
updateRepoVariable 3 params body → 201204400404
POST
/repos/{owner}/{repo}/actions/variables/{variablename}
Create a repo-level variable
createRepoVariable 3 params body → 201400409500
DELETE
/repos/{owner}/{repo}/actions/variables/{variablename}
Delete a repo-level variable
deleteRepoVariable 3 params → 200201204400404
GET
/repos/{owner}/{repo}/actions/workflows
List repository workflows
ActionsListRepositoryWorkflows 2 params → 200400403404422500
GET
/repos/{owner}/{repo}/actions/workflows/{workflow_id}
Get a workflow
ActionsGetWorkflow 3 params → 200400403404422500
PUT
/repos/{owner}/{repo}/actions/workflows/{workflow_id}/disable
Disable a workflow
ActionsDisableWorkflow 3 params → 204400403404422
POST
/repos/{owner}/{repo}/actions/workflows/{workflow_id}/dispatches
Create a workflow dispatch event
ActionsDispatchWorkflow 4 params body → 200204400403404422
PUT
/repos/{owner}/{repo}/actions/workflows/{workflow_id}/enable
Enable a workflow
ActionsEnableWorkflow 3 params → 204400403404409422
GET
/repos/{owner}/{repo}/activities/feeds
List a repository's activity feeds
repoListActivityFeeds 5 params → 200404
GET
/repos/{owner}/{repo}/archive/{archive}
Get an archive of a repository
repoGetArchive 4 params → 200404
GET
/repos/{owner}/{repo}/assignees
Return all users that have write access and can be assigned to issues
repoGetAssignees 2 params → 200404
POST
/repos/{owner}/{repo}/avatar
Update avatar
repoUpdateAvatar 2 params body → 204404
DELETE
/repos/{owner}/{repo}/avatar
Delete avatar
repoDeleteAvatar 2 params → 204404
GET
/repos/{owner}/{repo}/branch_protections
List branch protections for a repository
repoListBranchProtection 2 params → 200
POST
/repos/{owner}/{repo}/branch_protections
Create a branch protections for a repository
repoCreateBranchProtection 2 params body → 201403404422423
POST
/repos/{owner}/{repo}/branch_protections/priority
Update the priorities of branch protections for a repository
repoUpdateBranchProtectionPriories 2 params body → 204404422423
GET
/repos/{owner}/{repo}/branch_protections/{name}
Get a specific branch protection for the repository
repoGetBranchProtection 3 params → 200404
DELETE
/repos/{owner}/{repo}/branch_protections/{name}
Delete a specific branch protection for the repository
repoDeleteBranchProtection 3 params → 204404
PATCH
/repos/{owner}/{repo}/branch_protections/{name}
Edit a branch protections for a repository.
repoEditBranchProtection 3 params body → 200404422423
GET
/repos/{owner}/{repo}/branches
List a repository's branches
repoListBranches 4 params → 200
POST
/repos/{owner}/{repo}/branches
Create a branch
repoCreateBranch 2 params body → 201403404409423
GET
/repos/{owner}/{repo}/branches/{branch}
Retrieve a specific branch from a repository, including its effective branch…
repoGetBranch 3 params → 200404
PUT
/repos/{owner}/{repo}/branches/{branch}
Update a branch reference to a new commit
repoUpdateBranch 3 params body → 204403404409422
DELETE
/repos/{owner}/{repo}/branches/{branch}
Delete a specific branch from a repository
repoDeleteBranch 3 params → 204403404423
PATCH
/repos/{owner}/{repo}/branches/{branch}
Rename a branch
repoRenameBranch 3 params body → 204403404422
GET
/repos/{owner}/{repo}/collaborators
List a repository's collaborators
repoListCollaborators 4 params → 200404
GET
/repos/{owner}/{repo}/collaborators/{collaborator}
Check if a user is a collaborator of a repository
repoCheckCollaborator 3 params → 204404422
PUT
/repos/{owner}/{repo}/collaborators/{collaborator}
Add or Update a collaborator to a repository
repoAddCollaborator 3 params body → 204403404422
DELETE
/repos/{owner}/{repo}/collaborators/{collaborator}
Delete a collaborator from a repository
repoDeleteCollaborator 3 params → 204404422
GET
/repos/{owner}/{repo}/collaborators/{collaborator}/permission
Get repository permissions for a user
repoGetRepoPermissions 3 params → 200403404
GET
/repos/{owner}/{repo}/commits
Get a list of all commits from a repository
repoGetAllCommits 12 params → 200404409
GET
/repos/{owner}/{repo}/commits/{ref}/status
Get a commit's combined status, by branch/tag/commit reference
repoGetCombinedStatusByRef 5 params → 200400404
GET
/repos/{owner}/{repo}/commits/{ref}/statuses
Get a commit's statuses, by branch/tag/commit reference
repoListStatusesByRef 7 params → 200400404
GET
/repos/{owner}/{repo}/commits/{sha}/pull
Get the merged pull request of the commit
repoGetCommitPullRequest 3 params → 200404
GET
/repos/{owner}/{repo}/compare/{basehead}
Get commit comparison information
repoCompareDiff 3 params → 200404
GET
/repos/{owner}/{repo}/contents
Gets the metadata of all the entries of the root dir
repoGetContentsList 3 params → 200404
POST
/repos/{owner}/{repo}/contents
Modify multiple files in a repository
repoChangeFiles 2 params body → 201403404422423
GET
/repos/{owner}/{repo}/contents-ext/{filepath}
The extended "contents" API, to get file metadata and/or content, or list a…
repoGetContentsExt 5 params → 200404
GET
/repos/{owner}/{repo}/contents/{filepath}
Gets the metadata and contents (if a file) of an entry in a repository, or a…
repoGetContents 4 params → 200404
PUT
/repos/{owner}/{repo}/contents/{filepath}
Update a file in a repository if SHA is set, or create the file if SHA is not…
repoUpdateFile 3 params body → 200201403404422423
POST
/repos/{owner}/{repo}/contents/{filepath}
Create a file in a repository
repoCreateFile 3 params body → 201403404422423
DELETE
/repos/{owner}/{repo}/contents/{filepath}
Delete a file in a repository
repoDeleteFile 3 params body → 200400403404422423
POST
/repos/{owner}/{repo}/diffpatch
Apply diff patch to repository
repoApplyDiffPatch 2 params body → 200404423
GET
/repos/{owner}/{repo}/editorconfig/{filepath}
Get the EditorConfig definitions of a file in a repository
repoGetEditorConfig 4 params → 200404
GET
/repos/{owner}/{repo}/file-contents
Get the metadata and contents of requested files
repoGetFileContents 4 params → 200404
POST
/repos/{owner}/{repo}/file-contents
Get the metadata and contents of requested files
repoGetFileContentsPost 3 params body → 200404
GET
/repos/{owner}/{repo}/forks
List a repository's forks
listForks 4 params → 200404
POST
/repos/{owner}/{repo}/forks
Fork a repository
createFork 2 params body → 202403404409422
GET
/repos/{owner}/{repo}/git/blobs/{sha}
Gets the blob of a repository
GetBlob 3 params → 200400404
GET
/repos/{owner}/{repo}/git/commits/{sha}
Get a single commit from a repository
repoGetSingleCommit 6 params → 200404422
GET
/repos/{owner}/{repo}/git/commits/{sha}.{diffType}
Get a commit's diff or patch
repoDownloadCommitDiffOrPatch 4 params → 200404
GET
/repos/{owner}/{repo}/git/notes/{sha}
Get a note corresponding to a single commit from a repository
repoGetNote 5 params → 200404422
GET
/repos/{owner}/{repo}/git/refs
Get specified ref or filtered repository's refs
repoListAllGitRefs 2 params → 200404
GET
/repos/{owner}/{repo}/git/refs/{ref}
Get specified ref or filtered repository's refs
repoListGitRefs 3 params → 200404
GET
/repos/{owner}/{repo}/git/tags/{sha}
Gets the tag object of an annotated tag (not lightweight tags)
GetAnnotatedTag 3 params → 200400404
GET
/repos/{owner}/{repo}/git/trees/{sha}
Gets the tree of a repository
GetTree 6 params → 200400404
GET
/repos/{owner}/{repo}/hooks
List the hooks in a repository
repoListHooks 4 params → 200404
POST
/repos/{owner}/{repo}/hooks
Create a hook
repoCreateHook 2 params body → 201404
GET
/repos/{owner}/{repo}/hooks/git
List the Git hooks in a repository
repoListGitHooks 2 params → 200404
GET
/repos/{owner}/{repo}/hooks/git/{id}
Get a Git hook
repoGetGitHook 3 params → 200404
DELETE
/repos/{owner}/{repo}/hooks/git/{id}
Delete a Git hook in a repository
repoDeleteGitHook 3 params → 204404
PATCH
/repos/{owner}/{repo}/hooks/git/{id}
Edit a Git hook in a repository
repoEditGitHook 3 params body → 200404
GET
/repos/{owner}/{repo}/hooks/{id}
Get a hook
repoGetHook 3 params → 200404
DELETE
/repos/{owner}/{repo}/hooks/{id}
Delete a hook in a repository
repoDeleteHook 3 params → 204404
PATCH
/repos/{owner}/{repo}/hooks/{id}
Edit a hook in a repository
repoEditHook 3 params body → 200404
POST
/repos/{owner}/{repo}/hooks/{id}/tests
Test a push webhook
repoTestHook 4 params → 204404
GET
/repos/{owner}/{repo}/issue_config
Returns the issue config for a repo
repoGetIssueConfig 2 params → 200404
GET
/repos/{owner}/{repo}/issue_config/validate
Returns the validation information for a issue config
repoValidateIssueConfig 2 params → 200404
GET
/repos/{owner}/{repo}/issue_templates
Get available issue templates for a repository
repoGetIssueTemplates 2 params → 200404
GET
/repos/{owner}/{repo}/issues/pinned
List a repo's pinned issues
repoListPinnedIssues 2 params → 200404
GET
/repos/{owner}/{repo}/keys
List a repository's keys
repoListKeys 6 params → 200404
POST
/repos/{owner}/{repo}/keys
Add a key to a repository
repoCreateKey 2 params body → 201404422
GET
/repos/{owner}/{repo}/keys/{id}
Get a repository's key by id
repoGetKey 3 params → 200404
DELETE
/repos/{owner}/{repo}/keys/{id}
Delete a key from a repository
repoDeleteKey 3 params → 204403404
GET
/repos/{owner}/{repo}/languages
Get languages and number of bytes of code written
repoGetLanguages 2 params → 200404
GET
/repos/{owner}/{repo}/licenses
Get repo licenses
repoGetLicenses 2 params → 200404
GET
/repos/{owner}/{repo}/media/{filepath}
Get a file or it's LFS object from a repository
repoGetRawFileOrLFS 4 params → 200404
POST
/repos/{owner}/{repo}/merge-upstream
Merge a branch from upstream
repoMergeUpstream 2 params body → 200400404
POST
/repos/{owner}/{repo}/mirror-sync
Sync a mirrored repository
repoMirrorSync 2 params → 200403404
GET
/repos/{owner}/{repo}/new_pin_allowed
Returns if new Issue Pins are allowed
repoNewPinAllowed 2 params → 200404
GET
/repos/{owner}/{repo}/pulls
List a repo's pull requests
repoListPullRequests 10 params → 200404500
POST
/repos/{owner}/{repo}/pulls
Create a pull request
repoCreatePullRequest 2 params body → 201403404409422423
POST
/repos/{owner}/{repo}/pulls/comments/{id}/resolve
Resolve a pull request review comment
repoResolvePullReviewComment 3 params → 204400403404
POST
/repos/{owner}/{repo}/pulls/comments/{id}/unresolve
Unresolve a pull request review comment
repoUnresolvePullReviewComment 3 params → 204400403404
GET
/repos/{owner}/{repo}/pulls/pinned
List a repo's pinned pull requests
repoListPinnedPullRequests 2 params → 200404
GET
/repos/{owner}/{repo}/pulls/{base}/{head}
Get a pull request by base and head
repoGetPullRequestByBaseHead 4 params → 200404
GET
/repos/{owner}/{repo}/pulls/{index}
Get a pull request
repoGetPullRequest 3 params → 200404
PATCH
/repos/{owner}/{repo}/pulls/{index}
Update a pull request.
repoEditPullRequest 3 params body → 201403404409412422
GET
/repos/{owner}/{repo}/pulls/{index}.{diffType}
Get a pull request diff or patch
repoDownloadPullDiffOrPatch 5 params → 200404
GET
/repos/{owner}/{repo}/pulls/{index}/commits
Get commits for a pull request
repoGetPullRequestCommits 7 params → 200404
GET
/repos/{owner}/{repo}/pulls/{index}/files
Get changed files for a pull request
repoGetPullRequestFiles 7 params → 200404
GET
/repos/{owner}/{repo}/pulls/{index}/merge
Check if a pull request has been merged
repoPullRequestIsMerged 3 params → 204404
POST
/repos/{owner}/{repo}/pulls/{index}/merge
Merge a pull request
repoMergePullRequest 3 params body → 200403404405409423
DELETE
/repos/{owner}/{repo}/pulls/{index}/merge
Cancel the scheduled auto merge for the given pull request
repoCancelScheduledAutoMerge 3 params → 204403404423
POST
/repos/{owner}/{repo}/pulls/{index}/requested_reviewers
create review requests for a pull request
repoCreatePullReviewRequests 3 params body → 201404422
DELETE
/repos/{owner}/{repo}/pulls/{index}/requested_reviewers
cancel review requests for a pull request
repoDeletePullReviewRequests 3 params body → 204403404422
GET
/repos/{owner}/{repo}/pulls/{index}/reviews
List all reviews for a pull request
repoListPullReviews 5 params → 200404
POST
/repos/{owner}/{repo}/pulls/{index}/reviews
Create a review to a pull request
repoCreatePullReview 3 params body → 200404422
GET
/repos/{owner}/{repo}/pulls/{index}/reviews/{id}
Get a specific review for a pull request
repoGetPullReview 4 params → 200404
POST
/repos/{owner}/{repo}/pulls/{index}/reviews/{id}
Submit a pending review to a pull request
repoSubmitPullReview 4 params body → 200404422
DELETE
/repos/{owner}/{repo}/pulls/{index}/reviews/{id}
Delete a specific review from a pull request
repoDeletePullReview 4 params → 204403404
GET
/repos/{owner}/{repo}/pulls/{index}/reviews/{id}/comments
Get a specific review for a pull request
repoGetPullReviewComments 4 params → 200404
POST
/repos/{owner}/{repo}/pulls/{index}/reviews/{id}/dismissals
Dismiss a review for a pull request
repoDismissPullReview 4 params body → 200403404422
POST
/repos/{owner}/{repo}/pulls/{index}/reviews/{id}/undismissals
Cancel to dismiss a review for a pull request
repoUnDismissPullReview 4 params → 200403404422
POST
/repos/{owner}/{repo}/pulls/{index}/update
Merge PR's baseBranch into headBranch
repoUpdatePullRequest 4 params → 200403404409422
GET
/repos/{owner}/{repo}/push_mirrors
Get all push mirrors of the repository
repoListPushMirrors 4 params → 200400403404
POST
/repos/{owner}/{repo}/push_mirrors
add a push mirror to the repository
repoAddPushMirror 2 params body → 200400403404
POST
/repos/{owner}/{repo}/push_mirrors-sync
Sync all push mirrored repository
repoPushMirrorSync 2 params → 200400403404
GET
/repos/{owner}/{repo}/push_mirrors/{name}
Get push mirror of the repository by remoteName
repoGetPushMirrorByRemoteName 3 params → 200400403404
DELETE
/repos/{owner}/{repo}/push_mirrors/{name}
deletes a push mirror from a repository by remoteName
repoDeletePushMirror 3 params → 204400404
GET
/repos/{owner}/{repo}/raw/{filepath}
Get a file from a repository
repoGetRawFile 4 params → 200404
GET
/repos/{owner}/{repo}/releases
List a repo's releases
repoListReleases 6 params → 200404
POST
/repos/{owner}/{repo}/releases
Create a release
repoCreateRelease 2 params body → 201404409422
GET
/repos/{owner}/{repo}/releases/latest
Gets the most recent non-prerelease, non-draft release of a repository, sorted…
repoGetLatestRelease 2 params → 200404
GET
/repos/{owner}/{repo}/releases/tags/{tag}
Get a release by tag name
repoGetReleaseByTag 3 params → 200404
DELETE
/repos/{owner}/{repo}/releases/tags/{tag}
Delete a release by tag name
repoDeleteReleaseByTag 3 params → 204404422
GET
/repos/{owner}/{repo}/releases/{id}
Get a release
repoGetRelease 3 params → 200404
DELETE
/repos/{owner}/{repo}/releases/{id}
Delete a release
repoDeleteRelease 3 params → 204404422
PATCH
/repos/{owner}/{repo}/releases/{id}
Update a release
repoEditRelease 3 params body → 200404
GET
/repos/{owner}/{repo}/releases/{id}/assets
List release's attachments
repoListReleaseAttachments 3 params → 200404
POST
/repos/{owner}/{repo}/releases/{id}/assets
Create a release attachment
repoCreateReleaseAttachment 4 params body → 201400404413
GET
/repos/{owner}/{repo}/releases/{id}/assets/{attachment_id}
Get a release attachment
repoGetReleaseAttachment 4 params → 200404
DELETE
/repos/{owner}/{repo}/releases/{id}/assets/{attachment_id}
Delete a release attachment
repoDeleteReleaseAttachment 4 params → 204404
PATCH
/repos/{owner}/{repo}/releases/{id}/assets/{attachment_id}
Edit a release attachment
repoEditReleaseAttachment 4 params body → 201404422
GET
/repos/{owner}/{repo}/reviewers
Return all users that can be requested to review in this repo
repoGetReviewers 2 params → 200404
GET
/repos/{owner}/{repo}/signing-key.gpg
Get signing-key.gpg for given repository
repoSigningKey 2 params → 200
GET
/repos/{owner}/{repo}/signing-key.pub
Get signing-key.pub for given repository
repoSigningKeySSH 2 params → 200
GET
/repos/{owner}/{repo}/stargazers
List a repo's stargazers
repoListStargazers 4 params → 200403404
GET
/repos/{owner}/{repo}/statuses/{sha}
Get a commit's statuses
repoListStatuses 7 params → 200400404
POST
/repos/{owner}/{repo}/statuses/{sha}
Create a commit status
repoCreateStatus 3 params body → 201400404
GET
/repos/{owner}/{repo}/subscribers
List a repo's watchers
repoListSubscribers 4 params → 200404
GET
/repos/{owner}/{repo}/subscription
Check if the current user is watching a repo
userCurrentCheckSubscription 2 params → 200404
PUT
/repos/{owner}/{repo}/subscription
Watch a repo
userCurrentPutSubscription 2 params → 200403404
DELETE
/repos/{owner}/{repo}/subscription
Unwatch a repo
userCurrentDeleteSubscription 2 params → 204404
GET
/repos/{owner}/{repo}/tag_protections
List tag protections for a repository
repoListTagProtection 2 params → 200
POST
/repos/{owner}/{repo}/tag_protections
Create a tag protections for a repository
repoCreateTagProtection 2 params body → 201403404422423
GET
/repos/{owner}/{repo}/tag_protections/{id}
Get a specific tag protection for the repository
repoGetTagProtection 3 params → 200404
DELETE
/repos/{owner}/{repo}/tag_protections/{id}
Delete a specific tag protection for the repository
repoDeleteTagProtection 3 params → 204404
PATCH
/repos/{owner}/{repo}/tag_protections/{id}
Edit a tag protections for a repository.
repoEditTagProtection 3 params body → 200404422423
GET
/repos/{owner}/{repo}/tags
List a repository's tags
repoListTags 4 params → 200404
POST
/repos/{owner}/{repo}/tags
Create a new git tag in a repository
repoCreateTag 2 params body → 200404405409422423
GET
/repos/{owner}/{repo}/tags/{tag}
Get the tag of a repository by tag name
repoGetTag 3 params → 200404
DELETE
/repos/{owner}/{repo}/tags/{tag}
Delete a repository's tag by name
repoDeleteTag 3 params → 204404405409422423
GET
/repos/{owner}/{repo}/teams
List a repository's teams
repoListTeams 2 params → 200404
GET
/repos/{owner}/{repo}/teams/{team}
Check if a team is assigned to a repository
repoCheckTeam 3 params → 200404405
PUT
/repos/{owner}/{repo}/teams/{team}
Add a team to a repository
repoAddTeam 3 params → 204404405422
DELETE
/repos/{owner}/{repo}/teams/{team}
Delete a team from a repository
repoDeleteTeam 3 params → 204404405422
GET
/repos/{owner}/{repo}/times
List a repo's tracked times
repoTrackedTimes 7 params → 200400403404
GET
/repos/{owner}/{repo}/times/{user}deprecated
List a user's tracked times in a repo
userTrackedTimes 3 params → 200400403404
GET
/repos/{owner}/{repo}/topics
Get list of topics that a repository has
repoListTopics 4 params → 200404
PUT
/repos/{owner}/{repo}/topics
Replace list of topics for a repository
repoUpdateTopics 2 params body → 204404422
PUT
/repos/{owner}/{repo}/topics/{topic}
Add a topic to a repository
repoAddTopic 3 params → 204404422
DELETE
/repos/{owner}/{repo}/topics/{topic}
Delete a topic from a repository
repoDeleteTopic 3 params → 204404422
POST
/repos/{owner}/{repo}/transfer
Transfer a repo ownership
repoTransfer 2 params body → 202403404422
POST
/repos/{owner}/{repo}/transfer/accept
Accept a repo transfer
acceptRepoTransfer 2 params → 202403404
POST
/repos/{owner}/{repo}/transfer/reject
Reject a repo transfer
rejectRepoTransfer 2 params → 200403404
POST
/repos/{owner}/{repo}/wiki/new
Create a wiki page
repoCreateWikiPage 2 params body → 201400403404423
GET
/repos/{owner}/{repo}/wiki/page/{pageName}
Get a wiki page
repoGetWikiPage 3 params → 200404
DELETE
/repos/{owner}/{repo}/wiki/page/{pageName}
Delete a wiki page
repoDeleteWikiPage 3 params → 204403404423
PATCH
/repos/{owner}/{repo}/wiki/page/{pageName}
Edit a wiki page
repoEditWikiPage 3 params body → 200400403404423
GET
/repos/{owner}/{repo}/wiki/pages
Get all wiki pages
repoGetWikiPages 4 params → 200404
GET
/repos/{owner}/{repo}/wiki/revisions/{pageName}
Get revisions of a wiki page
repoGetWikiPageRevisions 4 params → 200404
POST
/repos/{template_owner}/{template_repo}/generate
Create a repository using a template
generateRepo 2 params body → 201403404409422
GET
/repositories/{id}
Get a repository by id
repoGetByID 1 param → 200404
GET
/topics/search
search topics via keyword
topicSearch 3 params → 200403404
POST
/user/repos
Create a repository
createCurrentUserRepo body → 201400409422

Schemas 146

The contract defines 146 schemas that model the data the API accepts and returns. The most detailed are Repository (67 properties), PullRequest (38 properties), EditRepoOption (33 properties), BranchProtection (33 properties). Each schema is shown below with its type and property counts.

EditAttachmentOptions
object
EditAttachmentOptions options for editing attachments
1 property
ChangeFilesOptions
object
ChangeFilesOptions options for creating, updating or deleting multiple files Note: author and committer are optional (if only one is given, it will be used for…
9 properties 1 required
CommitStats
object
CommitStats is statistics for a RepoCommit
3 properties
TrackedTime
object
TrackedTime worked time for an issue / pr
7 properties
RepoCommit
object
6 properties
GitTreeResponse
object
GitTreeResponse returns a git tree
6 properties
FileLinksResponse
object
FileLinksResponse contains the links for a repo's file
3 properties
CreatePullReviewOptions
object
CreatePullReviewOptions are options to create a pull request review
4 properties
Attachment
object
Attachment a generic attachment
7 properties
CommitDateOptions
object
CommitDateOptions store dates for GITAUTHORDATE and GITCOMMITTERDATE
2 properties
APIError
object
APIError is an api error with a message
2 properties
CreateWikiPageOptions
object
CreateWikiPageOptions form for creating wiki
3 properties
Identity
object
Identity for a person's identity like an author or committer
2 properties
CreateStatusOption
object
CreateStatusOption holds the information needed to create a new CommitStatus for a Commit
4 properties
PushMirror
object
PushMirror represents information of a push mirror
8 properties
CreateForkOption
object
CreateForkOption options for creating a fork
2 properties
CreateOrUpdateSecretOption
object
CreateOrUpdateSecretOption options when creating or updating secret
2 properties 1 required
RenameBranchRepoOption
object
RenameBranchRepoOption options when renaming a branch in a repository
1 property 1 required
PRBranchInfo
object
PRBranchInfo information about a branch
5 properties
ApplyDiffPatchFileOptions
object
ApplyDiffPatchFileOptions options for applying a diff patch Note: author and committer are optional (if only one is given, it will be used for the other, other…
9 properties 1 required
CreateHookOption
object
CreateHookOption options when create a hook
7 properties 2 required
MergeUpstreamResponse
object
1 property
PayloadCommit
object
PayloadCommit represents a commit
10 properties
ActionWorkflowStep
object
ActionWorkflowStep represents a step of a WorkflowJob
6 properties
DeleteFileOptions
object
DeleteFileOptions options for deleting a file Note: author and committer are optional (if only one is given, it will be used for the other, otherwise the authe…
9 properties 1 required
RunDetails
object
RunDetails returns workflowdispatch runid and url
3 properties
ChangedFile
object
ChangedFile store information about files affected by the pull request
9 properties
ActionArtifactsResponse
object
ActionArtifactsResponse returns ActionArtifacts
2 properties
GitObject
object
3 properties
ContentsExtResponse
object
2 properties
RepositoryMeta
object
RepositoryMeta basic repository information
4 properties
MergeUpstreamRequest
object
2 properties
PullReviewComment
object
PullReviewComment represents a comment on a pull request review
15 properties
GitBlobResponse
object
GitBlobResponse represents a git blob
7 properties
MergePullRequestOption
object
MergePullRequestForm form for merging Pull Request
8 properties 1 required
UpdateRepoAvatarOption
object
UpdateRepoAvatarUserOption options when updating the repo avatar
1 property
CreateRepoOption
object
CreateRepoOption options when creating repository
12 properties 1 required
AnnotatedTagObject
object
AnnotatedTagObject contains meta information of the tag object
3 properties
ExternalWiki
object
ExternalWiki represents setting for external wiki
1 property
IssueConfig
object
2 properties
AnnotatedTag
object
AnnotatedTag represents an annotated tag
7 properties
TransferRepoOption
object
TransferRepoOption options when transfer a repository's ownership
2 properties 1 required
FileCommitResponse
object
9 properties
CreatePullRequestOption
object
CreatePullRequestOption options when creating a pull request
12 properties
ContentsResponse
object
ContentsResponse contains information about a repo's entry's (dir, file, symlink, submodule) metadata and content
20 properties
EditReleaseOption
object
EditReleaseOption options when editing a release
6 properties
ActionRunnersResponse
object
ActionRunnersResponse returns Runners
2 properties
CreateActionWorkflowDispatch
object
CreateActionWorkflowDispatch represents the payload for triggering a workflow dispatch event
2 properties 1 required
ActionRunner
object
ActionRunner represents a Runner
7 properties
FilesResponse
object
FilesResponse contains information about multiple files from a repo
3 properties
ChangeFileOperation
object
ChangeFileOperation for creating, updating or deleting a file
5 properties 2 required
CreatePullReviewComment
object
CreatePullReviewComment represent a review comment for creation api
4 properties
CommitAffectedFiles
object
CommitAffectedFiles store information about files affected by the commit
2 properties
CommitMeta
object
3 properties
FileResponse
object
FileResponse contains information about a repo's file
3 properties
PullRequest
object
PullRequest represents a pull request
38 properties
EditPullRequestOption
object
EditPullRequestOption options when modify pull request
12 properties
EditBranchProtectionOption
object
EditBranchProtectionOption options for editing a branch protection
29 properties
GitHook
object
GitHook represents a Git repository hook
3 properties
DismissPullReviewOptions
object
DismissPullReviewOptions are options to dismiss a pull request review
2 properties
CombinedStatus
object
CombinedStatus holds the combined state of several statuses for a single commit
7 properties
ExternalTracker
object
ExternalTracker represents settings for external tracker
4 properties
PayloadCommitVerification
object
PayloadCommitVerification represents the GPG verification of a commit
5 properties
Commit
object
10 properties
ActionWorkflow
object
ActionWorkflow represents a ActionWorkflow
10 properties
Release
object
Release represents a repository release
16 properties
UpdateVariableOption
object
UpdateVariableOption the option when updating variable
3 properties 1 required
CommitUser
object
3 properties
NewIssuePinsAllowed
object
NewIssuePinsAllowed represents an API response that says if new Issue Pins are allowed
2 properties
ActionWorkflowJob
object
ActionWorkflowJob represents a WorkflowJob
18 properties
GenerateRepoOption
object
GenerateRepoOption options when creating a repository using a template
12 properties 2 required
PullReview
object
PullReview represents a pull request review
14 properties
TopicResponse
object
TopicResponse for returning topics
5 properties
CreateTagProtectionOption
object
CreateTagProtectionOption options for creating a tag protection
3 properties
CommitStatus
object
CommitStatus holds a single status of a single Commit
9 properties
InternalTracker
object
InternalTracker represents settings for internal tracker
3 properties
IssueConfigValidation
object
2 properties
BranchProtection
object
BranchProtection represents a branch protection for a repository
33 properties
ActionWorkflowResponse
object
ActionWorkflowResponse returns a ActionWorkflow
2 properties
UpdateBranchRepoOption
object
UpdateBranchRepoOption options when updating a branch reference in a repository
3 properties 1 required
PullReviewRequestOptions
object
PullReviewRequestOptions are options to add or remove pull request review requests
2 properties
CreateBranchProtectionOption
object
CreateBranchProtectionOption options for creating a branch protection
31 properties
IssueConfigContactLink
object
3 properties
CreateTagOption
object
CreateTagOption options when creating a tag
3 properties 1 required
SubmitPullReviewOptions
object
SubmitPullReviewOptions are options to submit a pending pull request review
2 properties
Organization
object
Organization represents an organization
11 properties
Milestone
object
Milestone milestone is a collection of issues on one repository
10 properties
EditTagProtectionOption
object
EditTagProtectionOption options for editing a tag protection
3 properties
Issue
object
Issue represents an issue in a repository
27 properties
UpdateFileOptions
object
UpdateFileOptions options for updating or creating a file Note: author and committer are optional (if only one is given, it will be used for the other, otherwi…
11 properties 1 required
MigrateRepoOptions
object
MigrateRepoOptions options for migrating repository's this is used to interact with api v1
22 properties 2 required
IssueTemplateStringSlice
array
WatchInfo
object
WatchInfo represents an API watch status of one repository
6 properties
ActionTask
object
ActionTask represents a ActionTask
13 properties
CreateHookOptionConfig
object
CreateHookOptionConfig has all config options in it required are "contenttype" and "url" Required
UpdateBranchProtectionPriories
object
UpdateBranchProtectionPriories a list to update the branch protection rule priorities
1 property
WikiPage
object
WikiPage a wiki page
8 properties
SearchResults
object
SearchResults results of a successful search
2 properties
TopicName
object
TopicName a list of repo topic names
1 property
CreateFileOptions
object
CreateFileOptions options for creating a file Note: author and committer are optional (if only one is given, it will be used for the other, otherwise the authe…
9 properties 1 required
CreateReleaseOption
object
CreateReleaseOption options when creating a release
7 properties 1 required
ActionWorkflowRun
object
ActionWorkflowRun represents a WorkflowRun
19 properties
Comment
object
Comment represents a comment on a commit or issue
11 properties
CreateKeyOption
object
CreateKeyOption options when creating a key
3 properties 2 required
DeployKey
object
DeployKey a deploy key
9 properties
CreateVariableOption
object
CreateVariableOption the option when creating variable
2 properties 1 required
Activity
object
13 properties
EditHookOption
object
EditHookOption options when modify one hook
6 properties
Branch
object
Branch represents a repository branch
9 properties
Secret
object
Secret represents a secret
3 properties
GetFilesOptions
object
GetFilesOptions options for retrieving metadate and content of multiple files
1 property
ActionRunnerLabel
object
ActionRunnerLabel represents a Runner Label
3 properties
IssueTemplate
object
IssueTemplate represents an issue template for a repository
9 properties
Label
object
Label a label to an issue or a pr
7 properties
RepoTransfer
object
RepoTransfer represents a pending repo transfer
3 properties
CreateBranchRepoOption
object
CreateBranchRepoOption options when creating a branch in a repository
3 properties 1 required
ActionWorkflowRunsResponse
object
ActionWorkflowRunsResponse returns ActionWorkflowRuns
2 properties
Tag
object
Tag represents a repository tag
6 properties
Repository
object
Repository represents a repository
67 properties
ActionTaskResponse
object
ActionTaskResponse returns a ActionTask
2 properties
WikiCommit
object
WikiCommit page commit/revision
4 properties
User
object
User represents a user
22 properties
EditActionRunnerOption
object
1 property 1 required
PullRequestMeta
object
PullRequestMeta PR info if an issue is a PR
4 properties
PayloadUser
object
PayloadUser represents the author or committer of a commit
3 properties
EditRepoOption
object
EditRepoOption options when editing a repository's properties
33 properties
ActionWorkflowJobsResponse
object
ActionWorkflowJobsResponse returns ActionWorkflowJobs
2 properties
Reference
object
3 properties
Hook
object
Hook a hook is a web hook when one repository changed
10 properties
CreatePushMirrorOption
object
5 properties
RepoCollaboratorPermission
object
RepoCollaboratorPermission to get repository permission for a collaborator
3 properties
Team
object
Team represents a team in an organization
9 properties
ActionVariable
object
ActionVariable return value of the query API
5 properties
GitEntry
object
GitEntry represents a git tree
6 properties
EditGitHookOption
object
EditGitHookOption options when modifying one Git hook
1 property
WikiCommitList
object
WikiCommitList commit/revision list
2 properties
Permission
object
Permission represents a set of permissions
3 properties
RepoTopicOptions
object
RepoTopicOptions a collection of repo topic names
1 property
WikiPageMetaData
object
WikiPageMetaData wiki page meta information
4 properties
FileDeleteResponse
object
FileDeleteResponse contains information about a repo's file that was deleted
3 properties
TagProtection
object
TagProtection represents a tag protection
6 properties
ActionArtifact
object
ActionArtifact represents a ActionArtifact
10 properties
IssueFormField
object
IssueFormField represents a form field
5 properties
Compare
object
2 properties
Note
object
Note contains information related to a git note
2 properties
AddCollaboratorOption
object
AddCollaboratorOption options when adding a user as a collaborator of a repository
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

gitea-repository-api-openapi.yml Raw ↑

Other APIs Gitea publishes across the network.

Gitea Actions API
AE Profile APIs.io
Gitea Package Registry
AE Profile APIs.io
Gitea Webhooks
AE Profile APIs.io
Gitea Cloud Management API
AE Profile APIs.io
Gitea Admin API
AE Profile APIs.io
Gitea Issue API
AE Profile APIs.io
Gitea Miscellaneous API
AE Profile APIs.io
Gitea Notification API
AE Profile APIs.io
Gitea Organization API
AE Profile APIs.io
Gitea Package API
AE Profile APIs.io
Gitea Settings API
AE Profile APIs.io
Gitea User API
AE Profile APIs.io
#Repository
← Back to G APIs
API Details
ID
gitea:gitea-repository-api
Base URL
https://gitea.com/api/v1
Docs
https://docs.gitea.com/api/
Provider
Gitea
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=gitea-repository-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/gitea-repository-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Gitea Repository API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.