## Search documents `search.execute(SearchExecuteParams**kwargs) -> SearchExecuteResponse` **post** `/v3/search` Search memories with advanced filtering ### Parameters - `q: str` Search query string - `categories_filter: Optional[Sequence[str]]` DEPRECATED: Optional category filters - `chunk_threshold: Optional[float]` Threshold / sensitivity for chunk selection. 0 is least sensitive (returns most chunks, more results), 1 is most sensitive (returns lesser chunks, accurate results) - `container_tag: Optional[str]` Optional single container tag. Use this or containerTags. - `container_tags: Optional[Sequence[str]]` Optional tags this search should be containerized by. This can be an ID for your user, a project ID, or any other identifier you wish to use to filter documents. - `doc_id: Optional[str]` Optional document ID to search within. You can use this to find chunks in a very large document. - `document_threshold: Optional[float]` DEPRECATED: This field is no longer used in v3 search. The search now uses chunkThreshold only. This parameter will be ignored. - `filepath: Optional[str]` Filter search results by filepath. Exact match for full paths, prefix match if ending with / - `filters: Optional[Filters]` Optional filters to apply to the search. Can be a JSON string or Query object. - `class FiltersOr: …` - `or_: Iterable[FiltersOrOr]` Array of OR filter expressions - `class FiltersOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOr: …` - `or_: Iterable[FiltersOrOrOrOr]` OR: Array of conditions or nested expressions - `class FiltersOrOrOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrOr: …` - `or_: Iterable[FiltersOrOrOrOrOrOr]` OR: Array of conditions or nested expressions - `class FiltersOrOrOrOrOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrOrOrOr: …` - `or_: Iterable[FiltersOrOrOrOrOrOrOrOr]` OR: Array of conditions or nested expressions - `class FiltersOrOrOrOrOrOrOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrOrOrOrOrOr: …` - `or_: Iterable[FiltersOrOrOrOrOrOrOrOrOrOr]` OR: Array of conditions or nested expressions - `class FiltersOrOrOrOrOrOrOrOrOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrOrOrOrOrOrOrOr: …` - `or_: Iterable[FiltersOrOrOrOrOrOrOrOrOrOrOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrOrOrOrOrOrOrAnd: …` - `and_: Iterable[FiltersOrOrOrOrOrOrOrOrOrOrAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrOrOrOrOrAnd: …` - `and_: Iterable[FiltersOrOrOrOrOrOrOrOrAndAnd]` AND: Array of conditions or nested expressions - `class FiltersOrOrOrOrOrOrOrOrAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrOrOrOrOrAndAndOr: …` - `or_: Iterable[FiltersOrOrOrOrOrOrOrOrAndAndOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrOrOrOrOrAndAndAnd: …` - `and_: Iterable[FiltersOrOrOrOrOrOrOrOrAndAndAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrOrOrAnd: …` - `and_: Iterable[FiltersOrOrOrOrOrOrAndAnd]` AND: Array of conditions or nested expressions - `class FiltersOrOrOrOrOrOrAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrOrOrAndAndOr: …` - `or_: Iterable[FiltersOrOrOrOrOrOrAndAndOrOr]` OR: Array of conditions or nested expressions - `class FiltersOrOrOrOrOrOrAndAndOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrOrOrAndAndOrOrOr: …` - `or_: Iterable[FiltersOrOrOrOrOrOrAndAndOrOrOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrOrOrAndAndOrOrAnd: …` - `and_: Iterable[FiltersOrOrOrOrOrOrAndAndOrOrAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrOrOrAndAndAnd: …` - `and_: Iterable[FiltersOrOrOrOrOrOrAndAndAndAnd]` AND: Array of conditions or nested expressions - `class FiltersOrOrOrOrOrOrAndAndAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrOrOrAndAndAndAndOr: …` - `or_: Iterable[FiltersOrOrOrOrOrOrAndAndAndAndOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrOrOrAndAndAndAndAnd: …` - `and_: Iterable[FiltersOrOrOrOrOrOrAndAndAndAndAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrAnd: …` - `and_: Iterable[FiltersOrOrOrOrAndAnd]` AND: Array of conditions or nested expressions - `class FiltersOrOrOrOrAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrAndAndOr: …` - `or_: Iterable[FiltersOrOrOrOrAndAndOrOr]` OR: Array of conditions or nested expressions - `class FiltersOrOrOrOrAndAndOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrAndAndOrOrOr: …` - `or_: Iterable[FiltersOrOrOrOrAndAndOrOrOrOr]` OR: Array of conditions or nested expressions - `class FiltersOrOrOrOrAndAndOrOrOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrAndAndOrOrOrOrOr: …` - `or_: Iterable[FiltersOrOrOrOrAndAndOrOrOrOrOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrAndAndOrOrOrOrAnd: …` - `and_: Iterable[FiltersOrOrOrOrAndAndOrOrOrOrAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrAndAndOrOrAnd: …` - `and_: Iterable[FiltersOrOrOrOrAndAndOrOrAndAnd]` AND: Array of conditions or nested expressions - `class FiltersOrOrOrOrAndAndOrOrAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrAndAndOrOrAndAndOr: …` - `or_: Iterable[FiltersOrOrOrOrAndAndOrOrAndAndOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrAndAndOrOrAndAndAnd: …` - `and_: Iterable[FiltersOrOrOrOrAndAndOrOrAndAndAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrAndAndAnd: …` - `and_: Iterable[FiltersOrOrOrOrAndAndAndAnd]` AND: Array of conditions or nested expressions - `class FiltersOrOrOrOrAndAndAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrAndAndAndAndOr: …` - `or_: Iterable[FiltersOrOrOrOrAndAndAndAndOrOr]` OR: Array of conditions or nested expressions - `class FiltersOrOrOrOrAndAndAndAndOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrAndAndAndAndOrOrOr: …` - `or_: Iterable[FiltersOrOrOrOrAndAndAndAndOrOrOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrAndAndAndAndOrOrAnd: …` - `and_: Iterable[FiltersOrOrOrOrAndAndAndAndOrOrAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrAndAndAndAndAnd: …` - `and_: Iterable[FiltersOrOrOrOrAndAndAndAndAndAnd]` AND: Array of conditions or nested expressions - `class FiltersOrOrOrOrAndAndAndAndAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrAndAndAndAndAndAndOr: …` - `or_: Iterable[FiltersOrOrOrOrAndAndAndAndAndAndOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrOrOrAndAndAndAndAndAndAnd: …` - `and_: Iterable[FiltersOrOrOrOrAndAndAndAndAndAndAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAnd: …` - `and_: Iterable[FiltersOrOrAndAnd]` AND: Array of conditions or nested expressions - `class FiltersOrOrAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndOr: …` - `or_: Iterable[FiltersOrOrAndAndOrOr]` OR: Array of conditions or nested expressions - `class FiltersOrOrAndAndOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndOrOrOr: …` - `or_: Iterable[FiltersOrOrAndAndOrOrOrOr]` OR: Array of conditions or nested expressions - `class FiltersOrOrAndAndOrOrOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndOrOrOrOrOr: …` - `or_: Iterable[FiltersOrOrAndAndOrOrOrOrOrOr]` OR: Array of conditions or nested expressions - `class FiltersOrOrAndAndOrOrOrOrOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndOrOrOrOrOrOrOr: …` - `or_: Iterable[FiltersOrOrAndAndOrOrOrOrOrOrOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndOrOrOrOrOrOrAnd: …` - `and_: Iterable[FiltersOrOrAndAndOrOrOrOrOrOrAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndOrOrOrOrAnd: …` - `and_: Iterable[FiltersOrOrAndAndOrOrOrOrAndAnd]` AND: Array of conditions or nested expressions - `class FiltersOrOrAndAndOrOrOrOrAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndOrOrOrOrAndAndOr: …` - `or_: Iterable[FiltersOrOrAndAndOrOrOrOrAndAndOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndOrOrOrOrAndAndAnd: …` - `and_: Iterable[FiltersOrOrAndAndOrOrOrOrAndAndAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndOrOrAnd: …` - `and_: Iterable[FiltersOrOrAndAndOrOrAndAnd]` AND: Array of conditions or nested expressions - `class FiltersOrOrAndAndOrOrAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndOrOrAndAndOr: …` - `or_: Iterable[FiltersOrOrAndAndOrOrAndAndOrOr]` OR: Array of conditions or nested expressions - `class FiltersOrOrAndAndOrOrAndAndOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndOrOrAndAndOrOrOr: …` - `or_: Iterable[FiltersOrOrAndAndOrOrAndAndOrOrOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndOrOrAndAndOrOrAnd: …` - `and_: Iterable[FiltersOrOrAndAndOrOrAndAndOrOrAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndOrOrAndAndAnd: …` - `and_: Iterable[FiltersOrOrAndAndOrOrAndAndAndAnd]` AND: Array of conditions or nested expressions - `class FiltersOrOrAndAndOrOrAndAndAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndOrOrAndAndAndAndOr: …` - `or_: Iterable[FiltersOrOrAndAndOrOrAndAndAndAndOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndOrOrAndAndAndAndAnd: …` - `and_: Iterable[FiltersOrOrAndAndOrOrAndAndAndAndAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndAnd: …` - `and_: Iterable[FiltersOrOrAndAndAndAnd]` AND: Array of conditions or nested expressions - `class FiltersOrOrAndAndAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndAndAndOr: …` - `or_: Iterable[FiltersOrOrAndAndAndAndOrOr]` OR: Array of conditions or nested expressions - `class FiltersOrOrAndAndAndAndOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndAndAndOrOrOr: …` - `or_: Iterable[FiltersOrOrAndAndAndAndOrOrOrOr]` OR: Array of conditions or nested expressions - `class FiltersOrOrAndAndAndAndOrOrOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndAndAndOrOrOrOrOr: …` - `or_: Iterable[FiltersOrOrAndAndAndAndOrOrOrOrOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndAndAndOrOrOrOrAnd: …` - `and_: Iterable[FiltersOrOrAndAndAndAndOrOrOrOrAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndAndAndOrOrAnd: …` - `and_: Iterable[FiltersOrOrAndAndAndAndOrOrAndAnd]` AND: Array of conditions or nested expressions - `class FiltersOrOrAndAndAndAndOrOrAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndAndAndOrOrAndAndOr: …` - `or_: Iterable[FiltersOrOrAndAndAndAndOrOrAndAndOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndAndAndOrOrAndAndAnd: …` - `and_: Iterable[FiltersOrOrAndAndAndAndOrOrAndAndAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndAndAndAnd: …` - `and_: Iterable[FiltersOrOrAndAndAndAndAndAnd]` AND: Array of conditions or nested expressions - `class FiltersOrOrAndAndAndAndAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndAndAndAndAndOr: …` - `or_: Iterable[FiltersOrOrAndAndAndAndAndAndOrOr]` OR: Array of conditions or nested expressions - `class FiltersOrOrAndAndAndAndAndAndOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndAndAndAndAndOrOrOr: …` - `or_: Iterable[FiltersOrOrAndAndAndAndAndAndOrOrOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndAndAndAndAndOrOrAnd: …` - `and_: Iterable[FiltersOrOrAndAndAndAndAndAndOrOrAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndAndAndAndAndAnd: …` - `and_: Iterable[FiltersOrOrAndAndAndAndAndAndAndAnd]` AND: Array of conditions or nested expressions - `class FiltersOrOrAndAndAndAndAndAndAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndAndAndAndAndAndAndOr: …` - `or_: Iterable[FiltersOrOrAndAndAndAndAndAndAndAndOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersOrOrAndAndAndAndAndAndAndAndAnd: …` - `and_: Iterable[FiltersOrOrAndAndAndAndAndAndAndAndAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAnd: …` - `and_: Iterable[FiltersAndAnd]` Array of AND filter expressions - `class FiltersAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOr: …` - `or_: Iterable[FiltersAndAndOrOr]` OR: Array of conditions or nested expressions - `class FiltersAndAndOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrOr: …` - `or_: Iterable[FiltersAndAndOrOrOrOr]` OR: Array of conditions or nested expressions - `class FiltersAndAndOrOrOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrOrOrOr: …` - `or_: Iterable[FiltersAndAndOrOrOrOrOrOr]` OR: Array of conditions or nested expressions - `class FiltersAndAndOrOrOrOrOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrOrOrOrOrOr: …` - `or_: Iterable[FiltersAndAndOrOrOrOrOrOrOrOr]` OR: Array of conditions or nested expressions - `class FiltersAndAndOrOrOrOrOrOrOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrOrOrOrOrOrOrOr: …` - `or_: Iterable[FiltersAndAndOrOrOrOrOrOrOrOrOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrOrOrOrOrOrOrAnd: …` - `and_: Iterable[FiltersAndAndOrOrOrOrOrOrOrOrAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrOrOrOrOrAnd: …` - `and_: Iterable[FiltersAndAndOrOrOrOrOrOrAndAnd]` AND: Array of conditions or nested expressions - `class FiltersAndAndOrOrOrOrOrOrAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrOrOrOrOrAndAndOr: …` - `or_: Iterable[FiltersAndAndOrOrOrOrOrOrAndAndOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrOrOrOrOrAndAndAnd: …` - `and_: Iterable[FiltersAndAndOrOrOrOrOrOrAndAndAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrOrOrAnd: …` - `and_: Iterable[FiltersAndAndOrOrOrOrAndAnd]` AND: Array of conditions or nested expressions - `class FiltersAndAndOrOrOrOrAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrOrOrAndAndOr: …` - `or_: Iterable[FiltersAndAndOrOrOrOrAndAndOrOr]` OR: Array of conditions or nested expressions - `class FiltersAndAndOrOrOrOrAndAndOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrOrOrAndAndOrOrOr: …` - `or_: Iterable[FiltersAndAndOrOrOrOrAndAndOrOrOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrOrOrAndAndOrOrAnd: …` - `and_: Iterable[FiltersAndAndOrOrOrOrAndAndOrOrAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrOrOrAndAndAnd: …` - `and_: Iterable[FiltersAndAndOrOrOrOrAndAndAndAnd]` AND: Array of conditions or nested expressions - `class FiltersAndAndOrOrOrOrAndAndAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrOrOrAndAndAndAndOr: …` - `or_: Iterable[FiltersAndAndOrOrOrOrAndAndAndAndOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrOrOrAndAndAndAndAnd: …` - `and_: Iterable[FiltersAndAndOrOrOrOrAndAndAndAndAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrAnd: …` - `and_: Iterable[FiltersAndAndOrOrAndAnd]` AND: Array of conditions or nested expressions - `class FiltersAndAndOrOrAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrAndAndOr: …` - `or_: Iterable[FiltersAndAndOrOrAndAndOrOr]` OR: Array of conditions or nested expressions - `class FiltersAndAndOrOrAndAndOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrAndAndOrOrOr: …` - `or_: Iterable[FiltersAndAndOrOrAndAndOrOrOrOr]` OR: Array of conditions or nested expressions - `class FiltersAndAndOrOrAndAndOrOrOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrAndAndOrOrOrOrOr: …` - `or_: Iterable[FiltersAndAndOrOrAndAndOrOrOrOrOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrAndAndOrOrOrOrAnd: …` - `and_: Iterable[FiltersAndAndOrOrAndAndOrOrOrOrAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrAndAndOrOrAnd: …` - `and_: Iterable[FiltersAndAndOrOrAndAndOrOrAndAnd]` AND: Array of conditions or nested expressions - `class FiltersAndAndOrOrAndAndOrOrAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrAndAndOrOrAndAndOr: …` - `or_: Iterable[FiltersAndAndOrOrAndAndOrOrAndAndOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrAndAndOrOrAndAndAnd: …` - `and_: Iterable[FiltersAndAndOrOrAndAndOrOrAndAndAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrAndAndAnd: …` - `and_: Iterable[FiltersAndAndOrOrAndAndAndAnd]` AND: Array of conditions or nested expressions - `class FiltersAndAndOrOrAndAndAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrAndAndAndAndOr: …` - `or_: Iterable[FiltersAndAndOrOrAndAndAndAndOrOr]` OR: Array of conditions or nested expressions - `class FiltersAndAndOrOrAndAndAndAndOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrAndAndAndAndOrOrOr: …` - `or_: Iterable[FiltersAndAndOrOrAndAndAndAndOrOrOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrAndAndAndAndOrOrAnd: …` - `and_: Iterable[FiltersAndAndOrOrAndAndAndAndOrOrAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrAndAndAndAndAnd: …` - `and_: Iterable[FiltersAndAndOrOrAndAndAndAndAndAnd]` AND: Array of conditions or nested expressions - `class FiltersAndAndOrOrAndAndAndAndAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrAndAndAndAndAndAndOr: …` - `or_: Iterable[FiltersAndAndOrOrAndAndAndAndAndAndOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndOrOrAndAndAndAndAndAndAnd: …` - `and_: Iterable[FiltersAndAndOrOrAndAndAndAndAndAndAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAnd: …` - `and_: Iterable[FiltersAndAndAndAnd]` AND: Array of conditions or nested expressions - `class FiltersAndAndAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndOr: …` - `or_: Iterable[FiltersAndAndAndAndOrOr]` OR: Array of conditions or nested expressions - `class FiltersAndAndAndAndOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndOrOrOr: …` - `or_: Iterable[FiltersAndAndAndAndOrOrOrOr]` OR: Array of conditions or nested expressions - `class FiltersAndAndAndAndOrOrOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndOrOrOrOrOr: …` - `or_: Iterable[FiltersAndAndAndAndOrOrOrOrOrOr]` OR: Array of conditions or nested expressions - `class FiltersAndAndAndAndOrOrOrOrOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndOrOrOrOrOrOrOr: …` - `or_: Iterable[FiltersAndAndAndAndOrOrOrOrOrOrOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndOrOrOrOrOrOrAnd: …` - `and_: Iterable[FiltersAndAndAndAndOrOrOrOrOrOrAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndOrOrOrOrAnd: …` - `and_: Iterable[FiltersAndAndAndAndOrOrOrOrAndAnd]` AND: Array of conditions or nested expressions - `class FiltersAndAndAndAndOrOrOrOrAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndOrOrOrOrAndAndOr: …` - `or_: Iterable[FiltersAndAndAndAndOrOrOrOrAndAndOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndOrOrOrOrAndAndAnd: …` - `and_: Iterable[FiltersAndAndAndAndOrOrOrOrAndAndAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndOrOrAnd: …` - `and_: Iterable[FiltersAndAndAndAndOrOrAndAnd]` AND: Array of conditions or nested expressions - `class FiltersAndAndAndAndOrOrAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndOrOrAndAndOr: …` - `or_: Iterable[FiltersAndAndAndAndOrOrAndAndOrOr]` OR: Array of conditions or nested expressions - `class FiltersAndAndAndAndOrOrAndAndOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndOrOrAndAndOrOrOr: …` - `or_: Iterable[FiltersAndAndAndAndOrOrAndAndOrOrOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndOrOrAndAndOrOrAnd: …` - `and_: Iterable[FiltersAndAndAndAndOrOrAndAndOrOrAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndOrOrAndAndAnd: …` - `and_: Iterable[FiltersAndAndAndAndOrOrAndAndAndAnd]` AND: Array of conditions or nested expressions - `class FiltersAndAndAndAndOrOrAndAndAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndOrOrAndAndAndAndOr: …` - `or_: Iterable[FiltersAndAndAndAndOrOrAndAndAndAndOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndOrOrAndAndAndAndAnd: …` - `and_: Iterable[FiltersAndAndAndAndOrOrAndAndAndAndAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndAnd: …` - `and_: Iterable[FiltersAndAndAndAndAndAnd]` AND: Array of conditions or nested expressions - `class FiltersAndAndAndAndAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndAndAndOr: …` - `or_: Iterable[FiltersAndAndAndAndAndAndOrOr]` OR: Array of conditions or nested expressions - `class FiltersAndAndAndAndAndAndOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndAndAndOrOrOr: …` - `or_: Iterable[FiltersAndAndAndAndAndAndOrOrOrOr]` OR: Array of conditions or nested expressions - `class FiltersAndAndAndAndAndAndOrOrOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndAndAndOrOrOrOrOr: …` - `or_: Iterable[FiltersAndAndAndAndAndAndOrOrOrOrOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndAndAndOrOrOrOrAnd: …` - `and_: Iterable[FiltersAndAndAndAndAndAndOrOrOrOrAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndAndAndOrOrAnd: …` - `and_: Iterable[FiltersAndAndAndAndAndAndOrOrAndAnd]` AND: Array of conditions or nested expressions - `class FiltersAndAndAndAndAndAndOrOrAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndAndAndOrOrAndAndOr: …` - `or_: Iterable[FiltersAndAndAndAndAndAndOrOrAndAndOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndAndAndOrOrAndAndAnd: …` - `and_: Iterable[FiltersAndAndAndAndAndAndOrOrAndAndAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndAndAndAnd: …` - `and_: Iterable[FiltersAndAndAndAndAndAndAndAnd]` AND: Array of conditions or nested expressions - `class FiltersAndAndAndAndAndAndAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndAndAndAndAndOr: …` - `or_: Iterable[FiltersAndAndAndAndAndAndAndAndOrOr]` OR: Array of conditions or nested expressions - `class FiltersAndAndAndAndAndAndAndAndOrOrUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndAndAndAndAndOrOrOr: …` - `or_: Iterable[FiltersAndAndAndAndAndAndAndAndOrOrOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndAndAndAndAndOrOrAnd: …` - `and_: Iterable[FiltersAndAndAndAndAndAndAndAndOrOrAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndAndAndAndAndAnd: …` - `and_: Iterable[FiltersAndAndAndAndAndAndAndAndAndAnd]` AND: Array of conditions or nested expressions - `class FiltersAndAndAndAndAndAndAndAndAndAndUnionMember0: …` A single filter condition based on metadata, numeric values, array contents, or string matching - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndAndAndAndAndAndAndOr: …` - `or_: Iterable[FiltersAndAndAndAndAndAndAndAndAndAndOrOr]` OR: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `class FiltersAndAndAndAndAndAndAndAndAndAndAnd: …` - `and_: Iterable[FiltersAndAndAndAndAndAndAndAndAndAndAndAnd]` AND: Array of conditions - `key: str` - `value: str` - `filter_type: Optional[Literal["metadata", "numeric", "array_contains", "string_contains"]]` - `"metadata"` - `"numeric"` - `"array_contains"` - `"string_contains"` - `ignore_case: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `negate: Optional[Union[bool, Literal["true", "false"]]]` - `bool` - `Literal["true", "false"]` - `"true"` - `"false"` - `numeric_operator: Optional[Literal[">", "<", ">=", 2 more]]` - `">"` - `"<"` - `">="` - `"<="` - `"="` - `include_full_docs: Optional[bool]` If true, include full document in the response. This is helpful if you want a chatbot to know the full context of the document. - `include_summary: Optional[bool]` If true, include document summary in the response. This is helpful if you want a chatbot to know the full context of the document. - `limit: Optional[int]` Maximum number of results to return - `only_matching_chunks: Optional[bool]` If true, only return matching chunks without context. Normally, we send the previous and next chunk to provide more context for LLMs. If you only want the matching chunk, set this to true. - `rerank: Optional[bool]` If true, rerank the results based on the query. This is helpful if you want to ensure the most relevant results are returned. - `rewrite_query: Optional[bool]` If true, rewrites the query to make it easier to find documents. This increases the latency by about 400ms ### Returns - `class SearchExecuteResponse: …` - `results: List[Result]` - `chunks: List[ResultChunk]` Matching content chunks from the document - `content: str` Content of the matching chunk - `is_relevant: bool` Whether this chunk is relevant to the query - `score: float` Similarity score for this chunk - `created_at: str` Document creation date - `document_id: str` ID of the matching document - `metadata: Optional[Dict[str, object]]` Document metadata - `score: float` Relevance score of the match - `title: Optional[str]` Document title - `type: Optional[str]` Document type - `updated_at: str` Document last update date - `content: Optional[str]` Full document content (only included when includeFullDocs=true) - `summary: Optional[str]` Document summary - `timing: float` - `total: float` ### Example ```python import os from supermemory import Supermemory client = Supermemory( api_key=os.environ.get("SUPERMEMORY_API_KEY"), # This is the default and can be omitted ) response = client.search.execute( q="what are the API rate limits", ) print(response.results) ``` #### Response ```json { "results": [ { "chunks": [ { "content": "Rate limit headers are included in every response. Clients should implement exponential backoff when receiving 429 responses.", "isRelevant": true, "score": 0.85 } ], "createdAt": "1970-01-01T00:00:00.000Z", "documentId": "doc_xyz789", "metadata": { "source": "bar", "language": "bar" }, "score": 0.95, "title": "API Rate Limiting Policy", "type": "web", "updatedAt": "1970-01-01T00:00:00.000Z", "content": "Our API rate limits are 100 req/min on free and 1000 on pro. Clients should use exponential backoff on 429s.", "summary": "API rate limit policy: 100 req/min free, 1000 req/min pro." } ], "timing": 0, "total": 0 } ```