Update an agent tool

Updates a tool - all fields optional, only the ones sent are changed. Two things to watch for: params and headers both replace the entire existing list, and changing label also rewrites the name the model knows the tool by - if you reference it in systemPrompt, update that at the same time.

patch/v1/tools/{id}

Request

  • Base URL: https://volai.cz
  • URL: https://volai.cz/v1/tools/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Request body

labelstring

Display name of the webhook tool, also used to derive its name for the agent. Reserved call-control names are not allowed.

descriptionstring

Tell the agent when to call this tool and what it does.

urlstring

Public HTTPS endpoint receiving the tool request. Local/private addresses are rejected; the endpoint must respond within timeoutSecs.

methodstring

HTTP request method: GET puts parameters in the query string, POST sends JSON. Case-insensitive GET or POST only.

headersobject

Complete map of custom HTTP headers; {} clears them on PATCH. Values are secrets and returned redacted. Header names are case-insensitive and must be unique. host, content-length, x-conversation-id and x-caller-id are reserved.

timeoutSecsinteger

Maximum wait for the endpoint's response during a call, in whole seconds. Defaults to 20.

Response

Updated tool

Changes

No recorded changes to this operation across all 1 revision of this API.