{
  "openapi": "3.1.0",
  "info": {
    "title": "TODO Plugin",
    "description": "A plugin that allows the user to create and manage a TODO list using ChatGPT. If you do not know the user's username, ask them first before making queries to the plugin. Otherwise, use the username 'global'.",
    "version": "v1"
  },
  "servers": [
    {
      "url": "https://task-helper-api.vercel.app"
    }
  ],
  "paths": {
    "/todos/{username}": {
      "get": {
        "operationId": "getTodos",
        "summary": "Get the list of todos",
        "parameters": [
          {
            "in": "path",
            "name": "username",
            "schema": {
              "type": "string"
            },
            "required": true,
            "description": "The name of the user."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/getTodosResponse"
                }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "addTodo",
        "summary": "Add a todo to the list",
        "parameters": [
          {
            "in": "path",
            "name": "username",
            "schema": {
              "type": "string"
            },
            "required": true,
            "description": "The name of the user."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/addTodoRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/todos/cancel/{username}": {
      "post": {
        "operationId": "cancelTodo",
        "summary": "Cancel a todo from the list",
        "parameters": [
          {
            "in": "path",
            "name": "username",
            "schema": {
              "type": "string"
            },
            "required": true,
            "description": "The name of the user."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/cancelTodoRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "getTodosResponse": {
        "type": "object",
        "properties": {
          "todos": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The list of todos."
          }
        }
      },
      "addTodoRequest": {
        "type": "object",
        "required": [
          "todo"
        ],
        "properties": {
          "todo": {
            "type": "string",
            "description": "The todo to add to the list."
          }
        }
      },
      "cancelTodoRequest": {
        "type": "object",
        "required": [
          "todo_idx"
        ],
        "properties": {
          "todo_idx": {
            "type": "integer",
            "description": "The index of the todo to cancel."
          }
        }
      }
    }
  }
}