openapi: 3.2.0
info:
  title: Lucid Software ChatGPT Plugin Create Diagram API
  description: An API that allows for diagram creation from a description in Mermaid format.
  version: v1
servers:
- url: https://mlai.lucid.app
tags:
- name: CreateDiagram
paths:
  /createDiagram:
    post:
      operationId: createDiagram
      summary: Create a new diagram
      description: Accepts a JSON object with the diagram to be created, using Mermaid syntax. Returns a link to an image of the diagram. If the mermaid diagram is of type `flowchart`, it will also include a link to edit the diagram in Lucidchart.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/createDiagram'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/createDiagramResponse'
      tags:
      - CreateDiagram
components:
  schemas:
    createDiagramResponse:
      type: object
      properties:
        imageLink:
          description: The link to the image of the diagram, to be displayed as an embedded image via Markdown.
          type: string
        error:
          description: Any errors encountered while handling the request.
          type: string
        editLink:
          description: A link to an editable version of the diagram in Lucidchart for flowchart diagrams.
          type: string
    createDiagram:
      type: object
      properties:
        validDiagramCode:
          description: "The valid Mermaid code for the diagram. `flowchart` diagrams should be preferred, but all Mermaid diagram types are supported.\nMermaid Guidelines:\n - All node labels should be enclosed in square brackets and double quotes. For example, if you wanted node A to display `[Fe(CN)6]4-`, it should be written as `A[\"[Fe(CN)6]4-\"]`\n - A line from node A to node B is denoted `A --> B`\n - Subgraphs should be used sparingly, and not to enclose an entire diagram\n"
          type: string
      required:
      - validDiagramCode