---
title: "Generate the given AsyncAPI template."
method: POST
path: "/generate"
tags: ["generate", "generator"]
---

# Generate the given AsyncAPI template.

`POST /generate`

## Request body

- GenerateRequest
  - `asyncapi` union, required — AsyncAPI document in JSON or YAML.
    - string
    - 200Json — unresolved $ref
    - 210Json — unresolved $ref
    - 220Json — unresolved $ref
    - 230Json — unresolved $ref
    - 240Json — unresolved $ref
    - 250Json — unresolved $ref
    - 260Json — unresolved $ref
    - 300Json — unresolved $ref
    - 310Json — unresolved $ref
  - `template` '@asyncapi/dotnet-nats-template' | '@asyncapi/go-watermill-template' | '@asyncapi/html-template' | '@asyncapi/java-spring-cloud-stream-template' | '@asyncapi/java-spring-template' | '@asyncapi/java-template' | '@asyncapi/markdown-template' | '@asyncapi/nodejs-template' | '@asyncapi/nodejs-ws-template' | '@asyncapi/python-paho-template' | '@asyncapi/ts-nats-template' | '@asyncapi/minimaltemplate' | '@asyncapi/dotnet-rabbitmq-template', required — Template name to be generated.
  - `use-fallback-generator` boolean — Use generator version 1.17.25
  - `parameters` object — Template parameters to be generated. Each template has different parameters that you should check in the documentation, which is usually located in the template's repository. This field is optional but may be required for some templates.

## Response `200`

Template successfully generated.

## Other responses

- `400` — Failed to generate the given template due to invalid AsyncAPI document.
- `422` — Failed to generate the given template due to invalid parameters.
- `default` — Unexpected problem.

## Changes

- **2026-07-17** `4e4c84b02d25` — 1 info
  - added `#/components/schemas/3.1.0.json` to the `asyncapi` request property `oneOf` list
- **2025-08-19** `077e00451e07` — 1 breaking
  - removed `#/components/schemas/3.1.0.json` from the `asyncapi` request property `oneOf` list

[Change history](https://skmtc.dev/asyncapi/apis/asyncapi-server-api/changes/generate/post.md)

---

[API](https://skmtc.dev/asyncapi/apis/asyncapi-server-api.md) · [All operations](https://skmtc.dev/asyncapi/apis/asyncapi-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/asyncapi/asyncapi-server-api/revisions/4e4c84b02d25/schema)