Learn Wardley Mapping · GPT Actions

{
  "info": {
    "title": "Learn Wardley Mapping API",
    "description": "Educational API for learning Wardley Mapping through guided tutorials, examples, and hands-on practice",
    "version": "2.8.3",
    "contact": {
      "name": "Wardley Crew API Support",
      "url": "https://api.wardleymaps.ai",
      "email": "support@wardleymaps.ai"
    },
    "license": {
      "name": "MIT License",
      "url": "https://api.wardleymaps.ai/docs"
    }
  },
  "tags": [
    {
      "name": "Open Wardley Maps",
      "description": "API endpoints related to Open Wardley Maps"
    },
    {
      "name": "Wardley Maps Online (create.wardleymaps.ai)",
      "description": "Operations related to Wardley Maps Online"
    },
    {
      "name": "Conversions",
      "description": "Convert from one Wardley Mapping format to another"
    },
    {
      "name": "Knowledge Base",
      "description": "Operations related to the Wardley Mapping knowledge base"
    },
    {
      "name": "Tools",
      "description": "Tools for managing Wardley Maps"
    }
  ],
  "openapi": "3.1.0",
  "components": {
    "schemas": {
      "WardleyMapImageURLResponse": {
        "type": "object",
        "properties": {
          "image_url": {
            "type": "string",
            "description": "The URL of the generated Wardley Map image"
          }
        },
        "required": [
          "image_url"
        ],
        "example": {
          "image_url": "https://images.wardleymaps.ai/wardleymaps/map_32e71d5d-e747-4998-8cfb-7b4d1ed31fe9.png"
        }
      },
      "WardleyMapSaveResponse": {
        "type": "object",
        "properties": {
          "map_id": {
            "type": "string",
            "description": "A unique identifier for the map, generated by the server."
          },
          "edit_url": {
            "type": "string",
            "description": "URL for editing the Wardley Map."
          }
        },
        "required": [
          "map_id",
          "edit_url"
        ],
        "example": {
          "map_id": "30f8e6a71f39253704",
          "edit_url": "https://create.wardleymaps.ai/#30f8e6a71f39253704"
        }
      },
      "MapIDRequest": {
        "type": "object",
        "required": [
          "map_id"
        ],
        "properties": {
          "map_id": {
            "type": "string",
            "minLength": 18,
            "maxLength": 18,
            "description": "The ID of the Wardley Map from create.wardleymaps.ai"
          }
        },
        "example": {
          "map_id": "30f8e6a71f39253704"
        }
      },
      "Component": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "evolution": {
            "type": "string"
          },
          "visibility": {
            "type": "string"
          }
        },
        "example": {
          "name": "AI Research",
          "evolution": "Genesis",
          "visibility": "High"
        }
      },
      "ComponentRequest": {
        "type": "object",
        "required": [
          "map_id",
          "name"
        ],
        "properties": {
          "map_id": {
            "type": "string",
            "description": "The ID of the Wardley Map"
          },
          "name": {
            "type": "string"
          }
        },
        "example": {
          "map_id": "30f8e6a71f39253704",
          "name": "AI Research"
        }
      },
      "Search": {
        "type": "object",
        "required": [
          "map_id",
          "search_term"
        ],
        "properties": {
          "search_term": {
            "type": "string"
          },
          "map_id": {
            "type": "string",
            "description": "The ID of the Wardley Map"
          }
        },
        "example": {
          "map_id": "30f8e6a71f39253704",
          "search_term": "AI"
        }
      },
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string",
            "description": "Error message explaining what went wrong"
          }
        },
        "example": {
          "error": "An unexpected error occurred"
        }
      },
      "MapText": {
        "type": "object",
        "properties": {
          "owmtext": {
            "type": "string"
          }
        },
        "required": [
          "owmtext"
        ],
        "example": {
          "owmtext": "title Tea Shop\nanchor Business [0.95, 0.63]\nanchor Public [0.95, 0.78]\ncomponent Cup of Tea [0.79, 0.61] label [19, -4]\ncomponent Cup [0.73, 0.78]\ncomponent Tea [0.63, 0.81]\ncomponent Hot Water [0.52, 0.80]\ncomponent Water [0.38, 0.82]\ncomponent Kettle [0.43, 0.35] label [-57, 4]\nevolve Kettle 0.62 label [16, 7]\ncomponent Power [0.1, 0.7] label [-27, 20]\nevolve Power 0.89 label [-12, 21]\nBusiness->Cup of Tea\nPublic->Cup of Tea\nCup of Tea->Cup\nCup of Tea->Tea\nCup of Tea->Hot Water\nHot Water->Water\nHot Water->Kettle\nKettle->Power\n\nannotation 1 [[0.43,0.49],[0.08,0.79]] Standardising power allows Kettles to evolve faster\nannotation 2 [0.48, 0.85] Hot water is obvious and well known\nannotations [0.60, 0.02]\n\nnote +a generic note appeared [0.23, 0.33]\n\nstyle wardley"
        }
      },
      "MapTextAndWarnings": {
        "type": "object",
        "properties": {
          "owmtext": {
            "type": "string",
            "description": "The text representation of the Wardley Map in OWM format"
          },
          "warnings": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "List of warnings associated with the map"
          }
        },
        "example": {
          "owmtext": "title Tea Shop\nanchor Business [0.95, 0.63]\nanchor Public [0.95, 0.78]\ncomponent Cup of Tea [0.79, 0.61] label [19, -4]\ncomponent Cup [0.73, 0.78]\ncomponent Tea [0.63, 0.81]\ncomponent Hot Water [0.52, 0.80]\ncomponent Water [0.38, 0.82]\ncomponent Kettle [0.43, 0.35] label [-57, 4]\nevolve Kettle 0.62 label [16, 7]\ncomponent Power [0.1, 0.7] label [-27, 20]\nevolve Power 0.89 label [-12, 21]\nBusiness->Cup of Tea\nPublic->Cup of Tea\nCup of Tea->Cup\nCup of Tea->Tea\nCup of Tea->Hot Water\nHot Water->Water\nHot Water->Kettle\nKettle->Power\n\nannotation 1 [[0.43,0.49],[0.08,0.79]] Standardising power allows Kettles to evolve faster\nannotation 2 [0.48, 0.85] Hot water is obvious and well known\nannotations [0.60, 0.02]\n\nnote +a generic note appeared [0.23, 0.33]\n\nstyle wardley",
          "warnings": [
            "Warning 1",
            "Warning 2"
          ]
        }
      },
      "WebsiteMapText": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string"
          }
        },
        "required": [
          "text"
        ],
        "example": {
          "text": "title Tea Shop\nanchor Business [0.95, 0.63]\nanchor Public [0.95, 0.78]\ncomponent Cup of Tea [0.79, 0.61] label [19, -4]\ncomponent Cup [0.73, 0.78]\ncomponent Tea [0.63, 0.81]\ncomponent Hot Water [0.52, 0.80]\ncomponent Water [0.38, 0.82]\ncomponent Kettle [0.43, 0.35] label [-57, 4]\nevolve Kettle 0.62 label [16, 7]\ncomponent Power [0.1, 0.7] label [-27, 20]\nevolve Power 0.89 label [-12, 21]\nBusiness->Cup of Tea\nPublic->Cup of Tea\nCup of Tea->Cup\nCup of Tea->Tea\nCup of Tea->Hot Water\nHot Water->Water\nHot Water->Kettle\nKettle->Power\n\nannotation 1 [[0.43,0.49],[0.08,0.79]] Standardising power allows Kettles to evolve faster\nannotation 2 [0.48, 0.85] Hot water is obvious and well known\nannotations [0.60, 0.02]\n\nnote +a generic note appeared [0.23, 0.33]\n\nstyle wardley"
        }
      },
      "VideoQueryResult": {
        "type": "object",
        "properties": {
          "answer": {
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "author": {
            "type": "string"
          },
          "source_video": {
            "type": "string"
          },
          "start_time": {
            "type": "integer"
          },
          "view_count": {
            "type": "integer"
          },
          "like_count": {
            "type": "integer"
          },
          "dislike_count": {
            "type": "integer"
          },
          "upload_date": {
            "type": "string"
          },
          "average_rating": {
            "type": "number"
          },
          "description": {
            "type": "string"
          },
          "content": {
            "type": "string"
          }
        },
        "example": {
          "answer": "The best way to learn Wardley Maps is by practicing.",
          "source": "https://www.youtube.com/watch?v=abcd1234",
          "title": "Introduction to Wardley Maps",
          "author": "Simon Wardley",
          "source_video": "abcd1234",
          "start_time": 120,
          "view_count": 1000,
          "like_count": 50,
          "dislike_count": 2,
          "upload_date": "2021-06-01",
          "average_rating": 4.5,
          "description": "A comprehensive guide to understanding and using Wardley Maps.",
          "content": "In this video, Simon Wardley explains the fundamentals of Wardley Maps."
        }
      },
      "BookQueryRequest": {
        "type": "object",
        "required": [
          "unique_uuid",
          "query"
        ],
        "properties": {
          "unique_uuid": {
            "type": "string",
            "description": "Generate a unique UUID identifier for this conversation with the user",
            "example": "550e8400-e29b-41d4-a716-446655440000"
          },
          "query": {
            "type": "string",
            "description": "The query to be processed about Wardley Mapping",
            "example": "Tell me about Wardley Mapping."
          }
        }
      },
      "QueryResponse": {
        "type": "object",
        "properties": {
          "answer": {
            "type": "string",
            "description": "The response generated by the chatbot",
            "example": "Inertia, as discussed in the provided context, refers to resistance to change that exists in various forms within a business setting. It can manifest as a reluctance to adapt to new technologies, market conditions, or ways of doing business. Inertia can stem from factors like fear of new competitors, the cost of acquiring new skills, concerns about market readiness, lack of pricing competition, resistance from rewards and culture, and more. It often leads to a loss of capital, whether physical, social, financial, or political."
          },
          "source_documents": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "page_content": {
                  "type": "string",
                  "description": "The content of the source document",
                  "example": "**Chapter 16 - Super Looper**\\n**Managing inertia**\\nAll forms of inertia relate to some loss of capital, whether physical, social, financial or political. We know that two groups (security and systems) are exhibiting inertia, however, such visible signs are usually not the problem as we’re aware of it and hence, it can be managed. The danger is always the group that haven’t quite made themselves clear."
                },
                "metadata": {
                  "type": "object",
                  "properties": {
                    "Chapter": {
                      "type": "string",
                      "description": "The chapter of the source document",
                      "example": "**Chapter 16 - Super Looper**"
                    },
                    "Section": {
                      "type": "string",
                      "description": "The section of the source document",
                      "example": "**Managing inertia**"
                    }
                  }
                },
                "type": {
                  "type": "string",
                  "description": "The type of the document",
                  "example": "Document"
                }
              }
            }
          }
        }
      }
    },
    "responses": {
      "BadRequest": {
        "description": "Bad request - missing or invalid parameters",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "ServerError": {
        "description": "Internal server error",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.wardleymaps.ai"
    }
  ],
  "paths": {
    "/v2/generate-mapfromtext": {
      "post": {
        "operationId": "generateWardleyMapFromText",
        "summary": "Create a Wardley Map from Map Text",
        "x-openai-isConsequential": false,
        "description": "Generate a visual Wardley Map image from text description. Provide map text in OWM format and receive a URL to the generated map visualization.",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MapText"
              },
              "example": {
                "owmtext": "title Tea Shop\nanchor Business [0.95, 0.63]\nanchor Public [0.95, 0.78]\ncomponent Cup of Tea [0.79, 0.61] label [19, -4]\ncomponent Cup [0.73, 0.78]\ncomponent Tea [0.63, 0.81]\ncomponent Hot Water [0.52, 0.80]\ncomponent Water [0.38, 0.82]\ncomponent Kettle [0.43, 0.35] label [-57, 4]\nevolve Kettle 0.62 label [16, 7]\ncomponent Power [0.1, 0.7] label [-27, 20]\nevolve Power 0.89 label [-12, 21]\nBusiness->Cup of Tea\nPublic->Cup of Tea\nCup of Tea->Cup\nCup of Tea->Tea\nCup of Tea->Hot Water\nHot Water->Water\nHot Water->Kettle\nKettle->Power\n\nannotation 1 [[0.43,0.49],[0.08,0.79]] Standardising power allows Kettles to evolve faster\nannotation 2 [0.48, 0.85] Hot water is obvious and well known\nannotations [0.60, 0.02]\n\nnote +a generic note appeared [0.23, 0.33]\n\nstyle wardley"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WardleyMapImageURLResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/ServerError"
          }
        },
        "tags": [
          "Open Wardley Maps"
        ],
        "parameters": []
      }
    },
    "/v2/generate-mapfromid": {
      "post": {
        "operationId": "generateWardleyMapFromID",
        "summary": "Create a Wardley Map from a Map ID",
        "x-openai-isConsequential": false,
        "description": "Generate a visual Wardley Map image from a previously saved map ID. IMPORTANT Only use this endpoint with a valid map_id obtained from generateWardleyMapFromText, saveWardleyMap. Invalid map IDs will cause errors.",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MapIDRequest"
              },
              "example": {
                "map_id": "30f8e6a71f39253704"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WardleyMapImageURLResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/ServerError"
          }
        },
        "tags": [
          "Open Wardley Maps"
        ],
        "parameters": []
      }
    },
    "/v2/maps/save": {
      "post": {
        "operationId": "saveWardleyMap",
        "x-openai-isConsequential": false,
        "summary": "Save a Wardley Map to create.wardleymaps.ai",
        "description": "Save a Wardley Map to the online editor at create.wardleymaps.ai. Returns a unique map ID and direct edit URL for sharing and collaboration.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "description": "The Online Wardley Map (OWM) in text format."
                  }
                },
                "required": [
                  "text"
                ],
                "example": {
                  "text": "title Tea Shop\nanchor Business [0.95, 0.63]\nanchor Public [0.95, 0.78]\ncomponent Cup of Tea [0.79, 0.61] label [19, -4]\ncomponent Cup [0.73, 0.78]\ncomponent Tea [0.63, 0.81]\ncomponent Hot Water [0.52, 0.80]\ncomponent Water [0.38, 0.82]\ncomponent Kettle [0.43, 0.35] label [-57, 4]\nevolve Kettle 0.62 label [16, 7]\ncomponent Power [0.1, 0.7] label [-27, 20]\nevolve Power 0.89 label [-12, 21]\nBusiness->Cup of Tea\nPublic->Cup of Tea\nCup of Tea->Cup\nCup of Tea->Tea\nCup of Tea->Hot Water\nHot Water->Water\nHot Water->Kettle\nKettle->Power\n\nannotation 1 [[0.43,0.49],[0.08,0.79]] Standardising power allows Kettles to evolve faster\nannotation 2 [0.48, 0.85] Hot water is obvious and well known\nannotations [0.60, 0.02]\n\nnote +a generic note appeared [0.23, 0.33]\n\nstyle wardley"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Map saved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WardleyMapSaveResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/ServerError"
          }
        },
        "tags": [
          "Wardley Maps Online (create.wardleymaps.ai)"
        ],
        "x-internal": false,
        "parameters": []
      }
    },
    "/v2/maps/fetch": {
      "get": {
        "operationId": "fetchWardleyMap",
        "x-openai-isConsequential": false,
        "summary": "Get a Wardley Map from create.wardleymaps.ai",
        "description": "Retrieve a previously saved Wardley Map using its unique ID. Returns the complete map text that can be analyzed or modified.",
        "parameters": [
          {
            "name": "id",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The Wardley Map ID to fetch.",
            "example": "30f8e6a71f39253704"
          }
        ],
        "responses": {
          "200": {
            "description": "Fetch Wardley Map successful",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/WebsiteMapText"
                  },
                  "example": {
                    "text": "title Tea Shop\nanchor Business [0.95, 0.63]\nanchor Public [0.95, 0.78]\ncomponent Cup of Tea [0.79, 0.61] label [19, -4]\ncomponent Cup [0.73, 0.78]\ncomponent Tea [0.63, 0.81]\ncomponent Hot Water [0.52, 0.80]\ncomponent Water [0.38, 0.82]\ncomponent Kettle [0.43, 0.35] label [-57, 4]\nevolve Kettle 0.62 label [16, 7]\ncomponent Power [0.1, 0.7] label [-27, 20]\nevolve Power 0.89 label [-12, 21]\nBusiness->Cup of Tea\nPublic->Cup of Tea\nCup of Tea->Cup\nCup of Tea->Tea\nCup of Tea->Hot Water\nHot Water->Water\nHot Water->Kettle\nKettle->Power\n\nannotation 1 [[0.43,0.49],[0.08,0.79]] Standardising power allows Kettles to evolve faster\nannotation 2 [0.48, 0.85] Hot water is obvious and well known\nannotations [0.60, 0.02]\n\nnote +a generic note appeared [0.23, 0.33]\n\nstyle wardley"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/ServerError"
          }
        },
        "tags": [
          "Wardley Maps Online (create.wardleymaps.ai)"
        ],
        "x-internal": false
      }
    },
    "/v2/get-owm-text": {
      "post": {
        "summary": "Retrieve Map Text in OWM format of a specific Wardley Map",
        "description": "Extract the complete text representation of a Wardley Map using its ID. Perfect for analysis, editing, or converting to other formats.",
        "operationId": "getWardleyMapText",
        "x-openai-isConsequential": false,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MapIDRequest"
              },
              "example": {
                "map_id": "30f8e6a71f39253704"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Wardley Map in OWM text format",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/MapText"
                  },
                  "example": [
                    {
                      "owmtext": "title Tea Shop\nanchor Business [0.95, 0.63]\nanchor Public [0.95, 0.78]\ncomponent Cup of Tea [0.79, 0.61] label [19, -4]\ncomponent Cup [0.73, 0.78]\ncomponent Tea [0.63, 0.81]\ncomponent Hot Water [0.52, 0.80]\ncomponent Water [0.38, 0.82]\ncomponent Kettle [0.43, 0.35] label [-57, 4]\nevolve Kettle 0.62 label [16, 7]\ncomponent Power [0.1, 0.7] label [-27, 20]\nevolve Power 0.89 label [-12, 21]\nBusiness->Cup of Tea\nPublic->Cup of Tea\nCup of Tea->Cup\nCup of Tea->Tea\nCup of Tea->Hot Water\nHot Water->Water\nHot Water->Kettle\nKettle->Power\n\nannotation 1 [[0.43,0.49],[0.08,0.79]] Standardising power allows Kettles to evolve faster\nannotation 2 [0.48, 0.85] Hot water is obvious and well known\nannotations [0.60, 0.02]\n\nnote +a generic note appeared [0.23, 0.33]\n\nstyle wardley"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/ServerError"
          }
        },
        "tags": [
          "Open Wardley Maps"
        ],
        "x-internal": false,
        "parameters": []
      }
    },
    "/v2/list-github-maps": {
      "get": {
        "summary": "List GitHub Wardley Maps",
        "description": "Browse the complete collection of public Wardley Maps stored in the GitHub repository. Discover maps across different industries and use cases.",
        "operationId": "listGithubMaps",
        "x-openai-isConsequential": false,
        "tags": [
          "Tools"
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "example": [
                    "gaming/Game-Experience-Design/Component-Map",
                    "gaming/Game-Experience-Design/MidMap",
                    "gaming/Game-Experience-Design/OTHER-MAP",
                    "gaming/Game-Experience-Design/Practices-Map",
                    "gaming/Game-Experience-Design/TopMap"
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/ServerError"
          }
        },
        "parameters": []
      }
    },
    "/v2/get-github-map": {
      "get": {
        "summary": "Get GitHub Wardley Map Content",
        "description": "Load a specific Wardley Map from the GitHub repository using its path. Use listGithubMaps first to discover available maps, then provide the map path here. Returns the complete map text with validation warnings for analysis.",
        "operationId": "getGithubMapContent",
        "x-openai-isConsequential": false,
        "tags": [
          "Tools"
        ],
        "parameters": [
          {
            "name": "github_path",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Path of the Wardley Map to retrieve.",
            "example": "agriculture/agriculture-food-traceability and security"
          }
        ],
        "responses": {
          "200": {
            "description": "Wardley Map Content",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MapTextAndWarnings"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/ServerError"
          }
        }
      }
    },
    "/v1/querywardleybook": {
      "post": {
        "summary": "Query the Wardley Mapping Book",
        "x-openai-isConsequential": false,
        "description": "Query Simon Wardley's comprehensive book on Wardley Mapping. Get detailed answers about mapping concepts, strategies, and best practices with source references.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BookQueryRequest"
              }
            }
          }
        },
        "tags": [
          "Knowledge Base"
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QueryResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/ServerError"
          }
        },
        "operationId": "queryWardleyBook",
        "parameters": []
      }
    },
    "/v1/querywardleydiagrams": {
      "post": {
        "summary": "Query the Wardley Mapping Diagrams",
        "x-openai-isConsequential": false,
        "description": "Search through Wardley Mapping diagrams and visual examples. Get insights about specific mapping patterns, structures, and diagram interpretations.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BookQueryRequest"
              }
            }
          }
        },
        "tags": [
          "Knowledge Base"
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QueryResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/ServerError"
          }
        },
        "operationId": "queryWardleyDiagrams",
        "parameters": []
      }
    },
    "/v1/querywardleyvideos": {
      "post": {
        "operationId": "queryVideos",
        "summary": "Query the Wardley Mapping Videos",
        "x-openai-isConsequential": false,
        "description": "Search through Wardley Mapping video content to find specific insights. Returns relevant video segments with timestamps and detailed answers from video transcripts.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "question": {
                    "type": "string",
                    "description": "The question to ask the videos."
                  }
                },
                "required": [
                  "question"
                ],
                "example": {
                  "question": "What is inertia?"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VideoQueryResult"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/ServerError"
          }
        },
        "tags": [
          "Knowledge Base"
        ],
        "x-internal": false,
        "parameters": []
      }
    }
  }
}