aid: gitea name: Gitea url: https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/apis.yml created: '2026-05-06' modified: '2026-05-06' type: Index access: 3rd-Party position: Consumer specificationVersion: '0.19' image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg x-type: opensource tags: - Git - Source Control - DevOps - CI/CD - Code Hosting - Open Source - Self Hosted - Package Registry - Issue Tracking - Pull Requests description: >- Gitea is an open-source, self-hosted Git service and all-in-one DevOps platform written in Go and licensed under the MIT License. It provides Git hosting, code review, team collaboration, an integrated package registry across 24+ formats, issue tracking, project boards, and GitHub-Actions-compatible CI/CD via Gitea Actions. Gitea ships with a comprehensive Swagger 2.0 / OpenAPI-described REST API at /api/v1/ exposing roughly 300 operations across repositories, users, organizations, issues, packages, notifications, admin, and miscellaneous tags. The project is governed by CommitGo, Inc., which also offers Gitea Enterprise (self-managed, with SSO, audit logs and Kubernetes auto-scaling runners) and Gitea Cloud (single-tenant fully-managed hosting in multiple regions). apis: - aid: gitea:gitea-rest-api name: Gitea REST API tags: - REST - Git - Code Hosting - DevOps humanURL: https://docs.gitea.com/api/ baseURL: https://gitea.com/api/v1 properties: - url: https://docs.gitea.com/api/ type: Documentation - url: https://docs.gitea.com/api/1.26/ type: APIReference - url: https://demo.gitea.com/api/swagger type: Swagger - url: https://demo.gitea.com/swagger.v1.json type: OpenAPI - url: openapi/gitea-rest-api-openapi-original.yml type: OpenAPI - url: openapi/gitea-rest-api-openapi.yml type: OpenAPI - url: https://docs.gitea.com/development/api-usage type: GettingStarted - url: https://docs.gitea.com/development/oauth2-provider type: Authentication - url: json-schema/gitea-rest-api-repository-schema.json type: JSONSchema - url: json-schema/gitea-rest-api-issue-schema.json type: JSONSchema - url: json-schema/gitea-rest-api-pullrequest-schema.json type: JSONSchema - url: json-schema/gitea-rest-api-branch-schema.json type: JSONSchema - url: json-schema/gitea-rest-api-commit-schema.json type: JSONSchema - url: json-schema/gitea-rest-api-release-schema.json type: JSONSchema - url: json-schema/gitea-rest-api-hook-schema.json type: JSONSchema - url: json-schema/gitea-rest-api-organization-schema.json type: JSONSchema - url: json-schema/gitea-rest-api-team-schema.json type: JSONSchema - url: json-schema/gitea-rest-api-user-schema.json type: JSONSchema - url: json-schema/gitea-rest-api-notificationthread-schema.json type: JSONSchema - url: json-schema/gitea-rest-api-package-schema.json type: JSONSchema - url: json-schema/gitea-rest-api-label-schema.json type: JSONSchema - url: json-schema/gitea-rest-api-milestone-schema.json type: JSONSchema - url: json-schema/gitea-rest-api-tag-schema.json type: JSONSchema - url: json-schema/gitea-rest-api-comment-schema.json type: JSONSchema - url: json-structure/gitea-rest-api-repository-structure.json type: JSONStructure - url: json-structure/gitea-rest-api-issue-structure.json type: JSONStructure - url: json-structure/gitea-rest-api-pullrequest-structure.json type: JSONStructure - url: json-structure/gitea-rest-api-branch-structure.json type: JSONStructure - url: json-structure/gitea-rest-api-commit-structure.json type: JSONStructure - url: json-structure/gitea-rest-api-release-structure.json type: JSONStructure - url: json-structure/gitea-rest-api-hook-structure.json type: JSONStructure - url: json-structure/gitea-rest-api-organization-structure.json type: JSONStructure - url: json-structure/gitea-rest-api-team-structure.json type: JSONStructure - url: json-structure/gitea-rest-api-user-structure.json type: JSONStructure - url: json-structure/gitea-rest-api-notificationthread-structure.json type: JSONStructure - url: json-structure/gitea-rest-api-package-structure.json type: JSONStructure - url: json-structure/gitea-rest-api-label-structure.json type: JSONStructure - url: json-structure/gitea-rest-api-milestone-structure.json type: JSONStructure - url: json-structure/gitea-rest-api-tag-structure.json type: JSONStructure - url: json-structure/gitea-rest-api-comment-structure.json type: JSONStructure - url: examples/gitea-rest-api-repo-get-example.json type: CodeExamples - url: examples/gitea-rest-api-repo-update-example.json type: CodeExamples - url: examples/gitea-rest-api-issues-list-example.json type: CodeExamples - url: examples/gitea-rest-api-issue-create-example.json type: CodeExamples - url: examples/gitea-rest-api-pulls-list-example.json type: CodeExamples - url: examples/gitea-rest-api-pull-create-example.json type: CodeExamples - url: examples/gitea-rest-api-branches-list-example.json type: CodeExamples - url: examples/gitea-rest-api-commits-list-example.json type: CodeExamples - url: examples/gitea-rest-api-release-create-example.json type: CodeExamples - url: examples/gitea-rest-api-webhook-create-example.json type: CodeExamples - url: examples/gitea-rest-api-org-create-example.json type: CodeExamples - url: examples/gitea-rest-api-org-repos-list-example.json type: CodeExamples - url: examples/gitea-rest-api-user-get-example.json type: CodeExamples - url: examples/gitea-rest-api-user-repo-create-example.json type: CodeExamples - url: examples/gitea-rest-api-admin-user-create-example.json type: CodeExamples - url: examples/gitea-rest-api-notifications-list-example.json type: CodeExamples - url: examples/gitea-rest-api-packages-list-owner-example.json type: CodeExamples - url: examples/gitea-rest-api-repository-example.json type: CodeExamples - url: examples/gitea-rest-api-issue-example.json type: CodeExamples - url: examples/gitea-rest-api-pullrequest-example.json type: CodeExamples - url: examples/gitea-rest-api-release-example.json type: CodeExamples - url: examples/gitea-rest-api-hook-example.json type: CodeExamples - url: examples/gitea-rest-api-package-example.json type: CodeExamples description: >- Swagger 2.0-described REST API exposed by every Gitea instance at /api/v1/. Approximately 300 operations cover repository, branch, commit, pull request, issue, milestone, label, release, webhook, organization, team, user, package, notification, admin and miscellaneous functionality. Authentication is supported via BasicAuth, personal access tokens (Token / AccessToken / AuthorizationHeaderToken), OAuth2 bearer tokens, optional sudo headers/parameters, and TOTP. The same API surface is shipped with Gitea Enterprise and Gitea Cloud. - aid: gitea:gitea-actions-api name: Gitea Actions API tags: - CI/CD - Workflows - Automation humanURL: https://docs.gitea.com/usage/actions/overview baseURL: https://gitea.com/api/v1 properties: - url: https://docs.gitea.com/usage/actions/overview type: Documentation - url: https://docs.gitea.com/usage/actions/quickstart type: Quickstart - url: https://docs.gitea.com/usage/actions/comparison type: APIReference - url: https://gitea.com/gitea/act_runner type: GitHubRepository description: >- GitHub-Actions-compatible workflow engine embedded in Gitea. The Actions API surface is exposed under the main REST API (/repos/{owner}/{repo}/actions/* and /admin/actions/*) for managing workflows, runs, jobs, runners, and secrets. Actions runners are deployed via the Go-based act_runner project. - aid: gitea:gitea-package-registry name: Gitea Package Registry tags: - Packages - Registry - Artifacts humanURL: https://docs.gitea.com/usage/packages/overview baseURL: https://gitea.com/api/packages properties: - url: https://docs.gitea.com/usage/packages/overview type: Documentation - url: https://docs.gitea.com/usage/packages/cargo type: APIReference - url: https://docs.gitea.com/usage/packages/container type: APIReference - url: https://docs.gitea.com/usage/packages/helm type: APIReference description: >- Multi-format package registry built into Gitea exposing client protocols for 24 ecosystems including Cargo, Composer, Conan, Conda, Container (OCI), CRAN, Debian, Generic, Go, Helm, Maven, npm, NuGet, Pub, PyPI, RPM, RubyGems, Swift, Terraform, Vagrant, Alpine, Arch, Chef, and more. Packages are scoped per user or organization and addressable under /api/packages/{owner}/{type}. - aid: gitea:gitea-webhooks name: Gitea Webhooks tags: - Webhooks - Events - Eventing humanURL: https://docs.gitea.com/usage/webhooks properties: - url: https://docs.gitea.com/usage/webhooks type: Documentation - url: https://docs.gitea.com/usage/webhooks#event-information type: APIReference description: >- Outbound HTTP webhook system delivering JSON event payloads for pushes, pull requests, issues, releases, package events, and more. Webhooks are configurable per repository, organization or instance-wide and are managed through the REST API. - aid: gitea:gitea-cloud-management-api name: Gitea Cloud Management API tags: - Cloud - Management - Hosted humanURL: https://about.gitea.com/products/cloud baseURL: https://cloud.gitea.com properties: - url: https://about.gitea.com/products/cloud type: Documentation - url: https://about.gitea.com/products/gitea-cloud-pricing/ type: Pricing - url: https://cloud.gitea.com/ type: Console description: >- Gitea Cloud management plane for provisioning and operating single-tenant managed Gitea instances. Each provisioned instance exposes the same REST API at /api/v1/. The management plane itself does not currently publish a separate machine-readable OpenAPI definition; provisioning is performed via the cloud.gitea.com web console. common: - type: Website url: https://about.gitea.com/ - type: Documentation url: https://docs.gitea.com/ - type: APIReference url: https://docs.gitea.com/api/ - type: Blog url: https://blog.gitea.com/ - type: GitHubOrganization url: https://github.com/go-gitea - type: GitHubRepository url: https://github.com/go-gitea/gitea - type: SignUp url: https://cloud.gitea.com/ - type: Pricing url: https://about.gitea.com/pricing/ - type: Plans url: plans/gitea-plans-pricing.yml - type: RateLimits url: rate-limits/gitea-rate-limits.yml - type: FinOps url: finops/gitea-finops.yml - type: TermsOfService url: https://about.gitea.com/legal/terms-of-service - type: PrivacyPolicy url: https://about.gitea.com/legal/privacy-policy - type: Support url: https://forum.gitea.com/ - type: FAQ url: https://about.gitea.com/about/faq - type: ReleaseNotes url: https://blog.gitea.com/ - type: ChangeLog url: https://github.com/go-gitea/gitea/blob/main/CHANGELOG.md - type: StatusPage url: https://status.gitea.com/ - type: Security url: https://docs.gitea.com/administration/security - type: Compliance url: https://about.gitea.com/products/cloud - type: SDK url: https://gitea.com/gitea/go-sdk name: Gitea Go SDK - type: SDK url: https://www.npmjs.com/package/gitea-js name: gitea-js (TypeScript / JavaScript SDK) - type: SDK url: https://pypi.org/project/py-gitea/ name: py-gitea (Python SDK) - type: SDK url: https://github.com/hypermodeinc/gitea4j name: Gitea Java Client - type: CLI url: https://gitea.com/gitea/tea name: Tea CLI - type: CLI url: https://gitea.com/gitea/runner name: act_runner (Gitea Actions Runner) - type: GitHubRepository url: https://github.com/go-gitea/terraform-provider-gitea name: Terraform Provider for Gitea - type: GitHubRepository url: https://gitea.com/gitea/helm-gitea name: Helm Chart for Gitea - type: GitHubRepository url: https://gitea.com/gitea/helm-actions name: Helm Chart for Gitea Actions - type: Resources url: https://gitea.com/gitea/awesome-gitea name: Awesome Gitea (curated list) - type: Hub url: https://discord.gg/gitea name: Gitea Discord Community - type: Forum url: https://forum.gitea.com/ name: Gitea Community Forum - type: NaftikoCapability url: capabilities/gitea-capabilities.yml - type: SpectralRules url: rules/gitea-rules.yml - type: JSONLD url: json-ld/gitea-context.jsonld - type: Vocabulary url: vocabulary/gitea-vocabulary.yml - type: Features data: - name: Git Repository Hosting description: >- Self-hosted Git remote with HTTPS and SSH transport, granular repository visibility (public, private, internal), and full repository CRUD over the REST API. - name: Pull Requests And Code Review description: >- Branch-based pull requests with reviewers, required approvals, status checks, draft state, conflict detection, and inline review comments. - name: Issue Tracking And Projects description: >- Built-in issue tracker with labels, milestones, assignees, dependencies, and Kanban-style project boards at repo and org scope. - name: Gitea Actions CI/CD description: >- Native, GitHub-Actions-compatible workflow engine driven by the act_runner agent. Supports matrix builds, secrets, and autoscaling runners on Kubernetes (Enterprise). - name: Package Registry description: >- Multi-format package registry covering 24 ecosystems including Container (OCI), Maven, npm, NuGet, PyPI, Helm, Cargo, Terraform, and Generic uploads. - name: Webhooks And Events description: >- Outgoing webhooks for repository, issue, pull request, release, and package events with optional secret signing. - name: Comprehensive REST API description: >- Approximately 300 endpoints under /api/v1/ described by a Swagger 2.0 specification with multiple authentication schemes. - name: Authentication And SSO description: >- Supports BasicAuth, personal access tokens, OAuth2 with PKCE, OpenID Connect, LDAP, SMTP, PAM, SAML SSO (Enterprise), and two-factor authentication. - name: Multi-Database Storage description: >- Pluggable storage backend supporting SQLite, MySQL, PostgreSQL, TiDB, and MS SQL. - name: Mirroring And Migration description: >- Pull and push mirrors plus one-shot migration import from GitHub, GitLab, Bitbucket, Gitea, and other sources. - type: UseCases data: - name: Self-Hosted Source Control description: >- Run a private Git server inside a corporate or air-gapped network, retaining full data ownership. - name: Internal Developer Platform description: >- Combine Git, Actions, packages, and projects to build an internal developer platform without stitching together multiple SaaS vendors. - name: GitHub Actions Compatible CI/CD description: >- Reuse existing GitHub Actions workflows on a self-hosted or cloud runner without depending on github.com. - name: Multi-Format Artifact Registry description: >- Use Gitea as a single artifact registry for OCI containers, language packages, and generic binaries. - name: Regulated And Sovereign Hosting description: >- Single-tenant Gitea Cloud regions provide data-residency options for regulated industries and EU customers. - type: Integrations data: - name: Gitea Actions / GitHub Actions Marketplace description: >- GitHub-compatible workflow ecosystem; most public Actions run unmodified on Gitea Actions runners. - name: Drone CI description: >- First-class integration with Drone for repository-driven continuous delivery pipelines. - name: Jenkins description: >- Webhooks and credentials make Gitea a drop-in source for Jenkins multibranch pipelines. - name: Terraform description: >- Official Terraform provider (terraform-provider-gitea) and a Terraform module package registry endpoint. - name: Kubernetes description: >- Helm charts and operator-friendly deployment, plus Gitea Enterprise Kubernetes auto-scaling runners. - name: Argo CD / Flux description: >- GitOps controllers can use a Gitea repository as the source of truth for cluster state. - name: Discord And Slack description: >- Outbound webhook templates for Discord, Slack, and Microsoft Teams notifications. - name: Tea CLI description: >- Official command-line client for browsing and managing repositories, issues, pull requests, and releases. - type: Solutions data: - name: Gitea (Open Source) description: >- Free, MIT-licensed self-hosted edition with the complete feature set and unlimited users. - name: Gitea Enterprise description: >- Commercial self-hosted edition adding SAML SSO, audit logs, Kubernetes auto-scaling runners, priority SLA support, and installation/upgrade assistance. - name: Gitea Cloud description: >- Single-tenant fully-managed Gitea hosted by CommitGo with choice of regions (including a Frankfurt EU region), 24x7 availability, and SOC 2 Type 2 certification. - name: Gitea Actions Runner (act_runner) description: >- Stand-alone runner agent for executing Gitea Actions workflows on customer infrastructure. maintainers: - FN: Kin Lane email: kinlane@gmail.com url: https://kinlane.com