Get Build Logs

Retrieve the logs for a specific build

GET /builds/{buildId}/logs

Get build logs

cURL

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

200

{
  "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 the limit 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[]'

Common issues visible in build logs include:

• Missing dependencies in requirements.txt
• Dockerfile syntax errors
• Failed pip install commands
• Missing files referenced in COPY instructions

Authorizations

Authorization · string · header · required

Authentication using a Pipecat Cloud API token.

Path Parameters

buildId · string<uuid> · required

Unique identifier of the build.

Query Parameters

limit · integer · default: 500

Maximum number of log events to return.

Required range: 1 <= x <= 10000

Response

200

application/json

Build logs retrieved successfully

logs · string[] · required

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"
]

nextToken · string

Pagination token for retrieving additional logs. Present when more logs are available.

Example:

"eyJuZXh0VG9rZW4iOiAiYWJjMTIzIn0="