openapi: 3.1.0
info:
  title: AsyncAPI Server Bundle Generate API
  version: '1.0'
  description: 'The AsyncAPI Server API exposes the official AsyncAPI tooling

    (validation, parsing, conversion, code generation, bundling, diffing)

    over HTTP. It is open source under the AsyncAPI Initiative (now part of

    the AsyncAPI CLI repository) and can be self-hosted via Docker.


    Note: The AsyncAPI specification itself is a documentation/specification

    standard, not an API. This document covers the companion AsyncAPI Server

    API which provides the runtime HTTP surface.

    '
  contact:
    name: AsyncAPI Initiative
    url: https://www.asyncapi.com
  license:
    name: Apache-2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
servers:
- url: http://localhost
  description: Self-hosted AsyncAPI Server API
tags:
- name: Generate
paths:
  /generate:
    post:
      tags:
      - Generate
      summary: Generate code or documentation from an AsyncAPI document
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - asyncapi
              - template
              properties:
                asyncapi:
                  oneOf:
                  - type: object
                  - type: string
                template:
                  type: string
                  description: Generator template (e.g. @asyncapi/html-template)
                parameters:
                  type: object
                  additionalProperties: true
      responses:
        '200':
          description: Generated artifacts (zip)
          content:
            application/zip:
              schema:
                type: string
                format: binary
        '422':
          $ref: '#/components/responses/Problem'
components:
  schemas:
    Problem:
      type: object
      properties:
        type:
          type: string
          format: uri
        title:
          type: string
        status:
          type: integer
        detail:
          type: string
        instance:
          type: string
  responses:
    Problem:
      description: RFC 7807 problem response
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'