Skip to content

Commit e5f7885

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

File tree

1 file changed

+92
-0
lines changed

1 file changed

+92
-0
lines changed

openapi.yml

Lines changed: 92 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,11 @@ components:
31783186
facet values that contain the prefix "shoe".
31793187
type: string
31803188

3189+
facet_query_num_typos:
3190+
description: >
3191+
Controls the fuzziness of the facet query filter. Default: 2.
3192+
type: integer
3193+
31813194
num_typos:
31823195
description: >
31833196
The number of typographical errors (1 or 2) that would be tolerated.
@@ -3223,6 +3236,12 @@ components:
32233236
Default: true
32243237
type: boolean
32253238

3239+
group_max_candidates:
3240+
description: >
3241+
Overrides the behavior of group_by queries where found value is an approximation.
3242+
When group_max_candidates is passed, found will be accurate up until its value.
3243+
type: integer
3244+
32263245
include_fields:
32273246
description: List of fields from the document to include in the search result
32283247
type: string
@@ -3309,6 +3328,11 @@ components:
33093328
type: boolean
33103329
description: >
33113330
Allow synonym resolution on word prefixes in the query. Default: false
3331+
demote_synonym_match:
3332+
type: boolean
3333+
description: >
3334+
When set to true, search results that matched via synonyms will be demoted in ranking,
3335+
appearing below results that have a direct match. Default: false
33123336
synonym_num_typos:
33133337
type: integer
33143338
description: >
@@ -3415,6 +3439,11 @@ components:
34153439
Typesense will attempt to return results early if the cutoff time has elapsed.
34163440
This is not a strict guarantee and facet computation is not bound by this parameter.
34173441
type: integer
3442+
limit_hits:
3443+
description: >
3444+
Maximum number of hits that can be fetched from the collection.
3445+
page * per_page should be less than this number for the search request to return results.
3446+
type: integer
34183447
use_cache:
34193448
description: >
34203449
Enable server side caching of search query results. By default, caching is disabled.
@@ -3460,6 +3489,20 @@ components:
34603489
description: >
34613490
Comma separated string of nested facet fields whose parent object should be returned in facet response.
34623491
type: string
3492+
facet_sample_percent:
3493+
description: >
3494+
Percentage of hits that will be used to estimate facet counts. Default: 100.
3495+
type: integer
3496+
facet_sample_threshold:
3497+
description: >
3498+
Minimum number of hits above which the facet counts are sampled. Default: 0.
3499+
type: integer
3500+
facet_sample_slope:
3501+
description: >
3502+
Controls how steeply facet_sample_percent falls as the collection grows.
3503+
facet_sample_threshold should be non-zero for facet_sample_slope to be effective.
3504+
Default: 0.
3505+
type: number
34633506
voice_query:
34643507
description: >
34653508
The base64 encoded audio file in 16 khz 16-bit WAV format.
@@ -3545,6 +3588,20 @@ components:
35453588
type: string
35463589
example: "num_employees:>100 && country: [USA, UK]"
35473590

3591+
enable_lazy_filter:
3592+
description: >
3593+
Applies the filtering operation incrementally / lazily.
3594+
Set this to true when you are potentially filtering on large values
3595+
but the tokens in the query are expected to match very few documents.
3596+
Default: false
3597+
type: boolean
3598+
3599+
max_filter_by_candidates:
3600+
description:
3601+
Controls the number of similar words that Typesense considers during fuzzy search
3602+
on filter_by values. Useful for controlling prefix matches like company_name:Acm*.
3603+
type: integer
3604+
35483605
sort_by:
35493606
description:
35503607
A list of numerical fields and their corresponding sort orders
@@ -3574,6 +3631,11 @@ components:
35743631
facet values that contain the prefix "shoe".
35753632
type: string
35763633

3634+
facet_query_num_typos:
3635+
description: >
3636+
Controls the fuzziness of the facet query filter. Default: 2.
3637+
type: integer
3638+
35773639
num_typos:
35783640
description: >
35793641
The number of typographical errors (1 or 2) that would be tolerated.
@@ -3619,6 +3681,12 @@ components:
36193681
Default: true
36203682
type: boolean
36213683

3684+
group_max_candidates:
3685+
description: >
3686+
Overrides the behavior of group_by queries where found value is an approximation.
3687+
When group_max_candidates is passed, found will be accurate up until its value.
3688+
type: integer
3689+
36223690
include_fields:
36233691
description: List of fields from the document to include in the search result
36243692
type: string
@@ -3694,6 +3762,11 @@ components:
36943762
type: boolean
36953763
description: >
36963764
Allow synonym resolution on word prefixes in the query. Default: false
3765+
demote_synonym_match:
3766+
type: boolean
3767+
description: >
3768+
When set to true, search results that matched via synonyms will be demoted in ranking,
3769+
appearing below results that have a direct match. Default: false
36973770
synonym_num_typos:
36983771
type: integer
36993772
description: >
@@ -3801,6 +3874,11 @@ components:
38013874
Typesense will attempt to return results early if the cutoff time has elapsed.
38023875
This is not a strict guarantee and facet computation is not bound by this parameter.
38033876
type: integer
3877+
limit_hits:
3878+
description: >
3879+
Maximum number of hits that can be fetched from the collection.
3880+
page * per_page should be less than this number for the search request to return results.
3881+
type: integer
38043882
use_cache:
38053883
description: >
38063884
Enable server side caching of search query results. By default, caching is disabled.
@@ -3846,6 +3924,20 @@ components:
38463924
description: >
38473925
Comma separated string of nested facet fields whose parent object should be returned in facet response.
38483926
type: string
3927+
facet_sample_percent:
3928+
description: >
3929+
Percentage of hits that will be used to estimate facet counts. Default: 100.
3930+
type: integer
3931+
facet_sample_threshold:
3932+
description: >
3933+
Minimum number of hits above which the facet counts are sampled. Default: 0.
3934+
type: integer
3935+
facet_sample_slope:
3936+
description: >
3937+
Controls how steeply facet_sample_percent falls as the collection grows.
3938+
facet_sample_threshold should be non-zero for facet_sample_slope to be effective.
3939+
Default: 0.
3940+
type: number
38493941
voice_query:
38503942
description: >
38513943
The base64 encoded audio file in 16 khz 16-bit WAV format.

0 commit comments

Comments
 (0)