Gitea website screenshot

Gitea

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).

5 APIs 10 Features
GitSource ControlDevOpsCI/CDCode HostingOpen SourceSelf HostedPackage RegistryIssue TrackingPull Requests

APIs

Gitea REST API

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,...

Gitea Actions API

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/*) fo...

Gitea Package Registry

Multi-format package registry built into Gitea exposing client protocols for 24 ecosystems including Cargo, Composer, Conan, Conda, Container (OCI), CRAN, Debian, Generic, Go, H...

Gitea Webhooks

Outbound HTTP webhook system delivering JSON event payloads for pushes, pull requests, issues, releases, package events, and more. Webhooks are configurable per repository, orga...

Gitea Cloud Management API

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 managemen...

Collections

Gitea API

POSTMAN

Gitea API

POSTMAN

Gitea API

OPEN

Arazzo Workflows

Gitea Bootstrap Repository With Tracking Issue

Create a repository, open a tracking issue in it, and add a kickoff comment.

ARAZZO

Gitea Feature Branch To Merged Pull Request

Create a feature branch, open a pull request, and merge it.

ARAZZO

Gitea Comment And Close Issue

Post a closing comment on an issue and then close it.

ARAZZO

Gitea Commit File On New Branch And Open Pull Request

Create a branch, commit a new file to it, and open a pull request.

ARAZZO

Gitea Create Branch And Await Availability

Create a branch and poll until it is retrievable from the repository.

ARAZZO

Gitea Draft Then Publish Release

Create a draft release, attach an asset, then publish the release.

ARAZZO

Gitea Create Label And Apply To Issue

Create a repository label and apply it to an existing issue.

ARAZZO

Gitea Create Milestone With Tracked Issue

Create a milestone and open an issue assigned to that milestone.

ARAZZO

Gitea Sync Mirror And Confirm Branch

Confirm a repository is a mirror, trigger a sync, and verify a branch.

ARAZZO

Gitea Open And Triage Pull Request

Open a pull request and then triage it with assignees and labels.

ARAZZO

Gitea Bootstrap Organization With Shared Label

Create an organization, add a repository, and create an org-wide label.

ARAZZO

Gitea Provision Organization Repository With Webhook

Create an organization, add a repository to it, and register a webhook.

ARAZZO

Gitea Create Organization With Webhook

Create an organization and register an organization-level webhook.

ARAZZO

Gitea Create Release And Verify By Tag

Create a release and confirm it by looking it up by its tag.

ARAZZO

Gitea Publish Release With Asset

Create a release on a tag and upload a binary asset to it.

ARAZZO

Gitea Create Repository With A Labeled Issue

Create a repository, create a label in it, and open a pre-labeled issue.

ARAZZO

Gitea Create Repository With Webhook

Create a repository for the authenticated user and register a webhook.

ARAZZO

Gitea Report Issue To Existing Repository

Confirm a repository exists, open an issue in it, and comment on it.

ARAZZO

Gitea Sprint Issue Setup

Create a milestone and label, open an issue under them, and apply the label.

ARAZZO

Pricing Plans

Gitea Plans Pricing

3 plans

PLANS

Rate Limits

Gitea Rate Limits

5 limits

RATE LIMITS

FinOps

Gitea Finops

FINOPS

Features

Git Repository Hosting

Self-hosted Git remote with HTTPS and SSH transport, granular repository visibility (public, private, internal), and full repository CRUD over the REST API.

Pull Requests And Code Review

Branch-based pull requests with reviewers, required approvals, status checks, draft state, conflict detection, and inline review comments.

Issue Tracking And Projects

Built-in issue tracker with labels, milestones, assignees, dependencies, and Kanban-style project boards at repo and org scope.

Gitea Actions CI/CD

Native, GitHub-Actions-compatible workflow engine driven by the act_runner agent. Supports matrix builds, secrets, and autoscaling runners on Kubernetes (Enterprise).

Package Registry

Multi-format package registry covering 24 ecosystems including Container (OCI), Maven, npm, NuGet, PyPI, Helm, Cargo, Terraform, and Generic uploads.

Webhooks And Events

Outgoing webhooks for repository, issue, pull request, release, and package events with optional secret signing.

Comprehensive REST API

Approximately 300 endpoints under /api/v1/ described by a Swagger 2.0 specification with multiple authentication schemes.

Authentication And SSO

Supports BasicAuth, personal access tokens, OAuth2 with PKCE, OpenID Connect, LDAP, SMTP, PAM, SAML SSO (Enterprise), and two-factor authentication.

Multi-Database Storage

Pluggable storage backend supporting SQLite, MySQL, PostgreSQL, TiDB, and MS SQL.

Mirroring And Migration

Pull and push mirrors plus one-shot migration import from GitHub, GitLab, Bitbucket, Gitea, and other sources.

Use Cases

Self-Hosted Source Control

Run a private Git server inside a corporate or air-gapped network, retaining full data ownership.

Internal Developer Platform

Combine Git, Actions, packages, and projects to build an internal developer platform without stitching together multiple SaaS vendors.

GitHub Actions Compatible CI/CD

Reuse existing GitHub Actions workflows on a self-hosted or cloud runner without depending on github.com.

Multi-Format Artifact Registry

Use Gitea as a single artifact registry for OCI containers, language packages, and generic binaries.

Regulated And Sovereign Hosting

Single-tenant Gitea Cloud regions provide data-residency options for regulated industries and EU customers.

Integrations

Gitea Actions / GitHub Actions Marketplace

GitHub-compatible workflow ecosystem; most public Actions run unmodified on Gitea Actions runners.

Drone CI

First-class integration with Drone for repository-driven continuous delivery pipelines.

Jenkins

Webhooks and credentials make Gitea a drop-in source for Jenkins multibranch pipelines.

Terraform

Official Terraform provider (terraform-provider-gitea) and a Terraform module package registry endpoint.

Kubernetes

Helm charts and operator-friendly deployment, plus Gitea Enterprise Kubernetes auto-scaling runners.

Argo CD / Flux

GitOps controllers can use a Gitea repository as the source of truth for cluster state.

Discord And Slack

Outbound webhook templates for Discord, Slack, and Microsoft Teams notifications.

Tea CLI

Official command-line client for browsing and managing repositories, issues, pull requests, and releases.

Solutions

Gitea (Open Source)

Free, MIT-licensed self-hosted edition with the complete feature set and unlimited users.

Gitea Enterprise

Commercial self-hosted edition adding SAML SSO, audit logs, Kubernetes auto-scaling runners, priority SLA support, and installation/upgrade assistance.

Gitea Cloud

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.

Gitea Actions Runner (act_runner)

Stand-alone runner agent for executing Gitea Actions workflows on customer infrastructure.

Semantic Vocabularies

Gitea Context

0 classes · 14 properties

JSON-LD

API Governance Rules

Gitea API Rules

16 rules · 4 errors 9 warnings

SPECTRAL

JSON Structure

Gitea Rest Api Branch Structure

9 properties

JSON STRUCTURE

Gitea Rest Api Comment Structure

11 properties

JSON STRUCTURE

Gitea Rest Api Commit Structure

10 properties

JSON STRUCTURE

Gitea Rest Api Hook Structure

10 properties

JSON STRUCTURE

Gitea Rest Api Issue Structure

27 properties

JSON STRUCTURE

Gitea Rest Api Label Structure

7 properties

JSON STRUCTURE

Gitea Rest Api Milestone Structure

10 properties

JSON STRUCTURE

Gitea Rest Api Notificationthread Structure

7 properties

JSON STRUCTURE

Gitea Rest Api Organization Structure

11 properties

JSON STRUCTURE

Gitea Rest Api Package Structure

9 properties

JSON STRUCTURE

Gitea Rest Api Pullrequest Structure

38 properties

JSON STRUCTURE

Gitea Rest Api Release Structure

16 properties

JSON STRUCTURE

Gitea Rest Api Repository Structure

67 properties

JSON STRUCTURE

Gitea Rest Api Tag Structure

6 properties

JSON STRUCTURE

Gitea Rest Api Team Structure

9 properties

JSON STRUCTURE

Gitea Rest Api User Structure

22 properties

JSON STRUCTURE

Example Payloads

Gitea Rest Api Hook Example

6 fields

EXAMPLE

Gitea Rest Api Issue Example

12 fields

EXAMPLE

Resources

🔗
PostmanWorkspace
PostmanWorkspace
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Website
Website
🔗
Documentation
Documentation
🔗
APIReference
APIReference
📰
Blog
Blog
👥
GitHubOrganization
GitHubOrganization
👥
GitHubRepository
GitHubRepository
📝
Signup
Signup
💰
Pricing
Pricing
🔗
Plans
Plans
🔗
RateLimits
RateLimits
🔗
FinOps
FinOps
📜
TermsOfService
TermsOfService
📜
PrivacyPolicy
PrivacyPolicy
💬
Support
Support
💬
FAQ
FAQ
📄
ReleaseNotes
ReleaseNotes
📄
ChangeLog
ChangeLog
🟢
StatusPage
StatusPage
🔗
Security
Security
🔗
Compliance
Compliance
📦
SDKs
SDKs
📦
SDKs
SDKs
📦
SDKs
SDKs
📦
SDKs
SDKs
🔗
CLI
CLI
🔗
CLI
CLI
👥
GitHubRepository
GitHubRepository
👥
GitHubRepository
GitHubRepository
👥
GitHubRepository
GitHubRepository
🔗
Resources
Resources
🔗
Hub
Hub
🔗
Forums
Forums
🔗
SpectralRules
SpectralRules
🔗
JSONLD
JSONLD
🔗
Vocabulary
Vocabulary

Sources

Raw ↑
opencollection: 1.0.0
info:
  name: Gitea API
  version: 1.27.0+dev-89-gf52b6f3315
request:
  auth:
    type: basic
    username: '{{username}}'
    password: '{{password}}'
items:
- info:
    name: admin
    type: folder
  items:
  - info:
      name: Lists All Jobs
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/admin/actions/jobs
      params:
      - name: status
        value: ''
        type: query
        description: workflow status (pending, queued, in_progress, failure, success, skipped)
      - name: page
        value: ''
        type: query
        description: page number of results to return (1-based)
      - name: limit
        value: ''
        type: query
        description: page size of results
    docs: Lists All Jobs
  - info:
      name: Get All Runners
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/admin/actions/runners
      params:
      - name: disabled
        value: ''
        type: query
        description: filter by disabled status (true or false)
    docs: Get All Runners
  - info:
      name: Get a Global Actions Runner Registration Token
      type: http
    http:
      method: POST
      url: https://gitea.com/api/v1/admin/actions/runners/registration-token
    docs: Get a Global Actions Runner Registration Token
  - info:
      name: Get a Global Runner
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/admin/actions/runners/:runner_id
      params:
      - name: runner_id
        value: ''
        type: path
        description: id of the runner
    docs: Get a Global Runner
  - info:
      name: Update a Global Runner
      type: http
    http:
      method: PATCH
      url: https://gitea.com/api/v1/admin/actions/runners/:runner_id
      params:
      - name: runner_id
        value: ''
        type: path
        description: id of the runner
      body:
        type: json
        data: '{}'
    docs: Update a Global Runner
  - info:
      name: Delete a Global Runner
      type: http
    http:
      method: DELETE
      url: https://gitea.com/api/v1/admin/actions/runners/:runner_id
      params:
      - name: runner_id
        value: ''
        type: path
        description: id of the runner
    docs: Delete a Global Runner
  - info:
      name: Lists All Runs
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/admin/actions/runs
      params:
      - name: event
        value: ''
        type: query
        description: workflow event name
      - name: branch
        value: ''
        type: query
        description: workflow branch
      - name: status
        value: ''
        type: query
        description: workflow status (pending, queued, in_progress, failure, success, skipped)
      - name: actor
        value: ''
        type: query
        description: triggered by user
      - name: head_sha
        value: ''
        type: query
        description: triggering sha of the workflow run
      - name: page
        value: ''
        type: query
        description: page number of results to return (1-based)
      - name: limit
        value: ''
        type: query
        description: page size of results
    docs: Lists All Runs
  - info:
      name: List Cron Tasks
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/admin/cron
      params:
      - name: page
        value: ''
        type: query
        description: page number of results to return (1-based)
      - name: limit
        value: ''
        type: query
        description: page size of results
    docs: List Cron Tasks
  - info:
      name: Run Cron Task
      type: http
    http:
      method: POST
      url: https://gitea.com/api/v1/admin/cron/:task
      params:
      - name: task
        value: ''
        type: path
        description: task to run
    docs: Run Cron Task
  - info:
      name: List All Emails
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/admin/emails
      params:
      - name: page
        value: ''
        type: query
        description: page number of results to return (1-based)
      - name: limit
        value: ''
        type: query
        description: page size of results
    docs: List All Emails
  - info:
      name: Search All Emails
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/admin/emails/search
      params:
      - name: q
        value: ''
        type: query
        description: keyword
      - name: page
        value: ''
        type: query
        description: page number of results to return (1-based)
      - name: limit
        value: ''
        type: query
        description: page size of results
    docs: Search All Emails
  - info:
      name: List System's Webhooks
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/admin/hooks
      params:
      - name: page
        value: ''
        type: query
        description: page number of results to return (1-based)
      - name: limit
        value: ''
        type: query
        description: page size of results
      - name: type
        value: ''
        type: query
        description: system, default or both kinds of webhooks
    docs: List System's Webhooks
  - info:
      name: Create a Hook
      type: http
    http:
      method: POST
      url: https://gitea.com/api/v1/admin/hooks
      body:
        type: json
        data: '{}'
    docs: Create a Hook
  - info:
      name: Get a Hook
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/admin/hooks/:id
      params:
      - name: id
        value: ''
        type: path
        description: id of the hook to get
    docs: Get a Hook
  - info:
      name: Update a Hook
      type: http
    http:
      method: PATCH
      url: https://gitea.com/api/v1/admin/hooks/:id
      params:
      - name: id
        value: ''
        type: path
        description: id of the hook to update
      body:
        type: json
        data: '{}'
    docs: Update a Hook
  - info:
      name: Delete a Hook
      type: http
    http:
      method: DELETE
      url: https://gitea.com/api/v1/admin/hooks/:id
      params:
      - name: id
        value: ''
        type: path
        description: id of the hook to delete
    docs: Delete a Hook
  - info:
      name: List All Organizations
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/admin/orgs
      params:
      - name: page
        value: ''
        type: query
        description: page number of results to return (1-based)
      - name: limit
        value: ''
        type: query
        description: page size of results
    docs: List All Organizations
  - info:
      name: List Unadopted Repositories
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/admin/unadopted
      params:
      - name: page
        value: ''
        type: query
        description: page number of results to return (1-based)
      - name: limit
        value: ''
        type: query
        description: page size of results
      - name: pattern
        value: ''
        type: query
        description: pattern of repositories to search for
    docs: List Unadopted Repositories
  - info:
      name: Adopt Unadopted Files as a Repository
      type: http
    http:
      method: POST
      url: https://gitea.com/api/v1/admin/unadopted/:owner/:repo
      params:
      - name: owner
        value: ''
        type: path
        description: owner of the repo
      - name: repo
        value: ''
        type: path
        description: name of the repo
    docs: Adopt Unadopted Files as a Repository
  - info:
      name: Delete Unadopted Files
      type: http
    http:
      method: DELETE
      url: https://gitea.com/api/v1/admin/unadopted/:owner/:repo
      params:
      - name: owner
        value: ''
        type: path
        description: owner of the repo
      - name: repo
        value: ''
        type: path
        description: name of the repo
    docs: Delete Unadopted Files
  - info:
      name: Search Users According Filter Conditions
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/admin/users
      params:
      - name: source_id
        value: ''
        type: query
        description: ID of the user's login source to search for
      - name: login_name
        value: ''
        type: query
        description: identifier of the user, provided by the external authenticator
      - name: page
        value: ''
        type: query
        description: page number of results to return (1-based)
      - name: limit
        value: ''
        type: query
        description: page size of results
      - name: sort
        value: ''
        type: query
        description: sort users by attribute. Supported values are "name", "created", "updated" and "id". Default is "name"
      - name: order
        value: ''
        type: query
        description: sort order, either "asc" (ascending) or "desc" (descending). Default is "asc", ignored if "sort" is not
          specified.
      - name: q
        value: ''
        type: query
        description: search term (username, full name, email)
      - name: visibility
        value: ''
        type: query
        description: visibility filter. Supported values are "public", "limited" and "private".
      - name: is_active
        value: ''
        type: query
        description: filter active users
      - name: is_admin
        value: ''
        type: query
        description: filter admin users
      - name: is_restricted
        value: ''
        type: query
        description: filter restricted users
      - name: is_2fa_enabled
        value: ''
        type: query
        description: filter 2FA enabled users
      - name: is_prohibit_login
        value: ''
        type: query
        description: filter login prohibited users
    docs: Search Users According Filter Conditions
  - info:
      name: Create a User
      type: http
    http:
      method: POST
      url: https://gitea.com/api/v1/admin/users
      body:
        type: json
        data: '{}'
    docs: Create a User
  - info:
      name: Edit an Existing User
      type: http
    http:
      method: PATCH
      url: https://gitea.com/api/v1/admin/users/:username
      params:
      - name: username
        value: ''
        type: path
        description: username of the user whose data is to be edited
      body:
        type: json
        data: '{}'
    docs: Edit an Existing User
  - info:
      name: Delete a User
      type: http
    http:
      method: DELETE
      url: https://gitea.com/api/v1/admin/users/:username
      params:
      - name: username
        value: ''
        type: path
        description: username of the user to delete
      - name: purge
        value: ''
        type: query
        description: purge the user from the system completely
    docs: Delete a User
  - info:
      name: List a User's Badges
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/admin/users/:username/badges
      params:
      - name: username
        value: ''
        type: path
        description: username of the user whose badges are to be listed
    docs: List a User's Badges
  - info:
      name: Add a Badge to a User
      type: http
    http:
      method: POST
      url: https://gitea.com/api/v1/admin/users/:username/badges
      params:
      - name: username
        value: ''
        type: path
        description: username of the user to whom a badge is to be added
      body:
        type: json
        data: '{}'
    docs: Add a Badge to a User
  - info:
      name: Remove a Badge from a User
      type: http
    http:
      method: DELETE
      url: https://gitea.com/api/v1/admin/users/:username/badges
      params:
      - name: username
        value: ''
        type: path
        description: username of the user whose badge is to be deleted
      body:
        type: json
        data: '{}'
    docs: Remove a Badge from a User
  - info:
      name: Add a Public Key on Behalf of a User
      type: http
    http:
      method: POST
      url: https://gitea.com/api/v1/admin/users/:username/keys
      params:
      - name: username
        value: ''
        type: path
        description: username of the user who is to receive a public key
      body:
        type: json
        data: '{}'
    docs: Add a Public Key on Behalf of a User
  - info:
      name: Delete a User's Public Key
      type: http
    http:
      method: DELETE
      url: https://gitea.com/api/v1/admin/users/:username/keys/:id
      params:
      - name: username
        value: ''
        type: path
        description: username of the user whose public key is to be deleted
      - name: id
        value: ''
        type: path
        description: id of the key to delete
    docs: Delete a User's Public Key
  - info:
      name: Create an Organization
      type: http
    http:
      method: POST
      url: https://gitea.com/api/v1/admin/users/:username/orgs
      params:
      - name: username
        value: ''
        type: path
        description: username of the user who will own the created organization
      body:
        type: json
        data: '{}'
    docs: Create an Organization
  - info:
      name: Rename a User
      type: http
    http:
      method: POST
      url: https://gitea.com/api/v1/admin/users/:username/rename
      params:
      - name: username
        value: ''
        type: path
        description: current username of the user
      body:
        type: json
        data: '{}'
    docs: Rename a User
  - info:
      name: Create a Repository on Behalf of a User
      type: http
    http:
      method: POST
      url: https://gitea.com/api/v1/admin/users/:username/repos
      params:
      - name: username
        value: ''
        type: path
        description: username of the user who will own the created repository
      body:
        type: json
        data: '{}'
    docs: Create a Repository on Behalf of a User
- info:
    name: miscellaneous
    type: folder
  items:
  - info:
      name: Returns a List of All Gitignore Templates
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/gitignore/templates
    docs: Returns a List of All Gitignore Templates
  - info:
      name: Returns Information About a Gitignore Template
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/gitignore/templates/:name
      params:
      - name: name
        value: ''
        type: path
        description: name of the template
    docs: Returns Information About a Gitignore Template
  - info:
      name: Returns a List of All Label Templates
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/label/templates
    docs: Returns a List of All Label Templates
  - info:
      name: Returns All Labels in a Template
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/label/templates/:name
      params:
      - name: name
        value: ''
        type: path
        description: name of the template
    docs: Returns All Labels in a Template
  - info:
      name: Returns a List of All License Templates
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/licenses
    docs: Returns a List of All License Templates
  - info:
      name: Returns Information About a License Template
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/licenses/:name
      params:
      - name: name
        value: ''
        type: path
        description: name of the license
    docs: Returns Information About a License Template
  - info:
      name: Render a Markdown Document as HTML
      type: http
    http:
      method: POST
      url: https://gitea.com/api/v1/markdown
      body:
        type: json
        data: '{}'
    docs: Render a Markdown Document as HTML
  - info:
      name: Render Raw Markdown as HTML
      type: http
    http:
      method: POST
      url: https://gitea.com/api/v1/markdown/raw
      body:
        type: json
        data: '{}'
    docs: Render Raw Markdown as HTML
  - info:
      name: Render a Markup Document as HTML
      type: http
    http:
      method: POST
      url: https://gitea.com/api/v1/markup
      body:
        type: json
        data: '{}'
    docs: Render a Markup Document as HTML
  - info:
      name: Get Default Signing-Key.gpg
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/signing-key.gpg
    docs: Get Default Signing-Key.gpg
  - info:
      name: Get Default Signing-Key.pub
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/signing-key.pub
    docs: Get Default Signing-Key.pub
  - info:
      name: Returns the Version of the Gitea Application
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/version
    docs: Returns the Version of the Gitea Application
- info:
    name: notification
    type: folder
  items:
  - info:
      name: List Users's Notification Threads
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/notifications
      params:
      - name: all
        value: ''
        type: query
        description: If true, show notifications marked as read. Default value is false
      - name: status-types
        value: ''
        type: query
        description: 'Show notifications with the provided status types. Options are: unread, read and/or pinned. Defaults
          to unread & pinned.'
      - name: subject-type
        value: ''
        type: query
        description: filter notifications by subject type
      - name: since
        value: ''
        type: query
        description: Only show notifications updated after the given time. This is a timestamp in RFC 3339 format
      - name: before
        value: ''
        type: query
        description: Only show notifications updated before the given time. This is a timestamp in RFC 3339 format
      - name: page
        value: ''
        type: query
        description: page number of results to return (1-based)
      - name: limit
        value: ''
        type: query
        description: page size of results
    docs: List Users's Notification Threads
  - info:
      name: Mark Notification Threads as Read, Pinned or Unread
      type: http
    http:
      method: PUT
      url: https://gitea.com/api/v1/notifications
      params:
      - name: last_read_at
        value: ''
        type: query
        description: Describes the last point that notifications were checked. Anything updated since this time will not be
          updated.
      - name: all
        value: ''
        type: query
        description: If true, mark all notifications on this repo. Default value is false
      - name: status-types
        value: ''
        type: query
        description: 'Mark notifications with the provided status types. Options are: unread, read and/or pinned. Defaults
          to unread.'
      - name: to-status
        value: ''
        type: query
        description: Status to mark notifications as, Defaults to read.
    docs: Mark Notification Threads as Read, Pinned or Unread
  - info:
      name: Check if Unread Notifications Exist
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/notifications/new
    docs: Check if Unread Notifications Exist
  - info:
      name: Get Notification Thread by ID
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/notifications/threads/:id
      params:
      - name: id
        value: ''
        type: path
        description: id of notification thread
    docs: Get Notification Thread by ID
  - info:
      name: Mark Notification Thread as Read by ID
      type: http
    http:
      method: PATCH
      url: https://gitea.com/api/v1/notifications/threads/:id
      params:
      - name: id
        value: ''
        type: path
        description: id of notification thread
      - name: to-status
        value: ''
        type: query
        description: Status to mark notifications as
    docs: Mark Notification Thread as Read by ID
  - info:
      name: List Users's Notification Threads on a Specific Repo
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/repos/:owner/:repo/notifications
      params:
      - name: owner
        value: ''
        type: path
        description: owner of the repo
      - name: repo
        value: ''
        type: path
        description: name of the repo
      - name: all
        value: ''
        type: query
        description: If true, show notifications marked as read. Default value is false
      - name: status-types
        value: ''
        type: query
        description: 'Show notifications with the provided status types. Options are: unread, read and/or pinned. Defaults
          to unread & pinned'
      - name: subject-type
        value: ''
        type: query
        description: filter notifications by subject type
      - name: since
        value: ''
        type: query
        description: Only show notifications updated after the given time. This is a timestamp in RFC 3339 format
      - name: before
        value: ''
        type: query
        description: Only show notifications updated before the given time. This is a timestamp in RFC 3339 format
      - name: page
        value: ''
        type: query
        description: page number of results to return (1-based)
      - name: limit
        value: ''
        type: query
        description: page size of results
    docs: List Users's Notification Threads on a Specific Repo
  - info:
      name: Mark Notification Threads as Read, Pinned or Unread on a Specific Repo
      type: http
    http:
      method: PUT
      url: https://gitea.com/api/v1/repos/:owner/:repo/notifications
      params:
      - name: owner
        value: ''
        type: path
        description: owner of the repo
      - name: repo
        value: ''
        type: path
        description: name of the repo
      - name: all
        value: ''
        type: query
        description: If true, mark all notifications on this repo. Default value is false
      - name: status-types
        value: ''
        type: query
        description: 'Mark notifications with the provided status types. Options are: unread, read and/or pinned. Defaults
          to unread.'
      - name: to-status
        value: ''
        type: query
        description: Status to mark notifications as. Defaults to read.
      - name: last_read_at
        value: ''
        type: query
        description: Describes the last point that notifications were checked. Anything updated since this time will not be
          updated.
    docs: Mark Notification Threads as Read, Pinned or Unread on a Specific Repo
- info:
    name: organization
    type: folder
  items:
  - info:
      name: Create a Repository in an Organization
      type: http
    http:
      method: POST
      url: https://gitea.com/api/v1/org/:org/repos
      params:
      - name: org
        value: ''
        type: path
        description: name of organization
      body:
        type: json
        data: '{}'
    docs: Create a Repository in an Organization
  - info:
      name: Get List of Organizations
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/orgs
      params:
      - name: page
        value: ''
        type: query
        description: page number of results to return (1-based)
      - name: limit
        value: ''
        type: query
        description: page size of results
    docs: Get List of Organizations
  - info:
      name: Create an Organization
      type: http
    http:
      method: POST
      url: https://gitea.com/api/v1/orgs
      body:
        type: json
        data: '{}'
    docs: Create an Organization
  - info:
      name: Get an Organization
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/orgs/:org
      params:
      - name: org
        value: ''
        type: path
        description: name of the organization to get
    docs: Get an Organization
  - info:
      name: Edit an Organization
      type: http
    http:
      method: PATCH
      url: https://gitea.com/api/v1/orgs/:org
      params:
      - name: org
        value: ''
        type: path
        description: name of the organization to edit
      body:
        type: json
        data: '{}'
    docs: Edit an Organization
  - info:
      name: Delete an Organization
      type: http
    http:
      method: DELETE
      url: https://gitea.com/api/v1/orgs/:org
      params:
      - name: org
        value: ''
        type: path
        description: organization that is to be deleted
    docs: Delete an Organization
  - info:
      name: Get Org-Level Workflow Jobs
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/orgs/:org/actions/jobs
      params:
      - name: org
        value: ''
        type: path
        description: name of the organization
      - name: status
        value: ''
        type: query
        description: workflow status (pending, queued, in_progress, failure, success, skipped)
      - name: page
        value: ''
        type: query
        description: page number of results to return (1-based)
      - name: limit
        value: ''
        type: query
        description: page size of results
    docs: Get Org-Level Workflow Jobs
  - info:
      name: Get Org-Level Runners
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/orgs/:org/actions/runners
      params:
      - name: org
        value: ''
        type: path
        description: name of the organization
      - name: disabled
        value: ''
        type: query
        description: filter by disabled status (true or false)
    docs: Get Org-Level Runners
  - info:
      name: Get an Organization's Actions Runner Registration Token
      type: http
    http:
      method: POST
      url: https://gitea.com/api/v1/orgs/:org/actions/runners/registration-token
      params:
      - name: org
        value: ''
        type: path
        description: name of the organization
    docs: Get an Organization's Actions Runner Registration Token
  - info:
      name: Get an Org-Level Runner
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/orgs/:org/actions/runners/:runner_id
      params:
      - name: org
        value: ''
        type: path
        description: name of the organization
      - name: runner_id
        value: ''
        type: path
        description: id of the runner
    docs: Get an Org-Level Runner
  - info:
      name: Update an Org-Level Runner
      type: http
    http:
      method: PATCH
      url: https://gitea.com/api/v1/orgs/:org/actions/runners/:runner_id
      params:
      - name: org
        value: ''
        type: path
        description: name of the organization
      - name: runner_id
        value: ''
        type: path
        description: id of the runner
      body:
        type: json
        data: '{}'
    docs: Update an Org-Level Runner
  - info:
      name: Delete an Org-Level Runner
      type: http
    http:
      method: DELETE
      url: https://gitea.com/api/v1/orgs/:org/actions/runners/:runner_id
      params:
      - name: org
        value: ''
        type: path
        description: name of the organization
      - name: runner_id
        value: ''
        type: path
        description: id of the runner
    docs: Delete an Org-Level Runner
  - info:
      name: Get Org-Level Workflow Runs
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/orgs/:org/actions/runs
      params:
      - name: org
        value: ''
        type: path
        description: name of the organization
      - name: event
        value: ''
        type: query
        description: workflow event name
      - name: branch
        value: ''
        type: query
        description: workflow branch
      - name: status
        value: ''
        type: query
        description: workflow status (pending, queued, in_progress, failure, success, skipped)
      - name: actor
        value: ''
        type: query
        description: triggered by user
      - name: head_sha
        value: ''
        type: query
        description: triggering sha of the workflow run
      - name: page
        value: ''
        type: query
        description: page number of results to return (1-based)
      - name: limit
        value: ''
        type: query
        description: page size of results
    docs: Get Org-Level Workflow Runs
  - info:
      name: List an Organization's Actions Secrets
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/orgs/:org/actions/secrets
      params:
      - name: org
        value: ''
        type: path
        description: name of the organization
      - name: page
        value: ''
        type: query
        description: page number of results to return (1-based)
      - name: limit
        value: ''
        type: query
        description: page size of results
    docs: List an Organization's Actions Secrets
  - info:
      name: Create or Update a Secret Value in an Organization
      type: http
    http:
      method: PUT
      url: https://gitea.com/api/v1/orgs/:org/actions/secrets/:secretname
      params:
      - name: org
        value: ''
        type: path
        description: name of organization
      - name: secretname
        value: ''
        type: path
        description: name of the secret
      body:
        type: json
        data: '{}'
    docs: Create or Update a Secret Value in an Organization
  - info:
      name: Delete a Secret in an Organization
      type: http
    http:
      method: DELETE
      url: https://gitea.com/api/v1/orgs/:org/actions/secrets/:secretname
      params:
      - name: org
        value: ''
        type: path
        description: name of organization
      - name: secretname
        value: ''
        type: path
        description: name of the secret
    docs: Delete a Secret in an Organization
  - info:
      name: Get an Org-Level Variables List
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/orgs/:org/actions/variables
      params:
      - name: org
        value: ''
        type: path
        description: name of the organization
      - name: page
        value: ''
        type: query
        description: page number of results to return (1-based)
      - name: limit
        value: ''
        type: query
        description: page size of results
    docs: Get an Org-Level Variables List
  - info:
      name: Get an Org-Level Variable
      type: http
    http:
      method: GET
      url: https://gitea.com/api/v1/orgs/:org/actions/variables/:variablename
      params:
      - name: org
        value: ''
        type: path
        description: name of the organization
      - name: variablename
        value: ''
        type: path
        description: name of the variable
    docs: Get an Org-Level Variable
  - info:
      name: Create an Org-Level Variable
      type: http
    http:
      method: POST
      url: https://gitea.com/api/v1/orgs/:org/actions/variables/:variablename
      params:
      - name: org
        value: ''
        type: path
        description: name of the organization
      - name: variablename
        value: ''
        type: path
        description: name of the variable
      body:
        type: json
        data: '{}'
    docs: Create an Org-Level Variable
  - info:
      name: Update an Org-Level Variable
      type: http
    http:
      method: PUT
      url: https://gitea.com/api/v1/orgs/:org/actions/variables/:variablename
      params:
      - name: org
        value: ''
        type: path
        description: name of the organization
      - name: variablename
        value: ''
        type: path
        description: name of the variable
      body:
        type: json
        data: '{}'
    docs: Update an Org-Level Variable
  - info:
      name: Delete an Org-Level Variable
      type: http
    http:
      method: DELETE
      url: https://gitea.com/api/v1/orgs/:org/actions/variables/:variablename
      params:
      - name: org
        value: ''
        type: path
        description: name of the organization
      - name: variablename
        value: ''
        type: path
        description: name of the varia

# --- truncated at 32 KB (248 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/apis.yml