Update Tool
curl --request PATCH \
--url https://api.kejue.co/api/v1/tools/{tool_id} \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"name": "<string>",
"display_name": "<string>",
"description": "<string>",
"http_config": {
"url": "<string>",
"method": "POST",
"headers": {},
"auth_config": {},
"timeout_ms": 30000
},
"dynamic_parameters": [
{
"name": "<string>",
"description": "",
"param_type": "string",
"location": "body",
"required": false,
"source": "ai"
}
],
"static_parameters": [
{
"name": "<string>",
"value": "<string>",
"location": "body"
}
],
"response_schema": {},
"timeout": 30500,
"retry_count": 2,
"precomputable": true
}
'import requests
url = "https://api.kejue.co/api/v1/tools/{tool_id}"
payload = {
"name": "<string>",
"display_name": "<string>",
"description": "<string>",
"http_config": {
"url": "<string>",
"method": "POST",
"headers": {},
"auth_config": {},
"timeout_ms": 30000
},
"dynamic_parameters": [
{
"name": "<string>",
"description": "",
"param_type": "string",
"location": "body",
"required": False,
"source": "ai"
}
],
"static_parameters": [
{
"name": "<string>",
"value": "<string>",
"location": "body"
}
],
"response_schema": {},
"timeout": 30500,
"retry_count": 2,
"precomputable": True
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
display_name: '<string>',
description: '<string>',
http_config: {
url: '<string>',
method: 'POST',
headers: {},
auth_config: {},
timeout_ms: 30000
},
dynamic_parameters: [
{
name: '<string>',
description: '',
param_type: 'string',
location: 'body',
required: false,
source: 'ai'
}
],
static_parameters: [{name: '<string>', value: '<string>', location: 'body'}],
response_schema: {},
timeout: 30500,
retry_count: 2,
precomputable: true
})
};
fetch('https://api.kejue.co/api/v1/tools/{tool_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.kejue.co/api/v1/tools/{tool_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'display_name' => '<string>',
'description' => '<string>',
'http_config' => [
'url' => '<string>',
'method' => 'POST',
'headers' => [
],
'auth_config' => [
],
'timeout_ms' => 30000
],
'dynamic_parameters' => [
[
'name' => '<string>',
'description' => '',
'param_type' => 'string',
'location' => 'body',
'required' => false,
'source' => 'ai'
]
],
'static_parameters' => [
[
'name' => '<string>',
'value' => '<string>',
'location' => 'body'
]
],
'response_schema' => [
],
'timeout' => 30500,
'retry_count' => 2,
'precomputable' => true
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.kejue.co/api/v1/tools/{tool_id}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"display_name\": \"<string>\",\n \"description\": \"<string>\",\n \"http_config\": {\n \"url\": \"<string>\",\n \"method\": \"POST\",\n \"headers\": {},\n \"auth_config\": {},\n \"timeout_ms\": 30000\n },\n \"dynamic_parameters\": [\n {\n \"name\": \"<string>\",\n \"description\": \"\",\n \"param_type\": \"string\",\n \"location\": \"body\",\n \"required\": false,\n \"source\": \"ai\"\n }\n ],\n \"static_parameters\": [\n {\n \"name\": \"<string>\",\n \"value\": \"<string>\",\n \"location\": \"body\"\n }\n ],\n \"response_schema\": {},\n \"timeout\": 30500,\n \"retry_count\": 2,\n \"precomputable\": true\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.kejue.co/api/v1/tools/{tool_id}")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"display_name\": \"<string>\",\n \"description\": \"<string>\",\n \"http_config\": {\n \"url\": \"<string>\",\n \"method\": \"POST\",\n \"headers\": {},\n \"auth_config\": {},\n \"timeout_ms\": 30000\n },\n \"dynamic_parameters\": [\n {\n \"name\": \"<string>\",\n \"description\": \"\",\n \"param_type\": \"string\",\n \"location\": \"body\",\n \"required\": false,\n \"source\": \"ai\"\n }\n ],\n \"static_parameters\": [\n {\n \"name\": \"<string>\",\n \"value\": \"<string>\",\n \"location\": \"body\"\n }\n ],\n \"response_schema\": {},\n \"timeout\": 30500,\n \"retry_count\": 2,\n \"precomputable\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.kejue.co/api/v1/tools/{tool_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"display_name\": \"<string>\",\n \"description\": \"<string>\",\n \"http_config\": {\n \"url\": \"<string>\",\n \"method\": \"POST\",\n \"headers\": {},\n \"auth_config\": {},\n \"timeout_ms\": 30000\n },\n \"dynamic_parameters\": [\n {\n \"name\": \"<string>\",\n \"description\": \"\",\n \"param_type\": \"string\",\n \"location\": \"body\",\n \"required\": false,\n \"source\": \"ai\"\n }\n ],\n \"static_parameters\": [\n {\n \"name\": \"<string>\",\n \"value\": \"<string>\",\n \"location\": \"body\"\n }\n ],\n \"response_schema\": {},\n \"timeout\": 30500,\n \"retry_count\": 2,\n \"precomputable\": true\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"name": "<string>",
"tool_type": "<string>",
"timeout": 123,
"retry_count": 123,
"display_name": "<string>",
"description": "<string>",
"http_config": {},
"parameters": {},
"response_schema": {},
"precomputable": false,
"agent_reaction": "speaks",
"created_at": "<string>",
"updated_at": "<string>"
}{
"error": "Unknown secrets referenced: my_api_key",
"code": "BAD_REQUEST",
"details": {}
}{
"error": "Invalid or missing API key",
"code": "UNAUTHORIZED",
"details": {}
}{
"error": "Tool not found",
"code": "NOT_FOUND",
"details": {
"tool_id": "non_existent_id"
}
}{
"error": "Tool with name 'send_email' already exists",
"code": "CONFLICT",
"details": {}
}{
"error": "Validation failed",
"code": "VALIDATION_ERROR",
"details": {
"errors": [
{
"field": "body.name",
"message": "Field required",
"type": "missing"
}
]
}
}Tools
Update Tool
Update a tool.
PATCH
/
tools
/
{tool_id}
Update Tool
curl --request PATCH \
--url https://api.kejue.co/api/v1/tools/{tool_id} \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"name": "<string>",
"display_name": "<string>",
"description": "<string>",
"http_config": {
"url": "<string>",
"method": "POST",
"headers": {},
"auth_config": {},
"timeout_ms": 30000
},
"dynamic_parameters": [
{
"name": "<string>",
"description": "",
"param_type": "string",
"location": "body",
"required": false,
"source": "ai"
}
],
"static_parameters": [
{
"name": "<string>",
"value": "<string>",
"location": "body"
}
],
"response_schema": {},
"timeout": 30500,
"retry_count": 2,
"precomputable": true
}
'import requests
url = "https://api.kejue.co/api/v1/tools/{tool_id}"
payload = {
"name": "<string>",
"display_name": "<string>",
"description": "<string>",
"http_config": {
"url": "<string>",
"method": "POST",
"headers": {},
"auth_config": {},
"timeout_ms": 30000
},
"dynamic_parameters": [
{
"name": "<string>",
"description": "",
"param_type": "string",
"location": "body",
"required": False,
"source": "ai"
}
],
"static_parameters": [
{
"name": "<string>",
"value": "<string>",
"location": "body"
}
],
"response_schema": {},
"timeout": 30500,
"retry_count": 2,
"precomputable": True
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
display_name: '<string>',
description: '<string>',
http_config: {
url: '<string>',
method: 'POST',
headers: {},
auth_config: {},
timeout_ms: 30000
},
dynamic_parameters: [
{
name: '<string>',
description: '',
param_type: 'string',
location: 'body',
required: false,
source: 'ai'
}
],
static_parameters: [{name: '<string>', value: '<string>', location: 'body'}],
response_schema: {},
timeout: 30500,
retry_count: 2,
precomputable: true
})
};
fetch('https://api.kejue.co/api/v1/tools/{tool_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.kejue.co/api/v1/tools/{tool_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'display_name' => '<string>',
'description' => '<string>',
'http_config' => [
'url' => '<string>',
'method' => 'POST',
'headers' => [
],
'auth_config' => [
],
'timeout_ms' => 30000
],
'dynamic_parameters' => [
[
'name' => '<string>',
'description' => '',
'param_type' => 'string',
'location' => 'body',
'required' => false,
'source' => 'ai'
]
],
'static_parameters' => [
[
'name' => '<string>',
'value' => '<string>',
'location' => 'body'
]
],
'response_schema' => [
],
'timeout' => 30500,
'retry_count' => 2,
'precomputable' => true
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.kejue.co/api/v1/tools/{tool_id}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"display_name\": \"<string>\",\n \"description\": \"<string>\",\n \"http_config\": {\n \"url\": \"<string>\",\n \"method\": \"POST\",\n \"headers\": {},\n \"auth_config\": {},\n \"timeout_ms\": 30000\n },\n \"dynamic_parameters\": [\n {\n \"name\": \"<string>\",\n \"description\": \"\",\n \"param_type\": \"string\",\n \"location\": \"body\",\n \"required\": false,\n \"source\": \"ai\"\n }\n ],\n \"static_parameters\": [\n {\n \"name\": \"<string>\",\n \"value\": \"<string>\",\n \"location\": \"body\"\n }\n ],\n \"response_schema\": {},\n \"timeout\": 30500,\n \"retry_count\": 2,\n \"precomputable\": true\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.kejue.co/api/v1/tools/{tool_id}")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"display_name\": \"<string>\",\n \"description\": \"<string>\",\n \"http_config\": {\n \"url\": \"<string>\",\n \"method\": \"POST\",\n \"headers\": {},\n \"auth_config\": {},\n \"timeout_ms\": 30000\n },\n \"dynamic_parameters\": [\n {\n \"name\": \"<string>\",\n \"description\": \"\",\n \"param_type\": \"string\",\n \"location\": \"body\",\n \"required\": false,\n \"source\": \"ai\"\n }\n ],\n \"static_parameters\": [\n {\n \"name\": \"<string>\",\n \"value\": \"<string>\",\n \"location\": \"body\"\n }\n ],\n \"response_schema\": {},\n \"timeout\": 30500,\n \"retry_count\": 2,\n \"precomputable\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.kejue.co/api/v1/tools/{tool_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"display_name\": \"<string>\",\n \"description\": \"<string>\",\n \"http_config\": {\n \"url\": \"<string>\",\n \"method\": \"POST\",\n \"headers\": {},\n \"auth_config\": {},\n \"timeout_ms\": 30000\n },\n \"dynamic_parameters\": [\n {\n \"name\": \"<string>\",\n \"description\": \"\",\n \"param_type\": \"string\",\n \"location\": \"body\",\n \"required\": false,\n \"source\": \"ai\"\n }\n ],\n \"static_parameters\": [\n {\n \"name\": \"<string>\",\n \"value\": \"<string>\",\n \"location\": \"body\"\n }\n ],\n \"response_schema\": {},\n \"timeout\": 30500,\n \"retry_count\": 2,\n \"precomputable\": true\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"name": "<string>",
"tool_type": "<string>",
"timeout": 123,
"retry_count": 123,
"display_name": "<string>",
"description": "<string>",
"http_config": {},
"parameters": {},
"response_schema": {},
"precomputable": false,
"agent_reaction": "speaks",
"created_at": "<string>",
"updated_at": "<string>"
}{
"error": "Unknown secrets referenced: my_api_key",
"code": "BAD_REQUEST",
"details": {}
}{
"error": "Invalid or missing API key",
"code": "UNAUTHORIZED",
"details": {}
}{
"error": "Tool not found",
"code": "NOT_FOUND",
"details": {
"tool_id": "non_existent_id"
}
}{
"error": "Tool with name 'send_email' already exists",
"code": "CONFLICT",
"details": {}
}{
"error": "Validation failed",
"code": "VALIDATION_ERROR",
"details": {
"errors": [
{
"field": "body.name",
"message": "Field required",
"type": "missing"
}
]
}
}Authorizations
Workspace API key (e.g. kej_live_...)
Path Parameters
Body
application/json
Partial update for a tool.
Required string length:
1 - 100HTTP configuration for a tool.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Required range:
1000 <= x <= 60000Required range:
0 <= x <= 5Voice only: speculative execution flag. Ignored for chat.
Voice only: agent's reaction when the tool fires. Ignored for chat.
Available options:
speaks, silent, speaks-once Response
Successful Response
A custom HTTP tool (public-safe response).
How the voice agent reacts when a tool call fires.
Ultravox-specific. Ignored by chat tool-calling.
- SPEAKS: agent speaks naturally around the tool call (Ultravox default)
- SILENT: agent stays silent until the tool returns
- SPEAKS_ONCE: agent speaks at most one filler line during the tool call
Available options:
speaks, silent, speaks-once ⌘I

