Search Debounce Utility
API Contract
REST
/api/v1/search/debounce
5 endpoints
GET
/api/v1/search/debounce/api/v1/search/debounce
List all debounce configuration profiles
Public
Response Example
{
"data": [
{
"id": "dbnc_default",
"label": "Default",
"duration_ms": 300,
"min_query_length": 2,
"created_at": "2026-01-10T00:00:00Z"
},
{
"id": "dbnc_fast",
"label": "Fast Typist",
"duration_ms": 150,
"min_query_length": 1,
"created_at": "2026-02-01T00:00:00Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 2
}
}
GET
/api/v1/search/debounce/api/v1/search/debounce/:id
Retrieve a specific debounce configuration profile
Public
Response Example
{
"id": "dbnc_default",
"label": "Default",
"duration_ms": 300,
"min_query_length": 2,
"created_at": "2026-01-10T00:00:00Z",
"updated_at": "2026-03-01T12:00:00Z"
}
POST
/api/v1/search/debounce/api/v1/search/debounce
Create a new debounce configuration profile
Public
Request Example
{
"label": "Slow Connection",
"duration_ms": 600,
"min_query_length": 3
}
Response Example
{
"id": "dbnc_slow_conn",
"label": "Slow Connection",
"duration_ms": 600,
"min_query_length": 3,
"created_at": "2026-03-26T09:10:00Z"
}
PUT
/api/v1/search/debounce/api/v1/search/debounce/:id
Update debounce duration and/or minimum query length for a profile
Public
Request Example
{
"duration_ms": 400,
"min_query_length": 2
}
Response Example
{
"id": "dbnc_default",
"label": "Default",
"duration_ms": 400,
"min_query_length": 2,
"updated_at": "2026-03-26T09:12:00Z"
}
DELETE
/api/v1/search/debounce/api/v1/search/debounce/:id
Dispose (delete) a debounce configuration profile
Public
Response Example
{
"id": "dbnc_slow_conn",
"deleted": true
}