Meilisearch

Required

Fields required for a valid configuration.

Path	Type	Required	Description	Default	Constraints
required	object	Yes	—	—	—

Masked

Sensitive fields under(secrets/credentials).

Path	Type	Required	Description	Default	Constraints
masked	object	No	—	—	—

Optional

Optional configuration fields.

Path	Type	Required	Description	Default	Constraints
optional	object	No	—	—	no extra properties
optional.connection	object	No	Cluster connection controls.	—	no extra properties
optional.connection.request_timeout_seconds	number	No	Network timeout in seconds for cluster API calls	30	min 1, max 300
optional.connection.verify_ssl	boolean	No	TLS certificate verification toggle	true	—
optional.scope	object	No	Index selection scope.	—	no extra properties
optional.scope.exclude_indices	array	No	Index denylist (matches index uid)	—	—
optional.scope.exclude_indices[]	string	No	—	—	—
optional.scope.include_indices	array	No	Optional index allowlist (matches index uid)	—	—
optional.scope.include_indices[]	string	No	—	—	—
optional.scope.index_limit	integer	No	Optional cap on number of index assets	—	min 1

Extracted Metadata

Index

Field	Type	Required	Description
index_name	string	Yes	Index uid
doc_count	integer	Yes	Number of documents in the index
primary_key	string	No	Primary key attribute name
is_indexing	boolean	No	Whether the index has an indexing operation in progress

Examples

Local dev instance scan

Discover indexes and sample documents on a local, unauthenticated Meilisearch instance

Config Payload

{
  "type": "MEILISEARCH",
  "required": {
    "auth_mode": "NONE",
    "url": "http://localhost:7700"
  },
  "sampling": {
    "strategy": "LATEST",
    "rows_per_page": 50
  }
}

Schedule

{
  "enabled": true,
  "preset": "weekday_business",
  "cron": "30 6 * * 1-5",
  "timezone": "UTC"
}

Master key secrets detection

Full scan of selected indexes using an API/master key and run secrets detection

Config Payload

{
  "type": "MEILISEARCH",
  "required": {
    "auth_mode": "API_KEY",
    "url": "https://search.internal.example.com:7700"
  },
  "masked": {
    "api_key": "your-master-or-api-key"
  },
  "optional": {
    "scope": {
      "include_indices": [
        "products",
        "customers"
      ]
    }
  },
  "sampling": {
    "strategy": "ALL",
    "rows_per_page": 100
  },
  "detectors": [
    {
      "type": "SECRETS",
      "enabled": true
    },
    {
      "type": "PII",
      "enabled": true
    }
  ]
}

Schedule

{
  "enabled": true,
  "preset": "nightly",
  "cron": "15 2 * * *",
  "timezone": "UTC"
}

Meilisearch Cloud incremental scan

Incrementally ingest a random sample of documents from a Meilisearch Cloud project on each run

Config Payload

{
  "type": "MEILISEARCH",
  "required": {
    "auth_mode": "API_KEY",
    "url": "https://ms-example123.meilisearch.io"
  },
  "masked": {
    "api_key": "your-api-key"
  },
  "optional": {
    "connection": {
      "verify_ssl": true
    },
    "scope": {
      "exclude_indices": [
        "internal_logs"
      ]
    }
  },
  "sampling": {
    "strategy": "RANDOM",
    "rows_per_page": 50
  }
}

Schedule

{
  "enabled": true,
  "preset": "weekday_business",
  "cron": "45 8 * * 1-5",
  "timezone": "UTC"
}