Models
Update the agent's model selection
Shortcut over PATCH /agents/ for aiModelPublicId, temperature, thinkingEnabled and thinkingEffort. Validates temperature against the resolved model when both arrive in the same body.
PATCH
/
public
/
api
/
v1
/
agents
/
{agentPublicId}
/
model
Update the agent's model selection
curl --request PATCH \
--url https://api.gennia.ai/public/api/v1/agents/{agentPublicId}/model \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"aiModelPublicId": "9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21",
"temperature": 0.7,
"thinkingEffort": "medium",
"thinkingEnabled": true
}
'import requests
url = "https://api.gennia.ai/public/api/v1/agents/{agentPublicId}/model"
payload = {
"aiModelPublicId": "9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21",
"temperature": 0.7,
"thinkingEffort": "medium",
"thinkingEnabled": 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({
aiModelPublicId: '9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21',
temperature: 0.7,
thinkingEffort: 'medium',
thinkingEnabled: true
})
};
fetch('https://api.gennia.ai/public/api/v1/agents/{agentPublicId}/model', 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.gennia.ai/public/api/v1/agents/{agentPublicId}/model",
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([
'aiModelPublicId' => '9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21',
'temperature' => 0.7,
'thinkingEffort' => 'medium',
'thinkingEnabled' => 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.gennia.ai/public/api/v1/agents/{agentPublicId}/model"
payload := strings.NewReader("{\n \"aiModelPublicId\": \"9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21\",\n \"temperature\": 0.7,\n \"thinkingEffort\": \"medium\",\n \"thinkingEnabled\": 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.gennia.ai/public/api/v1/agents/{agentPublicId}/model")
.header("X-Api-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"aiModelPublicId\": \"9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21\",\n \"temperature\": 0.7,\n \"thinkingEffort\": \"medium\",\n \"thinkingEnabled\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gennia.ai/public/api/v1/agents/{agentPublicId}/model")
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 \"aiModelPublicId\": \"9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21\",\n \"temperature\": 0.7,\n \"thinkingEffort\": \"medium\",\n \"thinkingEnabled\": true\n}"
response = http.request(request)
puts response.read_body{
"aiModelName": "<string>",
"aiModelPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"capabilities": {
"contextWindow": 123,
"maxTemperature": 123,
"minTemperature": 123,
"supportsDocument": true,
"supportsImage": true,
"supportsTemperature": true,
"supportsThinking": true
},
"modelId": "<string>",
"provider": "<string>",
"temperature": 123,
"thinkingEffort": "<string>",
"thinkingEnabled": true
}{
"aiModelName": "<string>",
"aiModelPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"capabilities": {
"contextWindow": 123,
"maxTemperature": 123,
"minTemperature": 123,
"supportsDocument": true,
"supportsImage": true,
"supportsTemperature": true,
"supportsThinking": true
},
"modelId": "<string>",
"provider": "<string>",
"temperature": 123,
"thinkingEffort": "<string>",
"thinkingEnabled": true
}{
"aiModelName": "<string>",
"aiModelPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"capabilities": {
"contextWindow": 123,
"maxTemperature": 123,
"minTemperature": 123,
"supportsDocument": true,
"supportsImage": true,
"supportsTemperature": true,
"supportsThinking": true
},
"modelId": "<string>",
"provider": "<string>",
"temperature": 123,
"thinkingEffort": "<string>",
"thinkingEnabled": true
}{
"aiModelName": "<string>",
"aiModelPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"capabilities": {
"contextWindow": 123,
"maxTemperature": 123,
"minTemperature": 123,
"supportsDocument": true,
"supportsImage": true,
"supportsTemperature": true,
"supportsThinking": true
},
"modelId": "<string>",
"provider": "<string>",
"temperature": 123,
"thinkingEffort": "<string>",
"thinkingEnabled": true
}{
"aiModelName": "<string>",
"aiModelPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"capabilities": {
"contextWindow": 123,
"maxTemperature": 123,
"minTemperature": 123,
"supportsDocument": true,
"supportsImage": true,
"supportsTemperature": true,
"supportsThinking": true
},
"modelId": "<string>",
"provider": "<string>",
"temperature": 123,
"thinkingEffort": "<string>",
"thinkingEnabled": true
}Autorizações
Parâmetros de caminho
Corpo
application/json
Body for updating the agent's AI model and decoding settings. Fields are tri-state: omit to leave unchanged, set to a value to update, or send null to clear.
Public ID of the AI model to use.
Show child attributes
Show child attributes
Exemplo:
"9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21"
Sampling temperature between 0.0 and 2.0.
Show child attributes
Show child attributes
Exemplo:
0.7
Reasoning effort level when thinking is enabled.
Show child attributes
Show child attributes
Exemplo:
"medium"
Enable extended thinking for reasoning-capable models.
Show child attributes
Show child attributes
Exemplo:
true
Esta página foi útil?
Anterior
List AI modelsReturns the union of (a) global catalog models and (b) custom models owned by the workspace bound to the API key. Optional filters apply in memory.
Próximo
⌘I
Update the agent's model selection
curl --request PATCH \
--url https://api.gennia.ai/public/api/v1/agents/{agentPublicId}/model \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"aiModelPublicId": "9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21",
"temperature": 0.7,
"thinkingEffort": "medium",
"thinkingEnabled": true
}
'import requests
url = "https://api.gennia.ai/public/api/v1/agents/{agentPublicId}/model"
payload = {
"aiModelPublicId": "9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21",
"temperature": 0.7,
"thinkingEffort": "medium",
"thinkingEnabled": 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({
aiModelPublicId: '9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21',
temperature: 0.7,
thinkingEffort: 'medium',
thinkingEnabled: true
})
};
fetch('https://api.gennia.ai/public/api/v1/agents/{agentPublicId}/model', 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.gennia.ai/public/api/v1/agents/{agentPublicId}/model",
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([
'aiModelPublicId' => '9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21',
'temperature' => 0.7,
'thinkingEffort' => 'medium',
'thinkingEnabled' => 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.gennia.ai/public/api/v1/agents/{agentPublicId}/model"
payload := strings.NewReader("{\n \"aiModelPublicId\": \"9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21\",\n \"temperature\": 0.7,\n \"thinkingEffort\": \"medium\",\n \"thinkingEnabled\": 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.gennia.ai/public/api/v1/agents/{agentPublicId}/model")
.header("X-Api-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"aiModelPublicId\": \"9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21\",\n \"temperature\": 0.7,\n \"thinkingEffort\": \"medium\",\n \"thinkingEnabled\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gennia.ai/public/api/v1/agents/{agentPublicId}/model")
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 \"aiModelPublicId\": \"9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21\",\n \"temperature\": 0.7,\n \"thinkingEffort\": \"medium\",\n \"thinkingEnabled\": true\n}"
response = http.request(request)
puts response.read_body{
"aiModelName": "<string>",
"aiModelPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"capabilities": {
"contextWindow": 123,
"maxTemperature": 123,
"minTemperature": 123,
"supportsDocument": true,
"supportsImage": true,
"supportsTemperature": true,
"supportsThinking": true
},
"modelId": "<string>",
"provider": "<string>",
"temperature": 123,
"thinkingEffort": "<string>",
"thinkingEnabled": true
}{
"aiModelName": "<string>",
"aiModelPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"capabilities": {
"contextWindow": 123,
"maxTemperature": 123,
"minTemperature": 123,
"supportsDocument": true,
"supportsImage": true,
"supportsTemperature": true,
"supportsThinking": true
},
"modelId": "<string>",
"provider": "<string>",
"temperature": 123,
"thinkingEffort": "<string>",
"thinkingEnabled": true
}{
"aiModelName": "<string>",
"aiModelPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"capabilities": {
"contextWindow": 123,
"maxTemperature": 123,
"minTemperature": 123,
"supportsDocument": true,
"supportsImage": true,
"supportsTemperature": true,
"supportsThinking": true
},
"modelId": "<string>",
"provider": "<string>",
"temperature": 123,
"thinkingEffort": "<string>",
"thinkingEnabled": true
}{
"aiModelName": "<string>",
"aiModelPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"capabilities": {
"contextWindow": 123,
"maxTemperature": 123,
"minTemperature": 123,
"supportsDocument": true,
"supportsImage": true,
"supportsTemperature": true,
"supportsThinking": true
},
"modelId": "<string>",
"provider": "<string>",
"temperature": 123,
"thinkingEffort": "<string>",
"thinkingEnabled": true
}{
"aiModelName": "<string>",
"aiModelPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"capabilities": {
"contextWindow": 123,
"maxTemperature": 123,
"minTemperature": 123,
"supportsDocument": true,
"supportsImage": true,
"supportsTemperature": true,
"supportsThinking": true
},
"modelId": "<string>",
"provider": "<string>",
"temperature": 123,
"thinkingEffort": "<string>",
"thinkingEnabled": true
}
