Skip to content

Commit abaadab

Browse files
committed
feat: add missing params
1 parent df256eb commit abaadab

File tree

1 file changed

+100
-0
lines changed

1 file changed

+100
-0
lines changed

openapi.yml

Lines changed: 100 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3142,6 +3142,14 @@ components:
31423142
type: string
31433143
example: "num_employees:>100 && country: [USA, UK]"
31443144

3145+
enable_lazy_filter:
3146+
description: >
3147+
Applies the filtering operation incrementally / lazily.
3148+
Set this to true when you are potentially filtering on large values
3149+
but the tokens in the query are expected to match very few documents.
3150+
Default: false
3151+
type: boolean
3152+
31453153
max_filter_by_candidates:
31463154
description:
31473155
Controls the number of similar words that Typesense considers during fuzzy search
@@ -3178,6 +3186,10 @@ components:
31783186
facet values that contain the prefix "shoe".
31793187
type: string
31803188

3189+
facet_query_num_typos:
3190+
description: Controls the fuzziness of the facet query filter. Default: 2.
3191+
type: integer
3192+
31813193
num_typos:
31823194
description: >
31833195
The number of typographical errors (1 or 2) that would be tolerated.
@@ -3223,6 +3235,12 @@ components:
32233235
Default: true
32243236
type: boolean
32253237

3238+
group_max_candidates:
3239+
description: >
3240+
Overrides the behavior of group_by queries where found value is an approximation.
3241+
When group_max_candidates is passed, found will be accurate up until its value.
3242+
type: integer
3243+
32263244
include_fields:
32273245
description: List of fields from the document to include in the search result
32283246
type: string
@@ -3309,6 +3327,11 @@ components:
33093327
type: boolean
33103328
description: >
33113329
Allow synonym resolution on word prefixes in the query. Default: false
3330+
demote_synonym_match:
3331+
type: boolean
3332+
description: >
3333+
When set to true, search results that matched via synonyms will be demoted in ranking,
3334+
appearing below results that have a direct match. Default: false
33123335
synonym_num_typos:
33133336
type: integer
33143337
description: >
@@ -3415,6 +3438,11 @@ components:
34153438
Typesense will attempt to return results early if the cutoff time has elapsed.
34163439
This is not a strict guarantee and facet computation is not bound by this parameter.
34173440
type: integer
3441+
limit_hits:
3442+
description: >
3443+
Maximum number of hits that can be fetched from the collection.
3444+
page * per_page should be less than this number for the search request to return results.
3445+
type: integer
34183446
use_cache:
34193447
description: >
34203448
Enable server side caching of search query results. By default, caching is disabled.
@@ -3460,10 +3488,29 @@ components:
34603488
description: >
34613489
Comma separated string of nested facet fields whose parent object should be returned in facet response.
34623490
type: string
3491+
facet_sample_percent:
3492+
description: >
3493+
Percentage of hits that will be used to estimate facet counts. Default: 100.
3494+
type: integer
3495+
facet_sample_threshold:
3496+
description: >
3497+
Minimum number of hits above which the facet counts are sampled. Default: 0.
3498+
type: integer
3499+
facet_sample_slope:
3500+
description: >
3501+
Controls how steeply facet_sample_percent falls as the collection grows.
3502+
facet_sample_threshold should be non-zero for facet_sample_slope to be effective.
3503+
Default: 0.
3504+
type: number
34633505
voice_query:
34643506
description: >
34653507
The base64 encoded audio file in 16 khz 16-bit WAV format.
34663508
type: string
3509+
validate_field_names:
3510+
description: >
3511+
Controls whether Typesense should validate if the referenced fields exist in the schema.
3512+
When set to false, Typesense will not throw an error if a field is missing. Default: true
3513+
type: boolean
34673514
conversation:
34683515
description: >
34693516
Enable conversational search.
@@ -3545,6 +3592,20 @@ components:
35453592
type: string
35463593
example: "num_employees:>100 && country: [USA, UK]"
35473594

3595+
enable_lazy_filter:
3596+
description: >
3597+
Applies the filtering operation incrementally / lazily.
3598+
Set this to true when you are potentially filtering on large values
3599+
but the tokens in the query are expected to match very few documents.
3600+
Default: false
3601+
type: boolean
3602+
3603+
max_filter_by_candidates:
3604+
description:
3605+
Controls the number of similar words that Typesense considers during fuzzy search
3606+
on filter_by values. Useful for controlling prefix matches like company_name:Acm*.
3607+
type: integer
3608+
35483609
sort_by:
35493610
description:
35503611
A list of numerical fields and their corresponding sort orders
@@ -3574,6 +3635,10 @@ components:
35743635
facet values that contain the prefix "shoe".
35753636
type: string
35763637

3638+
facet_query_num_typos:
3639+
description: Controls the fuzziness of the facet query filter. Default: 2.
3640+
type: integer
3641+
35773642
num_typos:
35783643
description: >
35793644
The number of typographical errors (1 or 2) that would be tolerated.
@@ -3619,6 +3684,12 @@ components:
36193684
Default: true
36203685
type: boolean
36213686

3687+
group_max_candidates:
3688+
description: >
3689+
Overrides the behavior of group_by queries where found value is an approximation.
3690+
When group_max_candidates is passed, found will be accurate up until its value.
3691+
type: integer
3692+
36223693
include_fields:
36233694
description: List of fields from the document to include in the search result
36243695
type: string
@@ -3694,6 +3765,11 @@ components:
36943765
type: boolean
36953766
description: >
36963767
Allow synonym resolution on word prefixes in the query. Default: false
3768+
demote_synonym_match:
3769+
type: boolean
3770+
description: >
3771+
When set to true, search results that matched via synonyms will be demoted in ranking,
3772+
appearing below results that have a direct match. Default: false
36973773
synonym_num_typos:
36983774
type: integer
36993775
description: >
@@ -3801,6 +3877,11 @@ components:
38013877
Typesense will attempt to return results early if the cutoff time has elapsed.
38023878
This is not a strict guarantee and facet computation is not bound by this parameter.
38033879
type: integer
3880+
limit_hits:
3881+
description: >
3882+
Maximum number of hits that can be fetched from the collection.
3883+
page * per_page should be less than this number for the search request to return results.
3884+
type: integer
38043885
use_cache:
38053886
description: >
38063887
Enable server side caching of search query results. By default, caching is disabled.
@@ -3846,10 +3927,29 @@ components:
38463927
description: >
38473928
Comma separated string of nested facet fields whose parent object should be returned in facet response.
38483929
type: string
3930+
facet_sample_percent:
3931+
description: >
3932+
Percentage of hits that will be used to estimate facet counts. Default: 100.
3933+
type: integer
3934+
facet_sample_threshold:
3935+
description: >
3936+
Minimum number of hits above which the facet counts are sampled. Default: 0.
3937+
type: integer
3938+
facet_sample_slope:
3939+
description: >
3940+
Controls how steeply facet_sample_percent falls as the collection grows.
3941+
facet_sample_threshold should be non-zero for facet_sample_slope to be effective.
3942+
Default: 0.
3943+
type: number
38493944
voice_query:
38503945
description: >
38513946
The base64 encoded audio file in 16 khz 16-bit WAV format.
38523947
type: string
3948+
validate_field_names:
3949+
description: >
3950+
Controls whether Typesense should validate if the referenced fields exist in the schema.
3951+
When set to false, Typesense will not throw an error if a field is missing. Default: true
3952+
type: boolean
38533953
conversation:
38543954
description: >
38553955
Enable conversational search.

0 commit comments

Comments
 (0)