> ## 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.

# Filter

> Grenzen Sie Suchen und Löschvorgänge mit Filtern nach Dokumentmetadaten ein: Operatoren wie $in, $gte und $or, Beispiele und Regeln für Vergleiche.

Übergeben Sie einen Filter als `filter` an eine [Suche](https://docs.conare.ai/de/query.md) oder einen [Löschvorgang](https://docs.conare.ai/de/documents.md#mehrere-löschen), um Dokumente anhand ihrer [Metadaten](https://docs.conare.ai/de/write.md#metadaten) abzugleichen.

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

Nebeneinander stehende Schlüssel müssen alle zutreffen.

## Operatoren

| Operator | Trifft zu auf |
| - | - |
| `{ "key": value }`, `$eq` | Gleich dem Wert; bei einem Array: enthält den Wert |
| `$in` | Gleich einem beliebigen Wert aus einer Liste |
| `$ne`, `$nin` | Ungleich dem Wert oder jedem Wert einer Liste (nur bei Suchen) |
| `$gt`, `$gte`, `$lt`, `$lte` | Größer als, mindestens, kleiner als, höchstens |
| `$and`, `$or` | Alle oder einen beliebigen aus einer Liste von Filtern |

## Beispiele

| Filter | Trifft zu auf |
| - | - |
| `{ "tags": "billing" }` | Dokumente, deren `tags`-Array `billing` enthält |
| `{ "lang": { "$in": ["en", "de"] } }` | Englische oder deutsche Dokumente |
| `{ "$or": [{ "team": "support" }, { "year": { "$in": [2024, 2025] } }] }` | Dokumente des Supports oder beliebige aus 2024 oder 2025 |
| `{ "published_at": { "$gte": "2025-06-01" } }` | Dokumente, die am oder nach dem 1. Juni 2025 veröffentlicht wurden |
| `{ "file_id": "report.pdf" }` | Eine [hochgeladene Datei](https://docs.conare.ai/de/files.md) |
| `{ "file_id": "report.pdf", "page": 3 }` | Seite 3 dieser Datei |

## Regeln

| Regel | |
| - | - |
| Gleichheit | Vergleicht als Text: `3`, `3.0` und `"3"` stimmen miteinander überein |
| Bereiche | Zahlen mit Zahlen, Strings mit Strings, Byte für Byte; schreiben Sie Datumsangaben als ISO 8601 in einem Format (`2025-06-01` oder `2025-06-01T10:00:00Z`) |
| Nie in einem Bereich | Boolesche Werte, Array-Elemente und Strings über 222 Bytes |
| Fehlende Schlüssel | Ein Dokument ohne den Schlüssel trifft auf `$ne` und `$nin` zu |
| Negationen | Eine, die die meisten Dokumente ausschließt, kann weniger Ergebnisse als `top_k` liefern |
| Größe | Bis zu 256 Bedingungen, bis zu 8 Ebenen verschachtelt; jedes `$and`, `$or` und mehrwertige `$in` zählt als eine |
| Listen | `$in` und `$nin` akzeptieren bis zu 255 Werte |
| Unbekannte Schlüssel | Werden nicht geprüft: Ein falsch geschriebener Schlüssel trifft auf nichts zu |
| Fehler | Ein ungültiger Filter gibt `400 invalid_filter` zurück |


## Related topics

- [Delete documents by id or filter](https://docs.conare.ai/de/api-reference/documents/delete-documents-by-id-or-filter.md)
- [Dokumente abrufen, auflisten und löschen](https://docs.conare.ai/de/documents.md)
- [Dokumente schreiben](https://docs.conare.ai/de/write.md)
- [turbopuffer API](https://docs.conare.ai/de/turbopuffer.md)
- [Query every namespace](https://docs.conare.ai/de/api-reference/query/query-every-namespace.md)


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