openapi: 3.1.0
info:
  title: AsyncAPI Server Bundle Convert 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: Convert
paths:
  /convert:
    post:
      tags:
      - Convert
      summary: Convert an AsyncAPI document to another version or format
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - asyncapi
              properties:
                asyncapi:
                  oneOf:
                  - type: object
                  - type: string
                version:
                  type: string
                  description: Target AsyncAPI spec version
                language:
                  type: string
                  enum:
                  - yaml
                  - json
      responses:
        '200':
          description: Converted document
          content:
            application/json:
              schema:
                type: object
                properties:
                  converted:
                    oneOf:
                    - type: object
                    - type: string
        '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'