Get build logs
curl --request GET \
--url https://api.pipecat.daily.co/v1/builds/{buildId}/logs \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.pipecat.daily.co/v1/builds/{buildId}/logs"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.pipecat.daily.co/v1/builds/{buildId}/logs', 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/builds/{buildId}/logs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.pipecat.daily.co/v1/builds/{buildId}/logs"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.pipecat.daily.co/v1/builds/{buildId}/logs")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pipecat.daily.co/v1/builds/{buildId}/logs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"logs": [
"[Container] 2026/03/04 10:00:00 Entering phase: INSTALL",
"[Container] 2026/03/04 10:00:01 Running command pip install -r requirements.txt",
"[Container] 2026/03/04 10:00:05 Successfully installed pipecat-ai-0.1.0"
],
"nextToken": "eyJuZXh0VG9rZW4iOiAiYWJjMTIzIn0="
}{
"error": "<string>",
"code": "<string>"
}{
"error": "<string>",
"code": "<string>"
}Get Build Logs
GET /builds//logs returns the build logs for a specific Pipecat Cloud build.
GET
/
builds
/
{buildId}
/
logs
Get build logs
curl --request GET \
--url https://api.pipecat.daily.co/v1/builds/{buildId}/logs \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.pipecat.daily.co/v1/builds/{buildId}/logs"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.pipecat.daily.co/v1/builds/{buildId}/logs', 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/builds/{buildId}/logs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.pipecat.daily.co/v1/builds/{buildId}/logs"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.pipecat.daily.co/v1/builds/{buildId}/logs")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pipecat.daily.co/v1/builds/{buildId}/logs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"logs": [
"[Container] 2026/03/04 10:00:00 Entering phase: INSTALL",
"[Container] 2026/03/04 10:00:01 Running command pip install -r requirements.txt",
"[Container] 2026/03/04 10:00:05 Successfully installed pipecat-ai-0.1.0"
],
"nextToken": "eyJuZXh0VG9rZW4iOiAiYWJjMTIzIn0="
}{
"error": "<string>",
"code": "<string>"
}{
"error": "<string>",
"code": "<string>"
}Streaming Logs During Build
You can poll this endpoint during a build to stream logs in real-time. The endpoint returns the latest logs each time you call it:BUILD_ID="123e4567-e89b-12d3-a456-426614174000"
while true; do
RESPONSE=$(curl -s "https://api.pipecat.daily.co/v1/builds/$BUILD_ID/logs?limit=100" \
-H "Authorization: Bearer $PIPECAT_API_KEY")
echo "$RESPONSE" | jq -r '.logs[]'
# Check if build is still in progress
BUILD_STATUS=$(curl -s "https://api.pipecat.daily.co/v1/builds/$BUILD_ID" \
-H "Authorization: Bearer $PIPECAT_API_KEY" | jq -r '.build.status')
if [[ "$BUILD_STATUS" == "success" || "$BUILD_STATUS" == "failed" || "$BUILD_STATUS" == "timeout" ]]; then
echo "Build finished with status: $BUILD_STATUS"
break
fi
sleep 5
done
Pagination
Use thelimit query parameter to control how many log lines are returned:
| Parameter | Default | Min | Max | Description |
|---|---|---|---|---|
limit | 500 | 1 | 10,000 | Number of log events to return |
Logs may be empty if the build was just created and hasn’t started executing
yet. Continue polling until logs appear or the build completes.
Debugging Failed Builds
When a build fails, use this endpoint to diagnose the issue:BUILD_ID="123e4567-e89b-12d3-a456-426614174000"
# Get the full build logs
curl -s "https://api.pipecat.daily.co/v1/builds/$BUILD_ID/logs?limit=10000" \
-H "Authorization: Bearer $PIPECAT_API_KEY" | jq -r '.logs[]'
- Missing dependencies in
requirements.txt - Dockerfile syntax errors
- Failed
pip installcommands - Missing files referenced in
COPYinstructions
Query Parameters
Response
Build logs retrieved successfully
Array of log lines from the build process. May be empty if the build hasn't started generating logs yet.
Example:
[
"[Container] 2026/03/04 10:00:00 Entering phase: INSTALL",
"[Container] 2026/03/04 10:00:01 Running command pip install -r requirements.txt",
"[Container] 2026/03/04 10:00:05 Successfully installed pipecat-ai-0.1.0"
]