Gitea API — miscellaneous

naftiko: 1.0.0-alpha2
info:
  label: Gitea API — miscellaneous
  description: 'Gitea API — miscellaneous. 12 operations. Lead operation: Returns a List of All Gitignore Templates. Self-contained
    Naftiko capability covering one Gitea business surface.'
  tags:
  - Gitea
  - miscellaneous
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    GITEA_API_KEY: GITEA_API_KEY
capability:
  consumes:
  - type: http
    namespace: rest-miscellaneous
    baseUri: https://gitea.com/api/v1
    description: Gitea API — miscellaneous business capability. Self-contained, no shared references.
    resources:
    - name: gitignore-templates
      path: /gitignore/templates
      operations:
      - name: listgitignorestemplates
        method: GET
        description: Returns a List of All Gitignore Templates
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: gitignore-templates-name
      path: /gitignore/templates/{name}
      operations:
      - name: getgitignoretemplateinfo
        method: GET
        description: Returns Information About a Gitignore Template
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: name
          in: path
          type: string
          description: name of the template
          required: true
    - name: label-templates
      path: /label/templates
      operations:
      - name: listlabeltemplates
        method: GET
        description: Returns a List of All Label Templates
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: label-templates-name
      path: /label/templates/{name}
      operations:
      - name: getlabeltemplateinfo
        method: GET
        description: Returns All Labels in a Template
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: name
          in: path
          type: string
          description: name of the template
          required: true
    - name: licenses
      path: /licenses
      operations:
      - name: listlicensetemplates
        method: GET
        description: Returns a List of All License Templates
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: licenses-name
      path: /licenses/{name}
      operations:
      - name: getlicensetemplateinfo
        method: GET
        description: Returns Information About a License Template
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: name
          in: path
          type: string
          description: name of the license
          required: true
    - name: markdown
      path: /markdown
      operations:
      - name: rendermarkdown
        method: POST
        description: Render a Markdown Document as HTML
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: markdown-raw
      path: /markdown/raw
      operations:
      - name: rendermarkdownraw
        method: POST
        description: Render Raw Markdown as HTML
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: markup
      path: /markup
      operations:
      - name: rendermarkup
        method: POST
        description: Render a Markup Document as HTML
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: signing-key.gpg
      path: /signing-key.gpg
      operations:
      - name: getsigningkey
        method: GET
        description: Get Default Signing-Key.gpg
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: signing-key.pub
      path: /signing-key.pub
      operations:
      - name: getsigningkeyssh
        method: GET
        description: Get Default Signing-Key.pub
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: version
      path: /version
      operations:
      - name: getversion
        method: GET
        description: Returns the Version of the Gitea Application
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: apikey
      key: access_token
      value: '{{env.GITEA_API_KEY}}'
      placement: query
  exposes:
  - type: rest
    namespace: rest-miscellaneous-rest
    port: 8080
    description: REST adapter for Gitea API — miscellaneous. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/gitignore/templates
      name: gitignore-templates
      description: REST surface for gitignore-templates.
      operations:
      - method: GET
        name: listgitignorestemplates
        description: Returns a List of All Gitignore Templates
        call: rest-miscellaneous.listgitignorestemplates
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/gitignore/templates/{name}
      name: gitignore-templates-name
      description: REST surface for gitignore-templates-name.
      operations:
      - method: GET
        name: getgitignoretemplateinfo
        description: Returns Information About a Gitignore Template
        call: rest-miscellaneous.getgitignoretemplateinfo
        with:
          name: rest.name
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/label/templates
      name: label-templates
      description: REST surface for label-templates.
      operations:
      - method: GET
        name: listlabeltemplates
        description: Returns a List of All Label Templates
        call: rest-miscellaneous.listlabeltemplates
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/label/templates/{name}
      name: label-templates-name
      description: REST surface for label-templates-name.
      operations:
      - method: GET
        name: getlabeltemplateinfo
        description: Returns All Labels in a Template
        call: rest-miscellaneous.getlabeltemplateinfo
        with:
          name: rest.name
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/licenses
      name: licenses
      description: REST surface for licenses.
      operations:
      - method: GET
        name: listlicensetemplates
        description: Returns a List of All License Templates
        call: rest-miscellaneous.listlicensetemplates
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/licenses/{name}
      name: licenses-name
      description: REST surface for licenses-name.
      operations:
      - method: GET
        name: getlicensetemplateinfo
        description: Returns Information About a License Template
        call: rest-miscellaneous.getlicensetemplateinfo
        with:
          name: rest.name
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/markdown
      name: markdown
      description: REST surface for markdown.
      operations:
      - method: POST
        name: rendermarkdown
        description: Render a Markdown Document as HTML
        call: rest-miscellaneous.rendermarkdown
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/markdown/raw
      name: markdown-raw
      description: REST surface for markdown-raw.
      operations:
      - method: POST
        name: rendermarkdownraw
        description: Render Raw Markdown as HTML
        call: rest-miscellaneous.rendermarkdownraw
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/markup
      name: markup
      description: REST surface for markup.
      operations:
      - method: POST
        name: rendermarkup
        description: Render a Markup Document as HTML
        call: rest-miscellaneous.rendermarkup
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/signing-key-gpg
      name: signing-key-gpg
      description: REST surface for signing-key.gpg.
      operations:
      - method: GET
        name: getsigningkey
        description: Get Default Signing-Key.gpg
        call: rest-miscellaneous.getsigningkey
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/signing-key-pub
      name: signing-key-pub
      description: REST surface for signing-key.pub.
      operations:
      - method: GET
        name: getsigningkeyssh
        description: Get Default Signing-Key.pub
        call: rest-miscellaneous.getsigningkeyssh
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/version
      name: version
      description: REST surface for version.
      operations:
      - method: GET
        name: getversion
        description: Returns the Version of the Gitea Application
        call: rest-miscellaneous.getversion
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: rest-miscellaneous-mcp
    port: 9090
    transport: http
    description: MCP adapter for Gitea API — miscellaneous. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: returns-list-all-gitignore-templates
      description: Returns a List of All Gitignore Templates
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-miscellaneous.listgitignorestemplates
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-information-about-gitignore-template
      description: Returns Information About a Gitignore Template
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-miscellaneous.getgitignoretemplateinfo
      with:
        name: tools.name
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-list-all-label-templates
      description: Returns a List of All Label Templates
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-miscellaneous.listlabeltemplates
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-all-labels-template
      description: Returns All Labels in a Template
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-miscellaneous.getlabeltemplateinfo
      with:
        name: tools.name
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-list-all-license-templates
      description: Returns a List of All License Templates
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-miscellaneous.listlicensetemplates
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-information-about-license-template
      description: Returns Information About a License Template
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-miscellaneous.getlicensetemplateinfo
      with:
        name: tools.name
      outputParameters:
      - type: object
        mapping: $.
    - name: render-markdown-document-html
      description: Render a Markdown Document as HTML
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: rest-miscellaneous.rendermarkdown
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: render-raw-markdown-html
      description: Render Raw Markdown as HTML
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: rest-miscellaneous.rendermarkdownraw
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: render-markup-document-html
      description: Render a Markup Document as HTML
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: rest-miscellaneous.rendermarkup
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-default-signing-key-gpg
      description: Get Default Signing-Key.gpg
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-miscellaneous.getsigningkey
      outputParameters:
      - type: object
        mapping: $.
    - name: get-default-signing-key-pub
      description: Get Default Signing-Key.pub
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-miscellaneous.getsigningkeyssh
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-version-gitea-application
      description: Returns the Version of the Gitea Application
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-miscellaneous.getversion
      outputParameters:
      - type: object
        mapping: $.