Skip to main content
PATCH
Update a custom tool

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Path Parameters

id
string
required

Body

application/json
description
string
Required string length: 1 - 1000
json_schema
object

JSON-Schema describing the tool's parameters, shown to the LLM.

executor_url
string

HTTPS webhook the runtime POSTs to when the tool is invoked.

Maximum string length: 2000
executor_secret
string | null

New secret rotates the HMAC key; null clears it; omit to leave unchanged.

enabled
boolean
timeout_ms
integer
Required range: 1000 <= x <= 60000
confirmation
enum<string>
Available options:
never,
always

Response

The updated custom tool.

data
object

The updated custom tool, same shape as GET /agents/custom-tools/{id}.

meta
object