openapi: 3.1.0
info:
  title: Meilisearch Documents Health API
  description: 'Meilisearch is an open-source, lightning-fast search engine API. This specification

    documents the core REST endpoints for managing indexes, documents, search, settings,

    API keys, and tasks. All protected routes require Bearer token authentication using

    a master key or regular API key.

    '
  version: '1.0'
  contact:
    name: Meilisearch
    url: https://www.meilisearch.com/docs
servers:
- url: http://localhost:7700
  description: Default local Meilisearch instance
- url: https://{cluster}.meilisearch.io
  description: Meilisearch Cloud instance
  variables:
    cluster:
      default: edge
security:
- bearerAuth: []
tags:
- name: Health
paths:
  /health:
    get:
      tags:
      - Health
      summary: Health check
      description: Returns the health status of the Meilisearch instance.
      security: []
      responses:
        '200':
          description: Instance is healthy
  /version:
    get:
      tags:
      - Health
      summary: Get version
      description: Returns the version of the running Meilisearch instance.
      responses:
        '200':
          description: Version information
  /stats:
    get:
      tags:
      - Health
      summary: Get global stats
      description: Returns aggregate statistics across all indexes.
      responses:
        '200':
          description: Stats payload
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: token
      description: 'Authorization header using "Authorization: Bearer {API_KEY}".

        The master key authorizes /keys management; regular API keys

        should be used for all other routes.

        '