Skip to main content
PATCH
Update a tool

Authorizations

Authorization
string
header
required

API key from waterr.ai/settings?tab=api-keys. Send as Authorization: Bearer wai_<your_key>.

Path Parameters

id
string<uuid>
required

Body

application/json

Send only the fields you want to change.

name
string

Rename the tool. Still must be unique per account.

Pattern: ^[a-zA-Z0-9_-]{1,64}$
description
string
parameters_schema
object
execution_mode
enum<string>
Available options:
webhook,
client
webhook_url
string | null
webhook_secret
string | null

New HMAC secret, or null to remove signing.

timeout_ms
integer
Required range: 1000 <= x <= 30000
on_call
enum<string>
Available options:
generate_filler,
static_filler,
silent,
passthrough
static_filler
string | null

Phrase spoken while the tool runs. Required when on_call = "static_filler"; pass null to clear it when switching to another mode.

on_resolve
enum<string>
Available options:
generate_response,
response_in_result,
add_to_context,
fire_and_forget

Response

Tool updated.

data
object

A tool the LLM can call mid-meeting. Defined once on your account, attached to one or more scenarios.