Save Profile
curl --request POST \
--url https://api.example.com/api/v1/settings/profiles/{name} \
--header 'Content-Type: application/json' \
--header 'X-Access-Token: <api-key>' \
--data '
{
"include_secrets": true,
"llm": {
"model": "gpt-5.5",
"api_key": "<string>",
"auth_type": "api_key",
"subscription_vendor": "<string>",
"base_url": "<string>",
"api_version": "<string>",
"aws_access_key_id": "<string>",
"aws_secret_access_key": "<string>",
"aws_session_token": "<string>",
"aws_region_name": "<string>",
"aws_profile_name": "<string>",
"aws_role_name": "<string>",
"aws_session_name": "<string>",
"aws_bedrock_runtime_endpoint": "<string>",
"openrouter_site_url": "https://docs.all-hands.dev/",
"openrouter_app_name": "OpenHands",
"num_retries": 5,
"retry_multiplier": 8,
"retry_min_wait": 8,
"retry_max_wait": 64,
"timeout": 300,
"max_message_chars": 30000,
"temperature": 1,
"top_p": 0.5,
"top_k": 1,
"max_input_tokens": 2,
"max_output_tokens": 2,
"model_canonical_name": "<string>",
"api_mode": "auto",
"capability_overrides": {},
"extra_headers": {},
"input_cost_per_token": 1,
"output_cost_per_token": 1,
"ollama_base_url": "<string>",
"stream": false,
"drop_params": true,
"modify_params": true,
"disable_vision": true,
"disable_stop_word": false,
"caching_prompt": true,
"log_completions": false,
"log_completions_folder": "logs/completions",
"custom_tokenizer": "<string>",
"native_tool_calling": true,
"force_string_serializer": true,
"inline_image_urls": true,
"reasoning_effort": "high",
"enable_encrypted_reasoning": true,
"prompt_cache_retention": "24h",
"extended_thinking_budget": 200000,
"seed": 123,
"usage_id": "default",
"litellm_extra_body": {},
"fallback_strategy": {
"fallback_llms": [
"<string>"
],
"profile_store_dir": "<string>"
}
},
"preserve_existing_api_key": false
}
'import requests
url = "https://api.example.com/api/v1/settings/profiles/{name}"
payload = {
"include_secrets": True,
"llm": {
"model": "gpt-5.5",
"api_key": "<string>",
"auth_type": "api_key",
"subscription_vendor": "<string>",
"base_url": "<string>",
"api_version": "<string>",
"aws_access_key_id": "<string>",
"aws_secret_access_key": "<string>",
"aws_session_token": "<string>",
"aws_region_name": "<string>",
"aws_profile_name": "<string>",
"aws_role_name": "<string>",
"aws_session_name": "<string>",
"aws_bedrock_runtime_endpoint": "<string>",
"openrouter_site_url": "https://docs.all-hands.dev/",
"openrouter_app_name": "OpenHands",
"num_retries": 5,
"retry_multiplier": 8,
"retry_min_wait": 8,
"retry_max_wait": 64,
"timeout": 300,
"max_message_chars": 30000,
"temperature": 1,
"top_p": 0.5,
"top_k": 1,
"max_input_tokens": 2,
"max_output_tokens": 2,
"model_canonical_name": "<string>",
"api_mode": "auto",
"capability_overrides": {},
"extra_headers": {},
"input_cost_per_token": 1,
"output_cost_per_token": 1,
"ollama_base_url": "<string>",
"stream": False,
"drop_params": True,
"modify_params": True,
"disable_vision": True,
"disable_stop_word": False,
"caching_prompt": True,
"log_completions": False,
"log_completions_folder": "logs/completions",
"custom_tokenizer": "<string>",
"native_tool_calling": True,
"force_string_serializer": True,
"inline_image_urls": True,
"reasoning_effort": "high",
"enable_encrypted_reasoning": True,
"prompt_cache_retention": "24h",
"extended_thinking_budget": 200000,
"seed": 123,
"usage_id": "default",
"litellm_extra_body": {},
"fallback_strategy": {
"fallback_llms": ["<string>"],
"profile_store_dir": "<string>"
}
},
"preserve_existing_api_key": False
}
headers = {
"X-Access-Token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Access-Token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
include_secrets: true,
llm: {
model: 'gpt-5.5',
api_key: '<string>',
auth_type: 'api_key',
subscription_vendor: '<string>',
base_url: '<string>',
api_version: '<string>',
aws_access_key_id: '<string>',
aws_secret_access_key: '<string>',
aws_session_token: '<string>',
aws_region_name: '<string>',
aws_profile_name: '<string>',
aws_role_name: '<string>',
aws_session_name: '<string>',
aws_bedrock_runtime_endpoint: '<string>',
openrouter_site_url: 'https://docs.all-hands.dev/',
openrouter_app_name: 'OpenHands',
num_retries: 5,
retry_multiplier: 8,
retry_min_wait: 8,
retry_max_wait: 64,
timeout: 300,
max_message_chars: 30000,
temperature: 1,
top_p: 0.5,
top_k: 1,
max_input_tokens: 2,
max_output_tokens: 2,
model_canonical_name: '<string>',
api_mode: 'auto',
capability_overrides: {},
extra_headers: {},
input_cost_per_token: 1,
output_cost_per_token: 1,
ollama_base_url: '<string>',
stream: false,
drop_params: true,
modify_params: true,
disable_vision: true,
disable_stop_word: false,
caching_prompt: true,
log_completions: false,
log_completions_folder: 'logs/completions',
custom_tokenizer: '<string>',
native_tool_calling: true,
force_string_serializer: true,
inline_image_urls: true,
reasoning_effort: 'high',
enable_encrypted_reasoning: true,
prompt_cache_retention: '24h',
extended_thinking_budget: 200000,
seed: 123,
usage_id: 'default',
litellm_extra_body: {},
fallback_strategy: {fallback_llms: ['<string>'], profile_store_dir: '<string>'}
},
preserve_existing_api_key: false
})
};
fetch('https://api.example.com/api/v1/settings/profiles/{name}', 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.example.com/api/v1/settings/profiles/{name}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'include_secrets' => true,
'llm' => [
'model' => 'gpt-5.5',
'api_key' => '<string>',
'auth_type' => 'api_key',
'subscription_vendor' => '<string>',
'base_url' => '<string>',
'api_version' => '<string>',
'aws_access_key_id' => '<string>',
'aws_secret_access_key' => '<string>',
'aws_session_token' => '<string>',
'aws_region_name' => '<string>',
'aws_profile_name' => '<string>',
'aws_role_name' => '<string>',
'aws_session_name' => '<string>',
'aws_bedrock_runtime_endpoint' => '<string>',
'openrouter_site_url' => 'https://docs.all-hands.dev/',
'openrouter_app_name' => 'OpenHands',
'num_retries' => 5,
'retry_multiplier' => 8,
'retry_min_wait' => 8,
'retry_max_wait' => 64,
'timeout' => 300,
'max_message_chars' => 30000,
'temperature' => 1,
'top_p' => 0.5,
'top_k' => 1,
'max_input_tokens' => 2,
'max_output_tokens' => 2,
'model_canonical_name' => '<string>',
'api_mode' => 'auto',
'capability_overrides' => [
],
'extra_headers' => [
],
'input_cost_per_token' => 1,
'output_cost_per_token' => 1,
'ollama_base_url' => '<string>',
'stream' => false,
'drop_params' => true,
'modify_params' => true,
'disable_vision' => true,
'disable_stop_word' => false,
'caching_prompt' => true,
'log_completions' => false,
'log_completions_folder' => 'logs/completions',
'custom_tokenizer' => '<string>',
'native_tool_calling' => true,
'force_string_serializer' => true,
'inline_image_urls' => true,
'reasoning_effort' => 'high',
'enable_encrypted_reasoning' => true,
'prompt_cache_retention' => '24h',
'extended_thinking_budget' => 200000,
'seed' => 123,
'usage_id' => 'default',
'litellm_extra_body' => [
],
'fallback_strategy' => [
'fallback_llms' => [
'<string>'
],
'profile_store_dir' => '<string>'
]
],
'preserve_existing_api_key' => false
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Access-Token: <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.example.com/api/v1/settings/profiles/{name}"
payload := strings.NewReader("{\n \"include_secrets\": true,\n \"llm\": {\n \"model\": \"gpt-5.5\",\n \"api_key\": \"<string>\",\n \"auth_type\": \"api_key\",\n \"subscription_vendor\": \"<string>\",\n \"base_url\": \"<string>\",\n \"api_version\": \"<string>\",\n \"aws_access_key_id\": \"<string>\",\n \"aws_secret_access_key\": \"<string>\",\n \"aws_session_token\": \"<string>\",\n \"aws_region_name\": \"<string>\",\n \"aws_profile_name\": \"<string>\",\n \"aws_role_name\": \"<string>\",\n \"aws_session_name\": \"<string>\",\n \"aws_bedrock_runtime_endpoint\": \"<string>\",\n \"openrouter_site_url\": \"https://docs.all-hands.dev/\",\n \"openrouter_app_name\": \"OpenHands\",\n \"num_retries\": 5,\n \"retry_multiplier\": 8,\n \"retry_min_wait\": 8,\n \"retry_max_wait\": 64,\n \"timeout\": 300,\n \"max_message_chars\": 30000,\n \"temperature\": 1,\n \"top_p\": 0.5,\n \"top_k\": 1,\n \"max_input_tokens\": 2,\n \"max_output_tokens\": 2,\n \"model_canonical_name\": \"<string>\",\n \"api_mode\": \"auto\",\n \"capability_overrides\": {},\n \"extra_headers\": {},\n \"input_cost_per_token\": 1,\n \"output_cost_per_token\": 1,\n \"ollama_base_url\": \"<string>\",\n \"stream\": false,\n \"drop_params\": true,\n \"modify_params\": true,\n \"disable_vision\": true,\n \"disable_stop_word\": false,\n \"caching_prompt\": true,\n \"log_completions\": false,\n \"log_completions_folder\": \"logs/completions\",\n \"custom_tokenizer\": \"<string>\",\n \"native_tool_calling\": true,\n \"force_string_serializer\": true,\n \"inline_image_urls\": true,\n \"reasoning_effort\": \"high\",\n \"enable_encrypted_reasoning\": true,\n \"prompt_cache_retention\": \"24h\",\n \"extended_thinking_budget\": 200000,\n \"seed\": 123,\n \"usage_id\": \"default\",\n \"litellm_extra_body\": {},\n \"fallback_strategy\": {\n \"fallback_llms\": [\n \"<string>\"\n ],\n \"profile_store_dir\": \"<string>\"\n }\n },\n \"preserve_existing_api_key\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Access-Token", "<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.post("https://api.example.com/api/v1/settings/profiles/{name}")
.header("X-Access-Token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"include_secrets\": true,\n \"llm\": {\n \"model\": \"gpt-5.5\",\n \"api_key\": \"<string>\",\n \"auth_type\": \"api_key\",\n \"subscription_vendor\": \"<string>\",\n \"base_url\": \"<string>\",\n \"api_version\": \"<string>\",\n \"aws_access_key_id\": \"<string>\",\n \"aws_secret_access_key\": \"<string>\",\n \"aws_session_token\": \"<string>\",\n \"aws_region_name\": \"<string>\",\n \"aws_profile_name\": \"<string>\",\n \"aws_role_name\": \"<string>\",\n \"aws_session_name\": \"<string>\",\n \"aws_bedrock_runtime_endpoint\": \"<string>\",\n \"openrouter_site_url\": \"https://docs.all-hands.dev/\",\n \"openrouter_app_name\": \"OpenHands\",\n \"num_retries\": 5,\n \"retry_multiplier\": 8,\n \"retry_min_wait\": 8,\n \"retry_max_wait\": 64,\n \"timeout\": 300,\n \"max_message_chars\": 30000,\n \"temperature\": 1,\n \"top_p\": 0.5,\n \"top_k\": 1,\n \"max_input_tokens\": 2,\n \"max_output_tokens\": 2,\n \"model_canonical_name\": \"<string>\",\n \"api_mode\": \"auto\",\n \"capability_overrides\": {},\n \"extra_headers\": {},\n \"input_cost_per_token\": 1,\n \"output_cost_per_token\": 1,\n \"ollama_base_url\": \"<string>\",\n \"stream\": false,\n \"drop_params\": true,\n \"modify_params\": true,\n \"disable_vision\": true,\n \"disable_stop_word\": false,\n \"caching_prompt\": true,\n \"log_completions\": false,\n \"log_completions_folder\": \"logs/completions\",\n \"custom_tokenizer\": \"<string>\",\n \"native_tool_calling\": true,\n \"force_string_serializer\": true,\n \"inline_image_urls\": true,\n \"reasoning_effort\": \"high\",\n \"enable_encrypted_reasoning\": true,\n \"prompt_cache_retention\": \"24h\",\n \"extended_thinking_budget\": 200000,\n \"seed\": 123,\n \"usage_id\": \"default\",\n \"litellm_extra_body\": {},\n \"fallback_strategy\": {\n \"fallback_llms\": [\n \"<string>\"\n ],\n \"profile_store_dir\": \"<string>\"\n }\n },\n \"preserve_existing_api_key\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/settings/profiles/{name}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Access-Token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"include_secrets\": true,\n \"llm\": {\n \"model\": \"gpt-5.5\",\n \"api_key\": \"<string>\",\n \"auth_type\": \"api_key\",\n \"subscription_vendor\": \"<string>\",\n \"base_url\": \"<string>\",\n \"api_version\": \"<string>\",\n \"aws_access_key_id\": \"<string>\",\n \"aws_secret_access_key\": \"<string>\",\n \"aws_session_token\": \"<string>\",\n \"aws_region_name\": \"<string>\",\n \"aws_profile_name\": \"<string>\",\n \"aws_role_name\": \"<string>\",\n \"aws_session_name\": \"<string>\",\n \"aws_bedrock_runtime_endpoint\": \"<string>\",\n \"openrouter_site_url\": \"https://docs.all-hands.dev/\",\n \"openrouter_app_name\": \"OpenHands\",\n \"num_retries\": 5,\n \"retry_multiplier\": 8,\n \"retry_min_wait\": 8,\n \"retry_max_wait\": 64,\n \"timeout\": 300,\n \"max_message_chars\": 30000,\n \"temperature\": 1,\n \"top_p\": 0.5,\n \"top_k\": 1,\n \"max_input_tokens\": 2,\n \"max_output_tokens\": 2,\n \"model_canonical_name\": \"<string>\",\n \"api_mode\": \"auto\",\n \"capability_overrides\": {},\n \"extra_headers\": {},\n \"input_cost_per_token\": 1,\n \"output_cost_per_token\": 1,\n \"ollama_base_url\": \"<string>\",\n \"stream\": false,\n \"drop_params\": true,\n \"modify_params\": true,\n \"disable_vision\": true,\n \"disable_stop_word\": false,\n \"caching_prompt\": true,\n \"log_completions\": false,\n \"log_completions_folder\": \"logs/completions\",\n \"custom_tokenizer\": \"<string>\",\n \"native_tool_calling\": true,\n \"force_string_serializer\": true,\n \"inline_image_urls\": true,\n \"reasoning_effort\": \"high\",\n \"enable_encrypted_reasoning\": true,\n \"prompt_cache_retention\": \"24h\",\n \"extended_thinking_budget\": 200000,\n \"seed\": 123,\n \"usage_id\": \"default\",\n \"litellm_extra_body\": {},\n \"fallback_strategy\": {\n \"fallback_llms\": [\n \"<string>\"\n ],\n \"profile_store_dir\": \"<string>\"\n }\n },\n \"preserve_existing_api_key\": false\n}"
response = http.request(request)
puts response.read_body{
"name": "<string>",
"message": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Settings
Save Profile
Save an LLM configuration as a named profile.
If request.llm is supplied, it is saved as the profile’s config.
Otherwise the current agent_settings.llm is snapshotted. Existing
profiles with the same name are overwritten.
Runs inside a per-user lock to prevent lost updates between concurrent
profile writes. Returns 409 if the user is already at the profile
cap (:data:MAX_PROFILES_PER_USER).
POST
/
api
/
v1
/
settings
/
profiles
/
{name}
Save Profile
curl --request POST \
--url https://api.example.com/api/v1/settings/profiles/{name} \
--header 'Content-Type: application/json' \
--header 'X-Access-Token: <api-key>' \
--data '
{
"include_secrets": true,
"llm": {
"model": "gpt-5.5",
"api_key": "<string>",
"auth_type": "api_key",
"subscription_vendor": "<string>",
"base_url": "<string>",
"api_version": "<string>",
"aws_access_key_id": "<string>",
"aws_secret_access_key": "<string>",
"aws_session_token": "<string>",
"aws_region_name": "<string>",
"aws_profile_name": "<string>",
"aws_role_name": "<string>",
"aws_session_name": "<string>",
"aws_bedrock_runtime_endpoint": "<string>",
"openrouter_site_url": "https://docs.all-hands.dev/",
"openrouter_app_name": "OpenHands",
"num_retries": 5,
"retry_multiplier": 8,
"retry_min_wait": 8,
"retry_max_wait": 64,
"timeout": 300,
"max_message_chars": 30000,
"temperature": 1,
"top_p": 0.5,
"top_k": 1,
"max_input_tokens": 2,
"max_output_tokens": 2,
"model_canonical_name": "<string>",
"api_mode": "auto",
"capability_overrides": {},
"extra_headers": {},
"input_cost_per_token": 1,
"output_cost_per_token": 1,
"ollama_base_url": "<string>",
"stream": false,
"drop_params": true,
"modify_params": true,
"disable_vision": true,
"disable_stop_word": false,
"caching_prompt": true,
"log_completions": false,
"log_completions_folder": "logs/completions",
"custom_tokenizer": "<string>",
"native_tool_calling": true,
"force_string_serializer": true,
"inline_image_urls": true,
"reasoning_effort": "high",
"enable_encrypted_reasoning": true,
"prompt_cache_retention": "24h",
"extended_thinking_budget": 200000,
"seed": 123,
"usage_id": "default",
"litellm_extra_body": {},
"fallback_strategy": {
"fallback_llms": [
"<string>"
],
"profile_store_dir": "<string>"
}
},
"preserve_existing_api_key": false
}
'import requests
url = "https://api.example.com/api/v1/settings/profiles/{name}"
payload = {
"include_secrets": True,
"llm": {
"model": "gpt-5.5",
"api_key": "<string>",
"auth_type": "api_key",
"subscription_vendor": "<string>",
"base_url": "<string>",
"api_version": "<string>",
"aws_access_key_id": "<string>",
"aws_secret_access_key": "<string>",
"aws_session_token": "<string>",
"aws_region_name": "<string>",
"aws_profile_name": "<string>",
"aws_role_name": "<string>",
"aws_session_name": "<string>",
"aws_bedrock_runtime_endpoint": "<string>",
"openrouter_site_url": "https://docs.all-hands.dev/",
"openrouter_app_name": "OpenHands",
"num_retries": 5,
"retry_multiplier": 8,
"retry_min_wait": 8,
"retry_max_wait": 64,
"timeout": 300,
"max_message_chars": 30000,
"temperature": 1,
"top_p": 0.5,
"top_k": 1,
"max_input_tokens": 2,
"max_output_tokens": 2,
"model_canonical_name": "<string>",
"api_mode": "auto",
"capability_overrides": {},
"extra_headers": {},
"input_cost_per_token": 1,
"output_cost_per_token": 1,
"ollama_base_url": "<string>",
"stream": False,
"drop_params": True,
"modify_params": True,
"disable_vision": True,
"disable_stop_word": False,
"caching_prompt": True,
"log_completions": False,
"log_completions_folder": "logs/completions",
"custom_tokenizer": "<string>",
"native_tool_calling": True,
"force_string_serializer": True,
"inline_image_urls": True,
"reasoning_effort": "high",
"enable_encrypted_reasoning": True,
"prompt_cache_retention": "24h",
"extended_thinking_budget": 200000,
"seed": 123,
"usage_id": "default",
"litellm_extra_body": {},
"fallback_strategy": {
"fallback_llms": ["<string>"],
"profile_store_dir": "<string>"
}
},
"preserve_existing_api_key": False
}
headers = {
"X-Access-Token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Access-Token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
include_secrets: true,
llm: {
model: 'gpt-5.5',
api_key: '<string>',
auth_type: 'api_key',
subscription_vendor: '<string>',
base_url: '<string>',
api_version: '<string>',
aws_access_key_id: '<string>',
aws_secret_access_key: '<string>',
aws_session_token: '<string>',
aws_region_name: '<string>',
aws_profile_name: '<string>',
aws_role_name: '<string>',
aws_session_name: '<string>',
aws_bedrock_runtime_endpoint: '<string>',
openrouter_site_url: 'https://docs.all-hands.dev/',
openrouter_app_name: 'OpenHands',
num_retries: 5,
retry_multiplier: 8,
retry_min_wait: 8,
retry_max_wait: 64,
timeout: 300,
max_message_chars: 30000,
temperature: 1,
top_p: 0.5,
top_k: 1,
max_input_tokens: 2,
max_output_tokens: 2,
model_canonical_name: '<string>',
api_mode: 'auto',
capability_overrides: {},
extra_headers: {},
input_cost_per_token: 1,
output_cost_per_token: 1,
ollama_base_url: '<string>',
stream: false,
drop_params: true,
modify_params: true,
disable_vision: true,
disable_stop_word: false,
caching_prompt: true,
log_completions: false,
log_completions_folder: 'logs/completions',
custom_tokenizer: '<string>',
native_tool_calling: true,
force_string_serializer: true,
inline_image_urls: true,
reasoning_effort: 'high',
enable_encrypted_reasoning: true,
prompt_cache_retention: '24h',
extended_thinking_budget: 200000,
seed: 123,
usage_id: 'default',
litellm_extra_body: {},
fallback_strategy: {fallback_llms: ['<string>'], profile_store_dir: '<string>'}
},
preserve_existing_api_key: false
})
};
fetch('https://api.example.com/api/v1/settings/profiles/{name}', 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.example.com/api/v1/settings/profiles/{name}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'include_secrets' => true,
'llm' => [
'model' => 'gpt-5.5',
'api_key' => '<string>',
'auth_type' => 'api_key',
'subscription_vendor' => '<string>',
'base_url' => '<string>',
'api_version' => '<string>',
'aws_access_key_id' => '<string>',
'aws_secret_access_key' => '<string>',
'aws_session_token' => '<string>',
'aws_region_name' => '<string>',
'aws_profile_name' => '<string>',
'aws_role_name' => '<string>',
'aws_session_name' => '<string>',
'aws_bedrock_runtime_endpoint' => '<string>',
'openrouter_site_url' => 'https://docs.all-hands.dev/',
'openrouter_app_name' => 'OpenHands',
'num_retries' => 5,
'retry_multiplier' => 8,
'retry_min_wait' => 8,
'retry_max_wait' => 64,
'timeout' => 300,
'max_message_chars' => 30000,
'temperature' => 1,
'top_p' => 0.5,
'top_k' => 1,
'max_input_tokens' => 2,
'max_output_tokens' => 2,
'model_canonical_name' => '<string>',
'api_mode' => 'auto',
'capability_overrides' => [
],
'extra_headers' => [
],
'input_cost_per_token' => 1,
'output_cost_per_token' => 1,
'ollama_base_url' => '<string>',
'stream' => false,
'drop_params' => true,
'modify_params' => true,
'disable_vision' => true,
'disable_stop_word' => false,
'caching_prompt' => true,
'log_completions' => false,
'log_completions_folder' => 'logs/completions',
'custom_tokenizer' => '<string>',
'native_tool_calling' => true,
'force_string_serializer' => true,
'inline_image_urls' => true,
'reasoning_effort' => 'high',
'enable_encrypted_reasoning' => true,
'prompt_cache_retention' => '24h',
'extended_thinking_budget' => 200000,
'seed' => 123,
'usage_id' => 'default',
'litellm_extra_body' => [
],
'fallback_strategy' => [
'fallback_llms' => [
'<string>'
],
'profile_store_dir' => '<string>'
]
],
'preserve_existing_api_key' => false
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Access-Token: <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.example.com/api/v1/settings/profiles/{name}"
payload := strings.NewReader("{\n \"include_secrets\": true,\n \"llm\": {\n \"model\": \"gpt-5.5\",\n \"api_key\": \"<string>\",\n \"auth_type\": \"api_key\",\n \"subscription_vendor\": \"<string>\",\n \"base_url\": \"<string>\",\n \"api_version\": \"<string>\",\n \"aws_access_key_id\": \"<string>\",\n \"aws_secret_access_key\": \"<string>\",\n \"aws_session_token\": \"<string>\",\n \"aws_region_name\": \"<string>\",\n \"aws_profile_name\": \"<string>\",\n \"aws_role_name\": \"<string>\",\n \"aws_session_name\": \"<string>\",\n \"aws_bedrock_runtime_endpoint\": \"<string>\",\n \"openrouter_site_url\": \"https://docs.all-hands.dev/\",\n \"openrouter_app_name\": \"OpenHands\",\n \"num_retries\": 5,\n \"retry_multiplier\": 8,\n \"retry_min_wait\": 8,\n \"retry_max_wait\": 64,\n \"timeout\": 300,\n \"max_message_chars\": 30000,\n \"temperature\": 1,\n \"top_p\": 0.5,\n \"top_k\": 1,\n \"max_input_tokens\": 2,\n \"max_output_tokens\": 2,\n \"model_canonical_name\": \"<string>\",\n \"api_mode\": \"auto\",\n \"capability_overrides\": {},\n \"extra_headers\": {},\n \"input_cost_per_token\": 1,\n \"output_cost_per_token\": 1,\n \"ollama_base_url\": \"<string>\",\n \"stream\": false,\n \"drop_params\": true,\n \"modify_params\": true,\n \"disable_vision\": true,\n \"disable_stop_word\": false,\n \"caching_prompt\": true,\n \"log_completions\": false,\n \"log_completions_folder\": \"logs/completions\",\n \"custom_tokenizer\": \"<string>\",\n \"native_tool_calling\": true,\n \"force_string_serializer\": true,\n \"inline_image_urls\": true,\n \"reasoning_effort\": \"high\",\n \"enable_encrypted_reasoning\": true,\n \"prompt_cache_retention\": \"24h\",\n \"extended_thinking_budget\": 200000,\n \"seed\": 123,\n \"usage_id\": \"default\",\n \"litellm_extra_body\": {},\n \"fallback_strategy\": {\n \"fallback_llms\": [\n \"<string>\"\n ],\n \"profile_store_dir\": \"<string>\"\n }\n },\n \"preserve_existing_api_key\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Access-Token", "<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.post("https://api.example.com/api/v1/settings/profiles/{name}")
.header("X-Access-Token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"include_secrets\": true,\n \"llm\": {\n \"model\": \"gpt-5.5\",\n \"api_key\": \"<string>\",\n \"auth_type\": \"api_key\",\n \"subscription_vendor\": \"<string>\",\n \"base_url\": \"<string>\",\n \"api_version\": \"<string>\",\n \"aws_access_key_id\": \"<string>\",\n \"aws_secret_access_key\": \"<string>\",\n \"aws_session_token\": \"<string>\",\n \"aws_region_name\": \"<string>\",\n \"aws_profile_name\": \"<string>\",\n \"aws_role_name\": \"<string>\",\n \"aws_session_name\": \"<string>\",\n \"aws_bedrock_runtime_endpoint\": \"<string>\",\n \"openrouter_site_url\": \"https://docs.all-hands.dev/\",\n \"openrouter_app_name\": \"OpenHands\",\n \"num_retries\": 5,\n \"retry_multiplier\": 8,\n \"retry_min_wait\": 8,\n \"retry_max_wait\": 64,\n \"timeout\": 300,\n \"max_message_chars\": 30000,\n \"temperature\": 1,\n \"top_p\": 0.5,\n \"top_k\": 1,\n \"max_input_tokens\": 2,\n \"max_output_tokens\": 2,\n \"model_canonical_name\": \"<string>\",\n \"api_mode\": \"auto\",\n \"capability_overrides\": {},\n \"extra_headers\": {},\n \"input_cost_per_token\": 1,\n \"output_cost_per_token\": 1,\n \"ollama_base_url\": \"<string>\",\n \"stream\": false,\n \"drop_params\": true,\n \"modify_params\": true,\n \"disable_vision\": true,\n \"disable_stop_word\": false,\n \"caching_prompt\": true,\n \"log_completions\": false,\n \"log_completions_folder\": \"logs/completions\",\n \"custom_tokenizer\": \"<string>\",\n \"native_tool_calling\": true,\n \"force_string_serializer\": true,\n \"inline_image_urls\": true,\n \"reasoning_effort\": \"high\",\n \"enable_encrypted_reasoning\": true,\n \"prompt_cache_retention\": \"24h\",\n \"extended_thinking_budget\": 200000,\n \"seed\": 123,\n \"usage_id\": \"default\",\n \"litellm_extra_body\": {},\n \"fallback_strategy\": {\n \"fallback_llms\": [\n \"<string>\"\n ],\n \"profile_store_dir\": \"<string>\"\n }\n },\n \"preserve_existing_api_key\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/settings/profiles/{name}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Access-Token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"include_secrets\": true,\n \"llm\": {\n \"model\": \"gpt-5.5\",\n \"api_key\": \"<string>\",\n \"auth_type\": \"api_key\",\n \"subscription_vendor\": \"<string>\",\n \"base_url\": \"<string>\",\n \"api_version\": \"<string>\",\n \"aws_access_key_id\": \"<string>\",\n \"aws_secret_access_key\": \"<string>\",\n \"aws_session_token\": \"<string>\",\n \"aws_region_name\": \"<string>\",\n \"aws_profile_name\": \"<string>\",\n \"aws_role_name\": \"<string>\",\n \"aws_session_name\": \"<string>\",\n \"aws_bedrock_runtime_endpoint\": \"<string>\",\n \"openrouter_site_url\": \"https://docs.all-hands.dev/\",\n \"openrouter_app_name\": \"OpenHands\",\n \"num_retries\": 5,\n \"retry_multiplier\": 8,\n \"retry_min_wait\": 8,\n \"retry_max_wait\": 64,\n \"timeout\": 300,\n \"max_message_chars\": 30000,\n \"temperature\": 1,\n \"top_p\": 0.5,\n \"top_k\": 1,\n \"max_input_tokens\": 2,\n \"max_output_tokens\": 2,\n \"model_canonical_name\": \"<string>\",\n \"api_mode\": \"auto\",\n \"capability_overrides\": {},\n \"extra_headers\": {},\n \"input_cost_per_token\": 1,\n \"output_cost_per_token\": 1,\n \"ollama_base_url\": \"<string>\",\n \"stream\": false,\n \"drop_params\": true,\n \"modify_params\": true,\n \"disable_vision\": true,\n \"disable_stop_word\": false,\n \"caching_prompt\": true,\n \"log_completions\": false,\n \"log_completions_folder\": \"logs/completions\",\n \"custom_tokenizer\": \"<string>\",\n \"native_tool_calling\": true,\n \"force_string_serializer\": true,\n \"inline_image_urls\": true,\n \"reasoning_effort\": \"high\",\n \"enable_encrypted_reasoning\": true,\n \"prompt_cache_retention\": \"24h\",\n \"extended_thinking_budget\": 200000,\n \"seed\": 123,\n \"usage_id\": \"default\",\n \"litellm_extra_body\": {},\n \"fallback_strategy\": {\n \"fallback_llms\": [\n \"<string>\"\n ],\n \"profile_store_dir\": \"<string>\"\n }\n },\n \"preserve_existing_api_key\": false\n}"
response = http.request(request)
puts response.read_body{
"name": "<string>",
"message": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Authorizations
Path Parameters
Required string length:
1 - 64Pattern:
^[A-Za-z0-9._-]{1,64}$Body
application/json
Request body for saving a profile.
If llm is provided, it is used as the profile config; otherwise the
current agent_settings.llm is saved. The llm field is typed as
:class:StrictLLM, which forbids unknown keys — so a typo like
{"llm": {"custom_header": "x"}} returns 422 instead of being silently
dropped.
Security note: when llm.api_key is included in the request body,
it is transmitted in plaintext over the wire and present in any request
log or error trace that captures request bodies. SecretStr masks it
in Pydantic reprs, but callers and operators should still avoid logging
raw request bodies on this endpoint.
LLM variant that rejects unknown fields.
The base LLM model has extra='ignore', so typos and renamed keys
silently disappear. For API input we want to fail loud, otherwise users
can POST {"llm": {"custom_header": "x"}} and get a 201 with the
field quietly dropped.
Show child attributes
Show child attributes
Was this page helpful?
⌘I