Gitea Miscellaneous API

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: 29.0.0+dev-153-gba4f8fa246
servers:
- url: /api/v1
security:
- BasicAuth: []
- Token: []
- AccessToken: []
- AuthorizationHeaderToken: []
- SudoParam: []
- SudoHeader: []
- TOTPHeader: []
tags:
- description: Miscellaneous endpoints
  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
  /token:
    get:
      tags:
      - Miscellaneous
      summary: Get the currently authenticated token
      operationId: getCurrentToken
      responses:
        '200':
          $ref: '#/components/responses/CurrentAccessToken'
    delete:
      tags:
      - Miscellaneous
      summary: Delete the currently authenticated token
      operationId: deleteCurrentToken
      responses:
        '204':
          description: token deleted
  /version:
    get:
      tags:
      - Miscellaneous
      summary: Returns the version of the Gitea application
      operationId: getVersion
      responses:
        '200':
          $ref: '#/components/responses/ServerVersion'
components:
  responses:
    CurrentAccessToken:
      description: CurrentAccessToken represents the currently authenticated access token.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/CurrentAccessToken'
    MarkupRender:
      description: MarkupRender is a rendered markup 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
    LabelTemplateList:
      description: LabelTemplateList
      content:
        application/json:
          schema:
            type: array
            items:
              type: string
    ServerVersion:
      description: ServerVersion
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ServerVersion'
    LabelTemplateInfo:
      description: LabelTemplateInfo
      content:
        application/json:
          schema:
            type: array
            items:
              $ref: '#/components/schemas/LabelTemplate'
    LicenseTemplateInfo:
      description: LicenseTemplateInfo
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/LicenseTemplateInfo'
    MarkdownRender:
      description: MarkdownRender is a rendered markdown document
      content:
        application/json:
          schema:
            type: string
    GitignoreTemplateInfo:
      description: GitignoreTemplateInfo
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GitignoreTemplateInfo'
    notFound:
      description: APINotFound is a not found empty response
    LicenseTemplateList:
      description: LicenseTemplateList
      content:
        application/json:
          schema:
            type: array
            items:
              $ref: '#/components/schemas/LicensesTemplateListEntry'
    GitignoreTemplateList:
      description: GitignoreTemplateList
      content:
        application/json:
          schema:
            type: array
            items:
              type: string
  schemas:
    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}'
          type: string
        Mode:
          description: Mode to render (markdown, comment, wiki, file)
          type: string
        Text:
          description: Text markdown to render
          type: string
        Wiki:
          description: Is it a wiki page? (use mode=wiki instead)
          type: boolean
          x-deprecated: true
      x-go-package: gitea.dev/modules/structs
    CurrentAccessToken:
      type: object
      title: CurrentAccessToken represents the metadata of the currently authenticated token.
      properties:
        created_at:
          description: The timestamp when the token was created
          type: string
          format: date-time
          x-go-name: CreatedAt
        id:
          description: The unique identifier of the access token
          type: integer
          format: int64
          x-go-name: ID
        last_used_at:
          description: The timestamp when the token was last used
          type: string
          format: date-time
          x-go-name: LastUsedAt
        name:
          description: The name of the access token
          type: string
          x-go-name: Name
        scopes:
          description: The scopes granted to this access token
          type: array
          items:
            type: string
          x-go-name: Scopes
        user:
          $ref: '#/components/schemas/UserMeta'
      x-go-package: gitea.dev/modules/structs
    UserMeta:
      type: object
      title: UserMeta represents minimal user information for the token owner.
      properties:
        id:
          description: The unique identifier of the user
          type: integer
          format: int64
          x-go-name: ID
        login:
          description: The username of the user
          type: string
          x-go-name: Login
      x-go-package: gitea.dev/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: gitea.dev/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: gitea.dev/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: gitea.dev/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: gitea.dev/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}'
          type: string
        FilePath:
          description: File path for detecting extension in file mode
          type: string
        Mode:
          description: Mode to render (markdown, comment, wiki, file)
          type: string
        Text:
          description: Text markup to render
          type: string
        Wiki:
          description: Is it a wiki page? (use mode=wiki instead)
          type: boolean
          x-deprecated: true
      x-go-package: gitea.dev/modules/structs
    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: gitea.dev/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