Prowl
0/100
prowl
Benchmarked Sep 15, 2026

Gitea API.

This documentation describes the Gitea API.

api platform_profile
Benchmark Your API

Benchmark Analysis Log

Full LLM thinking from the 4-phase benchmark pipeline.

Analyze
{
  "service_type": "platform",
  "base_url": "https://gitea.io",
  "auth_method": "api_key",
  "auth_config": {
    "header": "Authorization",
    "format": "token <token>",
    "note": "Gitea supports multiple authentication methods including Basic Auth, token (OAuth2 access tokens or personal access tokens), and OAuth2. API tokens can be created in the user settings. Query parameter 'token' is also supported for some endpoints but discouraged.",
    "alternative": {
      "basic_auth": {
        "username": "string",
        "password": "string"
      },
      "oauth2": {
        "authorization_url": "https://gitea.io/login/oauth/authorize",
        "token_url": "https://gitea.io/login/oauth/access_token"
      }
    }
  },
  "endpoints": [
    {
      "path": "/api/v1/version",
      "method": "GET",
      "description": "Returns the version of the Gitea server along with the API version."
    },
    {
      "path": "/api/v1/user",
      "method": "GET",
      "description": "Get the authenticated user's information."
    },
    {
      "path": "/api/v1/users/{username}",
      "method": "GET",
      "description": "Get a user's information by username."
    },
    {
      "path": "/api/v1/repos/{owner}/{repo}",
      "method": "GET",
      "description": "Get a repository by owner and name."
    },
    {
      "path": "/api/v1/repos/search",
      "method": "GET",
      "description": "Search for repositories. Supports query parameters like q, topic, includeDesc, etc."
    },
    {
      "path": "/api/v1/repos/{owner}/{repo}/issues",
      "method": "GET",
      "description": "List issues in a repository. Supports filtering by state, labels, milestones, etc."
    },
    {
      "path": "/api/v1/repos/{owner}/{repo}/issues",
      "method": "POST",
      "description": "Create an issue in a repository."
    },
    {
      "path": "/api/v1/repos/{owner}/{repo}/pulls",
      "method": "GET",
      "description": "List pull requests in a repository."
    },
    {
      "path": "/api/v1/repos/{owner}/{repo}/pulls",
      "method": "POST",
      "description": "Create a pull request."
    },
    {
      "path": "/api/v1/repos/{owner}/{repo}/branches",
      "method": "GET",
      "description": "List branches in a repository."
    },
    {
      "path": "/api/v1/repos/{owner}/{repo}/contents/{filepath}",
      "method": "GET",
      "description": "Get file contents from a repository at a specific path."
    },
    {
      "path": "/api/v1/repos/{owner}/{repo}/contents/{filepath}",
      "method": "PUT",
      "description": "Create or update a file in a repository."
    },
    {
      "path": "/api/v1/orgs/{org}",
      "method": "GET",
      "description": "Get an organization's information."
    },
    {
      "path": "/api/v1/orgs/{org}/repos",
      "method": "GET",
      "description": "List an organization's repositories."
    },
    {
      "path": "/api/v1/admin/users",
      "method": "GET",
      "description": "List all users (admin only)."
    },
    {
      "path": "/api/v1/settings/api",
      "method": "GET",
      "description": "Get global API settings (admin only)."
    }
  ],
  "pricing_model": {
    "type": "free",
    "details": {
      "note": "Gitea is open source software (MIT license) and free to self-host. There is also a managed cloud offering called Gitea Cloud with subscription pricing. The API itself has no additional cost beyond hosting or subscription."
    }
  },
  "rate_limits": {
    "default": "No hard rate limits are enforced by default; administrators can configure rate limiting via the Gitea configuration file (app.ini) under [service] and [security] sections.",
    "configurable": true
  },
  "capabilities": [
    "Git repository hosting and management (create, fork, mirror, etc.)",
    "User and organization management",
    "Issue tracking (create, list, update, comment)",
    "Pull request management",
    "Repository content manipulation (files, branches, commits)",
    "Webhooks for event notifications",
    "OAuth2 and personal access token authentication",
    "Admin API for instance management",
    "Collaboration features: teams, permissions, labels, milestones",
    "CI/CD integration via webhooks and API",
    "Search for repositories, users, issues"
  ],
  "raw_analysis": "Gitea is a lightweight, self-hosted Git service written in Go. It provides a comprehensive REST API that covers nearly all interactions available through the web UI. The API is versioned under /api/v1 and uses JSON for requests and responses. Authentication typically uses personal access tokens or OAuth2 tokens, passed via the 'Authorization: token <token>' header. Basic authentication is also supported. The API is well-documented with Swagger (OpenAPI) specifications available at /api/v1/swagger or via the /swagger endpoint on a running instance.\n\nKey use cases include automating repository operations, managing users and organizations, integrating with external issue trackers or CI/C
Execute

2/3 tests passed

TestEndpointStatusLatency
website_uptimeGET /200465ms
robots_txtGET /robots.txt20094ms
llms_txtGET /llms.txt404103ms

Agent Readiness

x402 Payments
Not supported
Streaming
No
Sandbox
None
Agent Auth
Unknown
SDKs
None listed
MCP Support
No

Embed your Prowl badge

Show your live agent-readiness score on your own site. Free, no auth — it updates as your score changes.

Prowl agent-readiness badge
<a href="https://prowl.world/service/gitea-api">
  <img src="https://prowl.world/badge/gitea-api.svg" height="56" alt="Agent-readiness on Prowl">
</a>

Options: ?style=light|dark · ?size=sm|md · ?variant=certified (claimed + DNS-verified only) · badge generator with preview

Want the full interactive view?

See operational metrics, LLM evaluations, agent readiness, and more.

Open in Dashboard