Mermaid

Create Mermaid Diagram

Generate a Mermaid flowchart from a natural language description and auto-save it.

AUTHENTICATION REQUIRED - Must include valid JWT token in Authorization header.

Args: diagram_request: DiagramRequest containing the description request: FastAPI Request object (required for rate limiting) current_user: Authenticated user (injected by Auth0 middleware) db: Database session

Returns: MermaidResponse with Mermaid syntax code and saved diagram ID

Rate limit: Configurable via RATE_LIMIT_PER_MINUTE env var (default: 10/minute)

post/api/generate-mermaid

Request

Base URL
https://api.makeaviz.com (the document declares no server; this is the origin it was published from)
Auth
HTTP bearer
TypeScript
https://skmtc.dev/makeaviz/apis/text-to-diagram-api/docs/api/generate-mermaid/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

descriptionstring required

Natural language description of the diagram (10-5000 characters)

diagram_type'flowchart' | 'sequence' | 'mindmap' | 'auto'

Type of diagram to generate (flowchart, sequence, mindmap, or auto to let AI decide)

Example request

{
  "description": "User login flow with authentication and error handling",
  "diagram_type": "flowchart"
}

Response

Successful Response

mermaidCodestring required

Generated Mermaid diagram syntax

titlestring required

Diagram title extracted from description

diagram_type'flowchart' | 'sequence' | 'mindmap'

Type of diagram generated

savedDiagramIdinteger nullable

ID of the auto-saved diagram (if save was successful)

diagram_jsonobject nullable

Current diagram state from database (for edit operations, used in visual diff)

Example response

{
  "mermaidCode": "flowchart TB\n  start([Start])\n  finish([End])\n  start --> finish",
  "savedDiagramId": 123,
  "title": "User login flow with authentication..."
}

Changes

No recorded changes to this operation across all 1 revision of this API.