Gitea

Gitea Miscellaneous API

The miscellaneous API from Gitea — 12 operation(s) for miscellaneous.

Documentation GitHub OpenAPI

Operations 12

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /gitignore/templates List available .gitignore templates · Returns a list of all gitignore templates #

Ask an LLM

“Which .gitignore templates can I pick from when creating a repo?”

“Is there a Python or Node .gitignore template available on this server?”

Tell an agent

List all the .gitignore templates.

Show me the available gitignore template names.

GET /gitignore/templates/{name} Get a .gitignore template's contents · Returns information about a gitignore template #

Ask an LLM

“What does a particular .gitignore template actually contain?”

“Can I preview a gitignore template before using it?”

Tell an agent

Show the contents of the {name} gitignore template.

Get the {name} .gitignore template.

GET /label/templates List available issue label templates · Returns a list of all label templates #

Ask an LLM

“Which issue label sets can I seed a new repository with?”

“What label templates does this Gitea instance offer?”

Tell an agent

List all issue label templates.

Show me the label template names I can use.

GET /label/templates/{name} Get the labels in a label template · Returns all labels in a template #

Ask an LLM

“What labels and colors come in a given label template?”

“Can I see every label a template would create?”

Tell an agent

Show the labels in the {name} label template.

List the label names and colors in template {name}.

GET /licenses List available license templates · Returns a list of all license templates #

Ask an LLM

“Which open source licenses can I choose when creating a repository?”

“Is MIT or Apache-2.0 available as a license template?”

Tell an agent

List all license templates.

Show the license keys I can pick for a new repo.

GET /licenses/{name} Get a license template's text · Returns information about a license template #

Ask an LLM

“What's the full text of a given license template?”

“Can I fetch a license's body to drop into my LICENSE file?”

Tell an agent

Show the text of the {name} license template.

Get license template {name}.

POST /markdown Render Markdown to HTML · Render a markdown document as HTML #

Ask an LLM

“How do I preview Markdown as HTML the way Gitea displays it?”

“Can links in rendered Markdown resolve against a specific repo or wiki context?”

Tell an agent

Render this Markdown as HTML: {Text}.

Render {Text} in {Mode} mode using repo context {Context}.

POST /markdown/raw Render a raw Markdown body to HTML · Render raw markdown as HTML #

Ask an LLM

“Can I send plain Markdown text as the request body and get HTML back?”

“Is there a raw Markdown renderer that doesn't need a JSON wrapper?”

Tell an agent

Render this raw Markdown body to HTML without any JSON options.

Convert my plain-text Markdown file to HTML using the raw endpoint.

POST /markup Render a markup file to HTML · Render a markup document as HTML #

Ask an LLM

“How do I render non-Markdown markup like Org or AsciiDoc to HTML?”

“Can the renderer pick the markup type from a file path?”

Tell an agent

Render {Text} as HTML treating it as file {FilePath}.

Render markup {Text} for file {FilePath} in {Mode} mode with context {Context}.

GET /signing-key.gpg Get the instance GPG signing key · Get default signing-key.gpg #

Ask an LLM

“What GPG key does this Gitea server use to sign commits it creates?”

“Where can I download the server's signing-key.gpg to trust its commits?”

Tell an agent

Download the instance's default GPG signing key.

Get the server's signing-key.gpg.

GET /signing-key.pub Get the instance SSH signing key · Get default signing-key.pub #

Ask an LLM

“Which SSH public key does the server sign commits with?”

“Can I fetch signing-key.pub to verify SSH-signed commits from Gitea?”

Tell an agent

Download the instance's default SSH signing key.

Get the server's signing-key.pub.

GET /version Get the Gitea server version · Returns the version of the Gitea application #

Ask an LLM

“What version of Gitea is this server running?”

“Is this instance on a recent enough release for a feature I need?”

Tell an agent

Tell me the Gitea version of this server.

Check which Gitea release the instance is running.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/gitea:gitea-miscellaneous-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  description: This documentation describes the Gitea API.
  title: Gitea Miscellaneous API
  license:
    name: MIT
    url: http://opensource.org/licenses/MIT
  version: 1.27.0+dev-89-gf52b6f3315
servers:
- url: /api/v1
security:
- BasicAuth: []
- Token: []
- AccessToken: []
- AuthorizationHeaderToken: []
- SudoParam: []
- SudoHeader: []
- TOTPHeader: []
tags:
- name: Miscellaneous
paths:
  /gitignore/templates:
    get:
      tags:
      - Miscellaneous
      summary: Returns a list of all gitignore templates
      operationId: listGitignoresTemplates
      responses:
        '200':
          $ref: '#/components/responses/GitignoreTemplateList'
  /gitignore/templates/{name}:
    get:
      tags:
      - Miscellaneous
      summary: Returns information about a gitignore template
      operationId: getGitignoreTemplateInfo
      parameters:
      - description: name of the template
        name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/GitignoreTemplateInfo'
        '404':
          $ref: '#/components/responses/notFound'
  /label/templates:
    get:
      tags:
      - Miscellaneous
      summary: Returns a list of all label templates
      operationId: listLabelTemplates
      responses:
        '200':
          $ref: '#/components/responses/LabelTemplateList'
  /label/templates/{name}:
    get:
      tags:
      - Miscellaneous
      summary: Returns all labels in a template
      operationId: getLabelTemplateInfo
      parameters:
      - description: name of the template
        name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/LabelTemplateInfo'
        '404':
          $ref: '#/components/responses/notFound'
  /licenses:
    get:
      tags:
      - Miscellaneous
      summary: Returns a list of all license templates
      operationId: listLicenseTemplates
      responses:
        '200':
          $ref: '#/components/responses/LicenseTemplateList'
  /licenses/{name}:
    get:
      tags:
      - Miscellaneous
      summary: Returns information about a license template
      operationId: getLicenseTemplateInfo
      parameters:
      - description: name of the license
        name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/LicenseTemplateInfo'
        '404':
          $ref: '#/components/responses/notFound'
  /markdown:
    post:
      tags:
      - Miscellaneous
      summary: Render a markdown document as HTML
      operationId: renderMarkdown
      responses:
        '200':
          $ref: '#/components/responses/MarkdownRender'
        '422':
          $ref: '#/components/responses/validationError'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MarkdownOption'
  /markdown/raw:
    post:
      tags:
      - Miscellaneous
      summary: Render raw markdown as HTML
      operationId: renderMarkdownRaw
      responses:
        '200':
          $ref: '#/components/responses/MarkdownRender'
        '422':
          $ref: '#/components/responses/validationError'
      requestBody:
        content:
          text/plain:
            schema:
              type: string
        description: Request body to render
        required: true
  /markup:
    post:
      tags:
      - Miscellaneous
      summary: Render a markup document as HTML
      operationId: renderMarkup
      responses:
        '200':
          $ref: '#/components/responses/MarkupRender'
        '422':
          $ref: '#/components/responses/validationError'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MarkupOption'
  /signing-key.gpg:
    get:
      tags:
      - Miscellaneous
      summary: Get default signing-key.gpg
      operationId: getSigningKey
      responses:
        '200':
          description: GPG armored public key
          content:
            text/plain:
              schema:
                type: string
  /signing-key.pub:
    get:
      tags:
      - Miscellaneous
      summary: Get default signing-key.pub
      operationId: getSigningKeySSH
      responses:
        '200':
          description: ssh public key
          content:
            text/plain:
              schema:
                type: string
  /version:
    get:
      tags:
      - Miscellaneous
      summary: Returns the version of the Gitea application
      operationId: getVersion
      responses:
        '200':
          $ref: '#/components/responses/ServerVersion'
components:
  responses:
    MarkupRender:
      description: MarkupRender is a rendered markup document
      content:
        application/json:
          schema:
            type: string
    ServerVersion:
      description: ServerVersion
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ServerVersion'
    notFound:
      description: APINotFound is a not found empty response
    MarkdownRender:
      description: MarkdownRender is a rendered markdown document
      content:
        application/json:
          schema:
            type: string
    validationError:
      description: APIValidationError is error format response related to input validation
      headers:
        message:
          schema:
            type: string
        url:
          schema:
            type: string
    GitignoreTemplateInfo:
      description: GitignoreTemplateInfo
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GitignoreTemplateInfo'
    LicenseTemplateInfo:
      description: LicenseTemplateInfo
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/LicenseTemplateInfo'
    GitignoreTemplateList:
      description: GitignoreTemplateList
      content:
        application/json:
          schema:
            type: array
            items:
              type: string
    LabelTemplateInfo:
      description: LabelTemplateInfo
      content:
        application/json:
          schema:
            type: array
            items:
              $ref: '#/components/schemas/LabelTemplate'
    LicenseTemplateList:
      description: LicenseTemplateList
      content:
        application/json:
          schema:
            type: array
            items:
              $ref: '#/components/schemas/LicensesTemplateListEntry'
    LabelTemplateList:
      description: LabelTemplateList
      content:
        application/json:
          schema:
            type: array
            items:
              type: string
  schemas:
    GitignoreTemplateInfo:
      description: GitignoreTemplateInfo name and text of a gitignore template
      type: object
      properties:
        name:
          description: Name is the name of the gitignore template
          type: string
          x-go-name: Name
        source:
          description: Source contains the content of the gitignore template
          type: string
          x-go-name: Source
      x-go-package: code.gitea.io/gitea/modules/structs
    LicensesTemplateListEntry:
      description: LicensesListEntry is used for the API
      type: object
      properties:
        key:
          description: Key is the unique identifier for the license template
          type: string
          x-go-name: Key
        name:
          description: Name is the display name of the license
          type: string
          x-go-name: Name
        url:
          description: URL is the reference URL for the license
          type: string
          x-go-name: URL
      x-go-package: code.gitea.io/gitea/modules/structs
    MarkdownOption:
      description: MarkdownOption markdown options
      type: object
      properties:
        Context:
          description: 'URL path for rendering issue, media and file links

            Expected format: /subpath/{user}/{repo}/src/{branch, commit, tag}/{identifier/path}/{file/dir}


            in: body'
          type: string
        Mode:
          description: 'Mode to render (markdown, comment, wiki, file)


            in: body'
          type: string
        Text:
          description: 'Text markdown to render


            in: body'
          type: string
        Wiki:
          description: 'Is it a wiki page? (use mode=wiki instead)


            Deprecated: true

            in: body'
          type: boolean
      x-go-package: code.gitea.io/gitea/modules/structs
    ServerVersion:
      description: ServerVersion wraps the version of the server
      type: object
      properties:
        version:
          description: Version is the server version string
          type: string
          x-go-name: Version
      x-go-package: code.gitea.io/gitea/modules/structs
    MarkupOption:
      description: MarkupOption markup options
      type: object
      properties:
        Context:
          description: 'URL path for rendering issue, media and file links

            Expected format: /subpath/{user}/{repo}/src/{branch, commit, tag}/{identifier/path}/{file/dir}


            in: body'
          type: string
        FilePath:
          description: 'File path for detecting extension in file mode


            in: body'
          type: string
        Mode:
          description: 'Mode to render (markdown, comment, wiki, file)


            in: body'
          type: string
        Text:
          description: 'Text markup to render


            in: body'
          type: string
        Wiki:
          description: 'Is it a wiki page? (use mode=wiki instead)


            Deprecated: true

            in: body'
          type: boolean
      x-go-package: code.gitea.io/gitea/modules/structs
    LicenseTemplateInfo:
      description: LicensesInfo contains information about a License
      type: object
      properties:
        body:
          description: Body contains the full text of the license
          type: string
          x-go-name: Body
        implementation:
          description: Implementation contains license implementation details
          type: string
          x-go-name: Implementation
        key:
          description: Key is the unique identifier for the license template
          type: string
          x-go-name: Key
        name:
          description: Name is the display name of the license
          type: string
          x-go-name: Name
        url:
          description: URL is the reference URL for the license
          type: string
          x-go-name: URL
      x-go-package: code.gitea.io/gitea/modules/structs
    LabelTemplate:
      description: LabelTemplate info of a Label template
      type: object
      properties:
        color:
          type: string
          x-go-name: Color
          example: 00aabb
        description:
          description: Description provides additional context about the label template's purpose
          type: string
          x-go-name: Description
        exclusive:
          type: boolean
          x-go-name: Exclusive
          example: false
        name:
          description: Name is the display name of the label template
          type: string
          x-go-name: Name
      x-go-package: code.gitea.io/gitea/modules/structs
  securitySchemes:
    AccessToken:
      description: This authentication option is deprecated for removal in Gitea 1.23. Please use AuthorizationHeaderToken instead.
      type: apiKey
      name: access_token
      in: query
    AuthorizationHeaderToken:
      description: API tokens must be prepended with "token" followed by a space.
      type: apiKey
      name: Authorization
      in: header
    BasicAuth:
      type: http
      scheme: basic
    SudoHeader:
      description: Sudo API request as the user provided as the key. Admin privileges are required.
      type: apiKey
      name: Sudo
      in: header
    SudoParam:
      description: Sudo API request as the user provided as the key. Admin privileges are required.
      type: apiKey
      name: sudo
      in: query
    TOTPHeader:
      description: Must be used in combination with BasicAuth if two-factor authentication is enabled.
      type: apiKey
      name: X-GITEA-OTP
      in: header
    Token:
      description: This authentication option is deprecated for removal in Gitea 1.23. Please use AuthorizationHeaderToken instead.
      type: apiKey
      name: token
      in: query

Gitea Miscellaneous API

Operations 12

Documentation

Specifications

Code Examples

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification