curl --request POST \
--url https://api.pipecat.daily.co/v1/agents/{agentName} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"image": "your-dockername/voice-starter:0.1",
"architecture": "arm64",
"imagePullSecretSet": "dockerhub-credentials",
"secretSet": "voice-starter-secrets",
"autoScaling": {
"minAgents": 1,
"maxAgents": 10
},
"krispViva": {
"audioFilter": "tel"
},
"agentProfile": "agent-1x",
"maxSessionDuration": 3600
}
'import requests
url = "https://api.pipecat.daily.co/v1/agents/{agentName}"
payload = {
"image": "your-dockername/voice-starter:0.1",
"architecture": "arm64",
"imagePullSecretSet": "dockerhub-credentials",
"secretSet": "voice-starter-secrets",
"autoScaling": {
"minAgents": 1,
"maxAgents": 10
},
"krispViva": { "audioFilter": "tel" },
"agentProfile": "agent-1x",
"maxSessionDuration": 3600
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
image: 'your-dockername/voice-starter:0.1',
architecture: 'arm64',
imagePullSecretSet: 'dockerhub-credentials',
secretSet: 'voice-starter-secrets',
autoScaling: {minAgents: 1, maxAgents: 10},
krispViva: {audioFilter: 'tel'},
agentProfile: 'agent-1x',
maxSessionDuration: 3600
})
};
fetch('https://api.pipecat.daily.co/v1/agents/{agentName}', 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.pipecat.daily.co/v1/agents/{agentName}",
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([
'image' => 'your-dockername/voice-starter:0.1',
'architecture' => 'arm64',
'imagePullSecretSet' => 'dockerhub-credentials',
'secretSet' => 'voice-starter-secrets',
'autoScaling' => [
'minAgents' => 1,
'maxAgents' => 10
],
'krispViva' => [
'audioFilter' => 'tel'
],
'agentProfile' => 'agent-1x',
'maxSessionDuration' => 3600
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.pipecat.daily.co/v1/agents/{agentName}"
payload := strings.NewReader("{\n \"image\": \"your-dockername/voice-starter:0.1\",\n \"architecture\": \"arm64\",\n \"imagePullSecretSet\": \"dockerhub-credentials\",\n \"secretSet\": \"voice-starter-secrets\",\n \"autoScaling\": {\n \"minAgents\": 1,\n \"maxAgents\": 10\n },\n \"krispViva\": {\n \"audioFilter\": \"tel\"\n },\n \"agentProfile\": \"agent-1x\",\n \"maxSessionDuration\": 3600\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.pipecat.daily.co/v1/agents/{agentName}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"image\": \"your-dockername/voice-starter:0.1\",\n \"architecture\": \"arm64\",\n \"imagePullSecretSet\": \"dockerhub-credentials\",\n \"secretSet\": \"voice-starter-secrets\",\n \"autoScaling\": {\n \"minAgents\": 1,\n \"maxAgents\": 10\n },\n \"krispViva\": {\n \"audioFilter\": \"tel\"\n },\n \"agentProfile\": \"agent-1x\",\n \"maxSessionDuration\": 3600\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pipecat.daily.co/v1/agents/{agentName}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"image\": \"your-dockername/voice-starter:0.1\",\n \"architecture\": \"arm64\",\n \"imagePullSecretSet\": \"dockerhub-credentials\",\n \"secretSet\": \"voice-starter-secrets\",\n \"autoScaling\": {\n \"minAgents\": 1,\n \"maxAgents\": 10\n },\n \"krispViva\": {\n \"audioFilter\": \"tel\"\n },\n \"agentProfile\": \"agent-1x\",\n \"maxSessionDuration\": 3600\n}"
response = http.request(request)
puts response.read_body{
"name": "voice-starter",
"region": "us-west",
"ready": true,
"available": true,
"createdAt": "2025-04-19T01:20:27.564Z",
"updatedAt": "2025-04-19T01:25:47.229Z",
"desiredDeploymentId": "19db578d-808c-420a-a047-87edde4410c1",
"activeDeploymentId": "19db578d-808c-420a-a047-87edde4410c1",
"reconciledDeploymentId": "19db578d-808c-420a-a047-87edde4410c1",
"activeDeploymentReady": true,
"autoScaling": {
"maxReplicas": 10,
"minReplicas": 1
},
"activeSessionCount": 0,
"agentProfile": "agent-1x",
"deployment": {
"id": "19db578d-808c-420a-a047-87edde4410c1",
"manifest": {
"apiVersion": "pipecatcloud.daily.co/v1",
"kind": "PCService",
"metadata": {
"name": "voice-starter",
"namespace": "tiny-ferret-maroon-123"
},
"spec": {
"dailyNodeType": "arm",
"image": "your-dockername/voice-starter:0.1",
"autoScaling": {
"minReplicas": 1,
"maxReplicas": 10
},
"imagePullSecretName": "dockerhub-credentials",
"envFromSecretNames": [
"voice-starter-secrets"
],
"resources": {
"cpu": "500m",
"memory": "1Gi"
},
"krispModels": {
"enabled": false
},
"krispViva": {
"audioFilters": true
},
"maxSessionDurationSeconds": 3600
}
},
"serviceId": "b59a68ee-61c8-4d99-9ceb-e99a3953bdac",
"createdAt": "2025-04-19T01:25:47.225Z",
"updatedAt": "2025-04-19T01:25:47.225Z"
},
"krispViva": {
"audioFilter": "tel"
},
"currentRevision": {
"deploymentID": "19db578d-808c-420a-a047-87edde4410c1",
"phase": "Active",
"readyReplicas": 1,
"phaseStartedAt": "2025-04-19T01:26:00.000Z",
"health": {
"ready": true,
"state": "running",
"restartCount": 0,
"replicasStarted": 1
}
},
"previousRevision": null
}Update an Agent
POST /agents/ updates an existing Pipecat Cloud agent’s configuration or deploys a new version of its image.
curl --request POST \
--url https://api.pipecat.daily.co/v1/agents/{agentName} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"image": "your-dockername/voice-starter:0.1",
"architecture": "arm64",
"imagePullSecretSet": "dockerhub-credentials",
"secretSet": "voice-starter-secrets",
"autoScaling": {
"minAgents": 1,
"maxAgents": 10
},
"krispViva": {
"audioFilter": "tel"
},
"agentProfile": "agent-1x",
"maxSessionDuration": 3600
}
'import requests
url = "https://api.pipecat.daily.co/v1/agents/{agentName}"
payload = {
"image": "your-dockername/voice-starter:0.1",
"architecture": "arm64",
"imagePullSecretSet": "dockerhub-credentials",
"secretSet": "voice-starter-secrets",
"autoScaling": {
"minAgents": 1,
"maxAgents": 10
},
"krispViva": { "audioFilter": "tel" },
"agentProfile": "agent-1x",
"maxSessionDuration": 3600
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
image: 'your-dockername/voice-starter:0.1',
architecture: 'arm64',
imagePullSecretSet: 'dockerhub-credentials',
secretSet: 'voice-starter-secrets',
autoScaling: {minAgents: 1, maxAgents: 10},
krispViva: {audioFilter: 'tel'},
agentProfile: 'agent-1x',
maxSessionDuration: 3600
})
};
fetch('https://api.pipecat.daily.co/v1/agents/{agentName}', 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.pipecat.daily.co/v1/agents/{agentName}",
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([
'image' => 'your-dockername/voice-starter:0.1',
'architecture' => 'arm64',
'imagePullSecretSet' => 'dockerhub-credentials',
'secretSet' => 'voice-starter-secrets',
'autoScaling' => [
'minAgents' => 1,
'maxAgents' => 10
],
'krispViva' => [
'audioFilter' => 'tel'
],
'agentProfile' => 'agent-1x',
'maxSessionDuration' => 3600
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.pipecat.daily.co/v1/agents/{agentName}"
payload := strings.NewReader("{\n \"image\": \"your-dockername/voice-starter:0.1\",\n \"architecture\": \"arm64\",\n \"imagePullSecretSet\": \"dockerhub-credentials\",\n \"secretSet\": \"voice-starter-secrets\",\n \"autoScaling\": {\n \"minAgents\": 1,\n \"maxAgents\": 10\n },\n \"krispViva\": {\n \"audioFilter\": \"tel\"\n },\n \"agentProfile\": \"agent-1x\",\n \"maxSessionDuration\": 3600\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.pipecat.daily.co/v1/agents/{agentName}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"image\": \"your-dockername/voice-starter:0.1\",\n \"architecture\": \"arm64\",\n \"imagePullSecretSet\": \"dockerhub-credentials\",\n \"secretSet\": \"voice-starter-secrets\",\n \"autoScaling\": {\n \"minAgents\": 1,\n \"maxAgents\": 10\n },\n \"krispViva\": {\n \"audioFilter\": \"tel\"\n },\n \"agentProfile\": \"agent-1x\",\n \"maxSessionDuration\": 3600\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pipecat.daily.co/v1/agents/{agentName}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"image\": \"your-dockername/voice-starter:0.1\",\n \"architecture\": \"arm64\",\n \"imagePullSecretSet\": \"dockerhub-credentials\",\n \"secretSet\": \"voice-starter-secrets\",\n \"autoScaling\": {\n \"minAgents\": 1,\n \"maxAgents\": 10\n },\n \"krispViva\": {\n \"audioFilter\": \"tel\"\n },\n \"agentProfile\": \"agent-1x\",\n \"maxSessionDuration\": 3600\n}"
response = http.request(request)
puts response.read_body{
"name": "voice-starter",
"region": "us-west",
"ready": true,
"available": true,
"createdAt": "2025-04-19T01:20:27.564Z",
"updatedAt": "2025-04-19T01:25:47.229Z",
"desiredDeploymentId": "19db578d-808c-420a-a047-87edde4410c1",
"activeDeploymentId": "19db578d-808c-420a-a047-87edde4410c1",
"reconciledDeploymentId": "19db578d-808c-420a-a047-87edde4410c1",
"activeDeploymentReady": true,
"autoScaling": {
"maxReplicas": 10,
"minReplicas": 1
},
"activeSessionCount": 0,
"agentProfile": "agent-1x",
"deployment": {
"id": "19db578d-808c-420a-a047-87edde4410c1",
"manifest": {
"apiVersion": "pipecatcloud.daily.co/v1",
"kind": "PCService",
"metadata": {
"name": "voice-starter",
"namespace": "tiny-ferret-maroon-123"
},
"spec": {
"dailyNodeType": "arm",
"image": "your-dockername/voice-starter:0.1",
"autoScaling": {
"minReplicas": 1,
"maxReplicas": 10
},
"imagePullSecretName": "dockerhub-credentials",
"envFromSecretNames": [
"voice-starter-secrets"
],
"resources": {
"cpu": "500m",
"memory": "1Gi"
},
"krispModels": {
"enabled": false
},
"krispViva": {
"audioFilters": true
},
"maxSessionDurationSeconds": 3600
}
},
"serviceId": "b59a68ee-61c8-4d99-9ceb-e99a3953bdac",
"createdAt": "2025-04-19T01:25:47.225Z",
"updatedAt": "2025-04-19T01:25:47.225Z"
},
"krispViva": {
"audioFilter": "tel"
},
"currentRevision": {
"deploymentID": "19db578d-808c-420a-a047-87edde4410c1",
"phase": "Active",
"readyReplicas": 1,
"phaseStartedAt": "2025-04-19T01:26:00.000Z",
"health": {
"ready": true,
"state": "running",
"restartCount": 0,
"replicasStarted": 1
}
},
"previousRevision": null
}Authorizations
Body
Target CPU architecture for the agent's containers: amd64 or arm64. Must be one of the architectures the target region supports (see the supported_architectures field on List available regions). If omitted, the region's default architecture is used. Daily-hosted regions currently support arm64 only. Set this explicitly when your image is built for a single architecture so it schedules on matching nodes instead of failing at startup.
amd64, arm64 "arm64"
Krisp VIVA noise cancellation configuration. Learn more.
Show child attributes
Show child attributes
The agent profile to use for resource allocation. Valid values are:
agent-1x: 0.5 vCPU and 1 GB of memory. Best for voice agents.agent-2x: 1 vCPU and 2 GB of memory. Well suited for voice and video agents or voice agents requiring extra processing.agent-3x: 1.5 vCPU and 3 GB of memory. Best for voice and video agents requiring extra processing or multiple video inputs.
In a self-hosted region, this may also name one of your organization's own profiles, or be omitted in favour of resources.
agent-1x, agent-2x, agent-3x "agent-1x"
Maximum session duration in seconds. When a session reaches this limit, the session is stopped: the bot is cancelled, with no opportunity for it to say goodbye first. Valid range: 60 to 14400 (4 hours). Defaults to 7200 (2 hours) when unset.
60 <= x <= 144003600
Response
Agent deployment updated successfully
Whether the agent can accept new sessions. True when any pods are ready to handle traffic, or when scaled to zero but healthy (requests will queue and trigger scale-up). During rolling updates, this may be true even if ready is false, as old pods continue serving while new ones validate.