Information
- License: MIT
- OpenAPI version:
3.0.3
Gitea API 1.27.2
Gitea API 1.27.2
Section titled “Gitea API 1.27.2”This documentation describes the Gitea API.
Download the specification:OpenAPI 3.0, Swagger 2.0
Operations
admin
Instance administration: users, organizations, runners, cron jobs and system hooks.
issue
Issues and pull request conversations: comments, labels, milestones, reactions and timelines.
miscellaneous
Markdown rendering, signing keys, server version and instance metadata.
notification
Notification threads and subscriptions of the authenticated user.
organization
Organizations and their teams, members, repositories and settings.
package
Package registries: listing, inspecting and deleting published packages.
repository
Repositories and their contents, branches, tags, releases, pull requests, webhooks and actions.
settings
Instance settings exposed to clients: api, attachment, repository and ui limits.
user
The authenticated user and other users: keys, tokens, follows, stars and applications.
Authentication
Section titled “Authentication”AccessToken
Section titled “AccessToken”This authentication option is deprecated for removal in Gitea 1.23. Please use AuthorizationHeaderToken instead.
Security scheme type: apiKey
Query parameter name: access_token
AuthorizationHeaderToken
Section titled “AuthorizationHeaderToken”API tokens must be prepended with “token” followed by a space.
Security scheme type: apiKey
Header parameter name: Authorization
BasicAuth
Section titled “BasicAuth”Security scheme type: http
SudoHeader
Section titled “SudoHeader”Sudo API request as the user provided as the key. Admin privileges are required.
Security scheme type: apiKey
Header parameter name: Sudo
SudoParam
Section titled “SudoParam”Sudo API request as the user provided as the key. Admin privileges are required.
Security scheme type: apiKey
Query parameter name: sudo
TOTPHeader
Section titled “TOTPHeader”Must be used in combination with BasicAuth if two-factor authentication is enabled.
Security scheme type: apiKey
Header parameter name: X-GITEA-OTP
This authentication option is deprecated for removal in Gitea 1.23. Please use AuthorizationHeaderToken instead.
Security scheme type: apiKey
Query parameter name: token