curl --request PUT \
--url https://api.calibrate.artpark.ai/agents/{agent_uuid} \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"name": "<string>",
"config": {}
}
'import requests
url = "https://api.calibrate.artpark.ai/agents/{agent_uuid}"
payload = {
"name": "<string>",
"config": {}
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text){
"uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"name": "<string>",
"type": "agent",
"interaction_type": "conversation",
"created_at": "<string>",
"updated_at": "<string>",
"config": {}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Update agent
Update an agent’s configuration
curl --request PUT \
--url https://api.calibrate.artpark.ai/agents/{agent_uuid} \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"name": "<string>",
"config": {}
}
'import requests
url = "https://api.calibrate.artpark.ai/agents/{agent_uuid}"
payload = {
"name": "<string>",
"config": {}
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text){
"uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"name": "<string>",
"type": "agent",
"interaction_type": "conversation",
"created_at": "<string>",
"updated_at": "<string>",
"config": {}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Authorizations
API key for authentication
Path Parameters
The agent to update
"f47ac10b-58cc-4372-a567-0e02b2c3d479"
Body
New agent name. Omit to leave the name unchanged
Agent behavioral config. The keys depend on type.
type=agent, built inside Calibrate:
system_prompt: the agent's instructionsllm.model:provider/model, e.g.openai/gpt-4.1orgoogle/gemini-2.5-flashstt.provider:deepgram,openai,cartesia,elevenlabs,google,sarvam, orsmallesttts.provider:cartesia,openai,google,elevenlabs,sarvam, orsmallestsettings.agent_speaks_first,settings.max_assistant_turnssystem_tools.end_call: let the agent end the calldata_extraction_fields:[{name, type, description, required}]
{
"system_prompt": "You are a helpful support agent.",
"llm": {"model": "openai/gpt-4.1"},
"stt": {"provider": "deepgram"},
"tts": {"provider": "elevenlabs"},
"settings": {"agent_speaks_first": true, "max_assistant_turns": 50}
}
type=connection, your own HTTP endpoint:
agent_url: public HTTP(S) endpoint your agent is called atagent_headers: headers sent on each request, e.g. authbenchmark_provider:openrouterby default. Other values:openai,google,anthropic,meta-llama,mistralai,deepseek,x-ai,cohere,qwen, orai21
{
"agent_url": "https://api.example.com/agent",
"agent_headers": {"Authorization": "Bearer <token>"},
"benchmark_provider": "openrouter"
}
Either type:
traces.scoring.enabled: whether the traces you send for this agent are scored by its linked evaluators. On unless you set it tofalse. Turning it back on needs at least one linked evaluator that can score traces
{"traces": {"scoring": {"enabled": false}}}
Every request Calibrate makes to your endpoint carries the header
X-Calibrate-Eval: 1. Read it to tell a test run from a real user, for example
to tag the trace you send back or to skip sending one.
Replaces the stored config. Omit to leave unchanged
For type=connection, changing agent_url or agent_headers resets the connection and benchmark verification flags
Response
Successful Response
ID of the agent
36"f47ac10b-58cc-4372-a567-0e02b2c3d479"
Name of the agent
agent: built inside Calibrateconnection: your existing agent connected to Calibrate
agent, connection What the agent expects in the request body:
conversation: a normal back-and-forth agent, answers within an ongoing conversation. Receives{"messages": [...]}general: a one-shot agent, takes a single plain input and produces a single plain output, no conversation. Receives{"input": "..."}
conversation, general When the agent was created (ISO 8601 UTC)
When the agent was last updated (ISO 8601 UTC)
Agent configuration