{
  "openapi": "3.0.3",
  "info": {
    "title": "Bonai News API",
    "version": "2024-01-01",
    "description": "A comprehensive news aggregation and search API providing access to articles, publishers, and trending topics across multiple languages and countries."
  },
  "servers": [
    {
      "url": "https://api.bonai.io/news",
      "description": "Production"
    }
  ],
  "paths": {
    "/ping": {
      "get": {
        "summary": "Ping",
        "description": "Simple endpoint to test API connectivity",
        "operationId": "ping",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PingResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "$ref": "#/components/parameters/ApiVersionHeader"
          }
        ],
        "x-mint": {
          "href": "/api-reference/bonai-news-api/ping"
        }
      }
    },
    "/info/topics": {
      "get": {
        "summary": "Supported topics",
        "description": "Returns a list of all available news topics and their subtopics",
        "operationId": "getTopics",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InfoTopicsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "$ref": "#/components/parameters/ApiVersionHeader"
          }
        ],
        "security": [
          {
            "apiKey": []
          }
        ],
        "x-mint": {
          "href": "/api-reference/bonai-news-api/supported-topics"
        }
      }
    },
    "/info/countries": {
      "get": {
        "summary": "Supported countries",
        "description": "Returns a list of all supported countries with their available languages",
        "operationId": "getCountries",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InfoCountriesResponse"
                }
              }
            }
          },
          "400": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "$ref": "#/components/parameters/ApiVersionHeader"
          }
        ],
        "security": [
          {
            "apiKey": []
          }
        ],
        "x-mint": {
          "href": "/api-reference/bonai-news-api/supported-countries"
        }
      }
    },
    "/info/languages": {
      "get": {
        "summary": "Supported languages",
        "description": "Returns a list of all supported languages",
        "operationId": "getLanguages",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InfoLanguagesResponse"
                }
              }
            }
          },
          "400": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "$ref": "#/components/parameters/ApiVersionHeader"
          }
        ],
        "security": [
          {
            "apiKey": []
          }
        ],
        "x-mint": {
          "href": "/api-reference/bonai-news-api/supported-languages"
        }
      }
    },
    "/search/articles": {
      "get": {
        "summary": "Search articles",
        "description": "Search for news articles with various filters",
        "operationId": "searchArticles",
        "parameters": [
          {
            "name": "query",
            "in": "query",
            "required": true,
            "description": "Search query string",
            "schema": {
              "type": "string",
              "minLength": 1
            }
          },
          {
            "name": "language",
            "in": "query",
            "description": "Language code (e.g., 'en', 'es')",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "description": "Country code (e.g., 'us', 'uk')",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "publisher",
            "in": "query",
            "description": "Publisher URL to filter by",
            "schema": {
              "type": "string",
              "format": "uri"
            }
          },
          {
            "name": "paywall",
            "in": "query",
            "description": "Filter by paywall status",
            "schema": {
              "type": "string",
              "enum": [
                "true",
                "false"
              ]
            }
          },
          {
            "name": "from",
            "in": "query",
            "description": "Start date for date range filter",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "to",
            "in": "query",
            "description": "End date for date range filter",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Number of results per page",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000,
              "default": 25
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Sort order",
            "schema": {
              "type": "string",
              "enum": [
                "relevance",
                "date"
              ]
            }
          },
          {
            "$ref": "#/components/parameters/ApiVersionHeader"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchArticlesResponse"
                }
              }
            }
          },
          "400": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "402": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "x-mint": {
          "href": "/api-reference/bonai-news-api/search-articles"
        }
      }
    },
    "/search/publishers": {
      "get": {
        "summary": "Search publishers",
        "description": "Search for news publishers with various filters",
        "operationId": "searchPublishers",
        "parameters": [
          {
            "name": "query",
            "in": "query",
            "required": true,
            "description": "Search query string",
            "schema": {
              "type": "string",
              "minLength": 1
            }
          },
          {
            "name": "category",
            "in": "query",
            "description": "Publisher category",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "description": "Country code",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "language",
            "in": "query",
            "description": "Language code",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Number of results",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 10
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Sort order",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/ApiVersionHeader"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchPublishersResponse"
                }
              }
            }
          },
          "400": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "402": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "x-mint": {
          "href": "/api-reference/bonai-news-api/search-publishers"
        }
      }
    },
    "/article": {
      "get": {
        "summary": "Article content",
        "description": "Retrieve full article content by URL",
        "operationId": "getArticle",
        "parameters": [
          {
            "name": "url",
            "in": "query",
            "required": true,
            "description": "Article URL",
            "schema": {
              "type": "string",
              "format": "uri"
            }
          },
          {
            "name": "type",
            "in": "query",
            "description": "Content type to return",
            "schema": {
              "type": "string",
              "enum": [
                "plaintext",
                "html"
              ]
            }
          },
          {
            "$ref": "#/components/parameters/ApiVersionHeader"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetArticleContentResponse"
                }
              }
            }
          },
          "400": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "402": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "x-mint": {
          "href": "/api-reference/bonai-news-api/article-content"
        }
      }
    },
    "/article/random": {
      "get": {
        "summary": "Random article",
        "description": "Retrieve a random article based on optional filters",
        "operationId": "getRandomArticle",
        "parameters": [
          {
            "name": "topic",
            "in": "query",
            "description": "Topic filter",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "language",
            "in": "query",
            "description": "Language code",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "type",
            "in": "query",
            "description": "Content type to return",
            "schema": {
              "type": "string",
              "enum": [
                "plaintext",
                "html"
              ]
            }
          },
          {
            "$ref": "#/components/parameters/ApiVersionHeader"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetRandomArticleResponse"
                }
              }
            }
          },
          "400": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "402": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "x-mint": {
          "href": "/api-reference/bonai-news-api/random-article"
        }
      }
    },
    "/trendings": {
      "get": {
        "summary": "Trending articles",
        "description": "Retrieve trending articles for a specific topic, language, and optionally country",
        "operationId": "getTrendingArticles",
        "parameters": [
          {
            "name": "date",
            "in": "query",
            "description": "Date for trending articles (defaults to current)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "topic",
            "in": "query",
            "required": true,
            "description": "Topic to get trends for",
            "schema": {
              "type": "string",
              "minLength": 1
            }
          },
          {
            "name": "language",
            "in": "query",
            "required": true,
            "description": "Language code",
            "schema": {
              "type": "string",
              "minLength": 1
            }
          },
          {
            "name": "country",
            "in": "query",
            "description": "Country code",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Number of results per page",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500,
              "default": 25
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "$ref": "#/components/parameters/ApiVersionHeader"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetTrendingTopicResponse"
                }
              }
            }
          },
          "400": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "402": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": []
          }
        ],
        "x-mint": {
          "href": "/api-reference/bonai-news-api/trending-articles"
        }
      }
    }
  },
  "components": {
    "schemas": {
      "PingResponse": {
        "type": "object",
        "required": [
          "id",
          "message",
          "version",
          "timestamp"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Request ID"
          },
          "message": {
            "type": "string",
            "example": "pong"
          },
          "version": {
            "type": "string",
            "description": "Resolved API version",
            "example": "2024-01-01"
          },
          "timestamp": {
            "type": "integer",
            "description": "Server timestamp in milliseconds"
          }
        }
      },
      "ArticlePublisher": {
        "type": "object",
        "required": [
          "name",
          "url",
          "favicon"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Publisher name. May be empty when the publisher is not recognized."
          },
          "url": {
            "type": "string",
            "description": "Publisher origin (scheme and host)."
          },
          "favicon": {
            "type": "string",
            "description": "Publisher favicon, or a {origin}/favicon.ico fallback."
          }
        }
      },
      "Article": {
        "type": "object",
        "required": [
          "title",
          "url",
          "excerpt",
          "thumbnail",
          "language",
          "paywall",
          "contentLength",
          "date",
          "authors",
          "keywords",
          "publisher"
        ],
        "properties": {
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "excerpt": {
            "type": "string"
          },
          "thumbnail": {
            "type": "string",
            "format": "uri",
            "nullable": true
          },
          "language": {
            "type": "string",
            "description": "Language code, for example en"
          },
          "paywall": {
            "type": "boolean"
          },
          "content": {
            "type": "string",
            "description": "Full article content. Only returned by GET /article when your plan includes it."
          },
          "contentLength": {
            "type": "integer"
          },
          "date": {
            "type": "string",
            "format": "date-time",
            "description": "Publish date (ISO 8601)"
          },
          "authors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "keywords": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "publisher": {
            "$ref": "#/components/schemas/ArticlePublisher"
          }
        }
      },
      "Publisher": {
        "type": "object",
        "required": [
          "title",
          "name",
          "url",
          "language",
          "category",
          "description",
          "logo",
          "favicon",
          "links"
        ],
        "properties": {
          "title": {
            "type": "string"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "url": {
            "type": "string"
          },
          "language": {
            "type": "string"
          },
          "category": {
            "type": "string",
            "description": "Defaults to \"General\" when unknown"
          },
          "description": {
            "type": "string"
          },
          "logo": {
            "type": "string",
            "format": "uri",
            "nullable": true
          },
          "favicon": {
            "type": "string",
            "format": "uri",
            "nullable": true
          },
          "links": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "type",
                "url",
                "username"
              ],
              "properties": {
                "type": {
                  "type": "string",
                  "description": "Social platform"
                },
                "url": {
                  "type": "string"
                },
                "username": {
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "SearchArticlesResponse": {
        "type": "object",
        "required": [
          "success",
          "size",
          "totalHits",
          "hitsPerPage",
          "page",
          "totalPages",
          "timeMs",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "size": {
            "type": "integer",
            "description": "Number of items in the current page"
          },
          "totalHits": {
            "type": "integer",
            "description": "Total number of matching items"
          },
          "hitsPerPage": {
            "type": "integer",
            "description": "Maximum items per page applied for this request"
          },
          "page": {
            "type": "integer",
            "description": "Current page number"
          },
          "totalPages": {
            "type": "integer",
            "description": "Total number of pages"
          },
          "timeMs": {
            "type": "number",
            "description": "Query execution time in milliseconds"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Article"
            }
          }
        }
      },
      "GetTrendingTopicResponse": {
        "type": "object",
        "required": [
          "success",
          "size",
          "totalHits",
          "hitsPerPage",
          "page",
          "totalPages",
          "timeMs",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "size": {
            "type": "integer",
            "description": "Number of items in the current page"
          },
          "totalHits": {
            "type": "integer",
            "description": "Total number of matching items"
          },
          "hitsPerPage": {
            "type": "integer",
            "description": "Maximum items per page applied for this request"
          },
          "page": {
            "type": "integer",
            "description": "Current page number"
          },
          "totalPages": {
            "type": "integer",
            "description": "Total number of pages"
          },
          "timeMs": {
            "type": "number",
            "description": "Query execution time in milliseconds"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Article"
            }
          }
        }
      },
      "GetArticleContentResponse": {
        "type": "object",
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/Article"
          }
        }
      },
      "GetRandomArticleResponse": {
        "type": "object",
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/Article"
          }
        }
      },
      "SearchPublishersResponse": {
        "type": "object",
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Publisher"
            }
          }
        }
      },
      "InfoTopic": {
        "type": "object",
        "required": [
          "id",
          "name",
          "allowed",
          "subtopics"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "allowed": {
            "type": "boolean",
            "description": "Whether the topic is allowed on your plan"
          },
          "subtopics": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "name",
                "allowed"
              ],
              "properties": {
                "id": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "allowed": {
                  "type": "boolean"
                }
              }
            }
          }
        }
      },
      "InfoTopicsResponse": {
        "type": "object",
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/InfoTopic"
            }
          }
        }
      },
      "InfoCountry": {
        "type": "object",
        "required": [
          "name",
          "code",
          "allowed",
          "languages"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "code": {
            "type": "string",
            "description": "Alpha-2 country code"
          },
          "allowed": {
            "type": "boolean",
            "description": "Whether any of the country's languages is allowed on your plan"
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "name",
                "code",
                "allowed"
              ],
              "properties": {
                "name": {
                  "type": "string"
                },
                "code": {
                  "type": "string"
                },
                "allowed": {
                  "type": "boolean"
                }
              }
            }
          }
        }
      },
      "InfoCountriesResponse": {
        "type": "object",
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/InfoCountry"
            }
          }
        }
      },
      "InfoLanguage": {
        "type": "object",
        "required": [
          "name",
          "code",
          "allowed"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "code": {
            "type": "string"
          },
          "allowed": {
            "type": "boolean",
            "description": "Whether the language is allowed on your plan"
          }
        }
      },
      "InfoLanguagesResponse": {
        "type": "object",
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/InfoLanguage"
            }
          }
        }
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "success",
          "code",
          "message"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "code": {
            "type": "integer",
            "description": "HTTP status code"
          },
          "message": {
            "type": "string"
          },
          "fields": {
            "type": "array",
            "description": "Validation details. Empty for non-validation errors.",
            "items": {
              "type": "object",
              "required": [
                "name",
                "type",
                "description"
              ],
              "properties": {
                "name": {
                  "type": "string"
                },
                "type": {
                  "type": "string",
                  "description": "body, params, query, or headers"
                },
                "description": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "parameters": {
      "ApiVersionHeader": {
        "name": "api-version",
        "in": "header",
        "required": false,
        "schema": {
          "type": "string",
          "enum": [
            "2024-01-01"
          ]
        },
        "description": "API version to consume. Defaults to the latest version (2024-01-01)."
      }
    },
    "securitySchemes": {
      "apiKey": {
        "type": "apiKey",
        "name": "api-key",
        "in": "header",
        "description": "Your Bonai API key. Create one in the Bonai console (https://console.bonai.io)."
      }
    }
  }
}