import requests
url = "https://api.pingr.ai/api/v1/agents/agent_12345"
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
payload = {
"name": "Senior Support Specialist",
"is_active": "active",
"agent_config": {
"welcome_message": "Hello! Welcome back to Pingr AI. How can I help?",
"language": "en-US",
"llm_model": "gpt-4o"
}
}
response = requests.put(url, json=payload, headers=headers)
print(response.json())
const response = await fetch("https://api.pingr.ai/api/v1/agents/agent_12345", {
method: "PUT",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
name: "Senior Support Specialist",
is_active: "active",
agent_config: {
welcome_message: "Hello! Welcome back to Pingr AI. How can I help?",
language: "en-US",
llm_model: "gpt-4o"
}
})
});
const data = await response.json();
console.log(data);
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.pingr.ai/api/v1/agents/agent_12345"))
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.PUT(HttpRequest.BodyPublishers.ofString("""
{
"name": "Senior Support Specialist",
"is_active": "active"
}
"""))
.build();
HttpResponse<String> response =
HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
curl -X PUT "https://api.pingr.ai/api/v1/agents/agent_12345" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"name": "Senior Support Specialist",
"is_active": "active"
}'
{
"id": "agent_12345",
"name": "Senior Support Specialist",
"organization_id": "93f35dc2-5d46-4e58-a9ee-038c35d9bcf1",
"timezone": "America/New_York",
"agent_type": "prompt",
"is_active": "active",
"created_at": "2024-05-20T10:15:30Z",
"updated_at": "2026-09-03T14:30:00Z"
}
{
"error": 404,
"message": "Agent not found"
}
Agents
Update agent
Update complete configuration and behavioral parameters of an existing Voice AI agent
PUT
/
api
/
v1
/
agents
/
{agent_id}
import requests
url = "https://api.pingr.ai/api/v1/agents/agent_12345"
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
payload = {
"name": "Senior Support Specialist",
"is_active": "active",
"agent_config": {
"welcome_message": "Hello! Welcome back to Pingr AI. How can I help?",
"language": "en-US",
"llm_model": "gpt-4o"
}
}
response = requests.put(url, json=payload, headers=headers)
print(response.json())
const response = await fetch("https://api.pingr.ai/api/v1/agents/agent_12345", {
method: "PUT",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
name: "Senior Support Specialist",
is_active: "active",
agent_config: {
welcome_message: "Hello! Welcome back to Pingr AI. How can I help?",
language: "en-US",
llm_model: "gpt-4o"
}
})
});
const data = await response.json();
console.log(data);
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.pingr.ai/api/v1/agents/agent_12345"))
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.PUT(HttpRequest.BodyPublishers.ofString("""
{
"name": "Senior Support Specialist",
"is_active": "active"
}
"""))
.build();
HttpResponse<String> response =
HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
curl -X PUT "https://api.pingr.ai/api/v1/agents/agent_12345" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"name": "Senior Support Specialist",
"is_active": "active"
}'
{
"id": "agent_12345",
"name": "Senior Support Specialist",
"organization_id": "93f35dc2-5d46-4e58-a9ee-038c35d9bcf1",
"timezone": "America/New_York",
"agent_type": "prompt",
"is_active": "active",
"created_at": "2024-05-20T10:15:30Z",
"updated_at": "2026-09-03T14:30:00Z"
}
{
"error": 404,
"message": "Agent not found"
}
Perform a full update on an existing Voice AI agent. This overwrites previous voice settings, prompts, and capability integrations with the provided configuration.
Authentication
This endpoint requires Bearer token authentication.Authorization: Bearer <token>
Input parameters
string
required
Unique identifier of the agent to update. Example:
agent_12345 or UUID e4b2d184-7cf1-4560-a292-6284649bcf2e.string
required
Bearer token for authentication. Format:
Bearer <token>.string
Updated display name of the agent.
string
Operational timezone.
string
Operational status flag (
active, inactive).object
Updated configuration payload containing prompts, voice models, and capabilities.
Response Fields
string
Agent identifier.
string
Updated agent name.
string
Updated active status.
string
ISO 8601 timestamp reflecting the update.
import requests
url = "https://api.pingr.ai/api/v1/agents/agent_12345"
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
payload = {
"name": "Senior Support Specialist",
"is_active": "active",
"agent_config": {
"welcome_message": "Hello! Welcome back to Pingr AI. How can I help?",
"language": "en-US",
"llm_model": "gpt-4o"
}
}
response = requests.put(url, json=payload, headers=headers)
print(response.json())
const response = await fetch("https://api.pingr.ai/api/v1/agents/agent_12345", {
method: "PUT",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
name: "Senior Support Specialist",
is_active: "active",
agent_config: {
welcome_message: "Hello! Welcome back to Pingr AI. How can I help?",
language: "en-US",
llm_model: "gpt-4o"
}
})
});
const data = await response.json();
console.log(data);
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.pingr.ai/api/v1/agents/agent_12345"))
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.PUT(HttpRequest.BodyPublishers.ofString("""
{
"name": "Senior Support Specialist",
"is_active": "active"
}
"""))
.build();
HttpResponse<String> response =
HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
curl -X PUT "https://api.pingr.ai/api/v1/agents/agent_12345" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"name": "Senior Support Specialist",
"is_active": "active"
}'
{
"id": "agent_12345",
"name": "Senior Support Specialist",
"organization_id": "93f35dc2-5d46-4e58-a9ee-038c35d9bcf1",
"timezone": "America/New_York",
"agent_type": "prompt",
"is_active": "active",
"created_at": "2024-05-20T10:15:30Z",
"updated_at": "2026-09-03T14:30:00Z"
}
{
"error": 404,
"message": "Agent not found"
}
‹ PreviousNext ›
Delete agent
Permanently remove an existing Voice AI agent
Was this page helpful?