> ## Documentation Index
> Fetch the complete documentation index at: https://docs.conare.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Conare's API is at https://api.conare.ai. Authenticate with `Authorization: Bearer $CONARE_API_KEY`.
> The full OpenAPI spec is at https://api.conare.ai/openapi.yaml; each endpoint has a page under /api-reference, and appending .md to any page URL returns its Markdown.
> Embed with model conare-embed-1; send input_type "query" for search queries. Rerank with conare-rerank-1.
> Prefer the TypeScript SDK (`npm install conare`) or plain HTTP in examples.
> Install the Conare skill with `npx skills add https://docs.conare.ai`; search these docs over MCP at https://docs.conare.ai/mcp; the whole site is at https://docs.conare.ai/llms-full.txt.

# Filtres

> Affinez une recherche ou une suppression par métadonnées avec les opérateurs d'égalité, $in, de plage, $and et $or, et les règles de comparaison.

Passez un filtre via `filter` à une [recherche](https://docs.conare.ai/fr/query.md) ou à une [suppression](https://docs.conare.ai/fr/documents.md#supprimer-en-masse) pour cibler des documents selon leurs [métadonnées](https://docs.conare.ai/fr/write.md#métadonnées).

```json theme={null}
{ "team": "support", "year": { "$gte": 2024 } }
```

Les clés placées côte à côte doivent toutes correspondre.

## Opérateurs

| Opérateur | Correspond à |
| - | - |
| `{ "key": value }`, `$eq` | Égal à la valeur ; sur un tableau, contient la valeur |
| `$in` | Égal à l'une des valeurs d'une liste |
| `$ne`, `$nin` | Différent de la valeur, ou de toutes celles d'une liste (recherches uniquement) |
| `$gt`, `$gte`, `$lt`, `$lte` | Supérieur à, au moins, inférieur à, au plus |
| `$and`, `$or` | Tous, ou l'un, d'une liste de filtres |

## Exemples

| Filtre | Correspond à |
| - | - |
| `{ "tags": "billing" }` | Documents dont le tableau `tags` contient `billing` |
| `{ "lang": { "$in": ["en", "de"] } }` | Documents en anglais ou en allemand |
| `{ "$or": [{ "team": "support" }, { "year": { "$in": [2024, 2025] } }] }` | Documents de l'équipe support, ou tout document de 2024 ou 2025 |
| `{ "published_at": { "$gte": "2025-06-01" } }` | Documents publiés le 1er juin 2025 ou après |
| `{ "file_id": "report.pdf" }` | Un [fichier importé](https://docs.conare.ai/fr/files.md) |
| `{ "file_id": "report.pdf", "page": 3 }` | La page 3 de ce fichier |

## Règles

| Règle | |
| - | - |
| Égalité | Compare en texte : `3`, `3.0` et `"3"` correspondent entre eux |
| Plages | Nombres avec nombres, chaînes avec chaînes, octet par octet ; écrivez les dates en ISO 8601 dans un seul format (`2025-06-01` ou `2025-06-01T10:00:00Z`) |
| Jamais dans une plage | Booléens, éléments de tableau et chaînes de plus de 222 octets |
| Clés manquantes | Un document sans la clé correspond à `$ne` et `$nin` |
| Négations | Une négation qui exclut la plupart des documents peut renvoyer moins de résultats que `top_k` |
| Taille | Jusqu'à 256 conditions, imbriquées sur 8 niveaux au plus ; chaque `$and`, `$or` et `$in` multivaleur compte pour une |
| Listes | `$in` et `$nin` acceptent jusqu'à 255 valeurs |
| Clés inconnues | Ne sont pas vérifiées : une clé mal orthographiée ne correspond à rien |
| Erreurs | Un filtre invalide renvoie `400 invalid_filter` |


## Related topics

- [Obtenir, lister et supprimer des documents](https://docs.conare.ai/fr/documents.md)
- [Écrire des documents](https://docs.conare.ai/fr/write.md)
- [API turbopuffer](https://docs.conare.ai/fr/turbopuffer.md)
- [Démarrage rapide](https://docs.conare.ai/fr/quickstart.md)
- [MCP](https://docs.conare.ai/fr/mcp-server.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.