Update turn-taking
Update the turn-taking knobs, startStrategy (minwords | transcription | transcription+vad, which signals open a caller turn), incompleteTurnFilter (smart interruption filter: don't respond to a turn judged incomplete), protectGreeting (a caller cannot cut off the greeting; the agent answers them after it; turn-native speech recognition models only), ignoreGreetingSpeech (what the caller says during the agent's first line is ignored, never answered), eotThreshold (0-1 end-of-turn confidence; higher = waits longer / holds quiet speech), eagerEotThreshold (0-0.9; higher = replies sooner in quick exchanges = lower latency), shortTurnTimeout (0.5-5 seconds of silence after a short turn before replying), longTurnTimeout (15-30 seconds before nudging a silent caller; floored at 15s). Send only what changes. Use this for 'register quiet / trailing openers' (startStrategy transcription), 'don't cut off callers reading a code in fragments' (incompleteTurnFilter on), 'let the greeting finish' / 'don't let callers interrupt the greeting' (protectGreeting on), 'don't answer the hello they say while the greeting plays' / 'stop the double greeting on outbound calls' (ignoreGreetingSpeech on), 'less likely to interrupt' / 'wait longer before replying' (eotThreshold up), 'reply faster' / 'lower latency' (eagerEotThreshold up), 'wait longer after a pause' (shortTurnTimeout up), 'give slow callers more time' (longTurnTimeout up). eotThreshold and eagerEotThreshold mean the same thing on every engine but land differently: on standard models they drive the voice activity and end-of-turn detection in our pipeline, and on the two turn-native speech recognition models they map onto that model's own turn thresholds. On the one with named turn profiles also set turnPreset for the two knobs the sliders don't reach. incompleteTurnFilter and shortTurnTimeout apply to standard models only, because both turn-native engines decide those on the speech engine itself. Pass null for a field to unset it, back to the default.
Authorization
bearerAuth A personal access token from Settings > API tokens.
In: header
Header Parameters
A key you choose, such as a UUID, that makes this POST safe to retry. Within 24 hours the same key and request answers with the first successful answer and runs nothing, the same key with a different request answers 422 idempotency_key_reused, and a key whose request is still running answers 409 idempotency_key_in_use. A failed request keeps nothing, so the same key runs it again.
1 <= length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/operations/set_turn_detection" \ -H "Content-Type: application/json" \ -d '{ "agent": "string" }'{}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}Set tool response template POST
Set a declarative response template on an HTTP tool, a map from HTTP status → a compact result the model can't misread, so a verbose or ambiguous upstream body (a booking POST that returns a fat 201 JSON blob) can't be read as a failure. Identify the tool by toolName (its snake_case name) or toolId. `responseTemplate` is a JSON string keyed by status pattern ("201", "2xx", "default"); a string value is the success result (with {{jmespath}} fields resolved against the body, e.g. {{data.starts_at}}), an object value is returned verbatim as an {error,message} envelope. The reserved "match" key holds ordered {when,then} branches that test the BODY with a bare JMESPath condition and run before any status key, that is how an endpoint reporting failure inside a 200 (a lookup that resolved nothing) returns a real error envelope instead of a false success. No matching key = today's raw body. Pass null to clear it. This is symmetric with the request-side {{variable}} templating on the URL/headers.
Set variable default POST
Create or update a DYNAMIC per-agent variable and its default (fallback) value. A dynamic variable's value is expected to be injected at call time (API / test profile); this default is what `{{name}}` resolves to when nothing was injected, so an unset variable renders the default instead of leaving the raw `{{name}}` placeholder in the prompt or tool URL. Use this for greeting personalisation like `customer_name` (default `there`) or `company_name`. For a value stored on the agent itself use `set_plain_variable`; for secrets use `request_secret_variable` in the app (or `set_secret_variable` over the MCP). A name can be plain/secret OR dynamic, never both, pick one at creation. To rename, use `rename_variable`, never delete-and-recreate.