Get deployment logs

Read build and deployment output, optionally after a previously seen log identifier.

GET/api/deployments/{deploymentId}/logsHTTPS

Request & response examples

Request exampleServer-side

curl --fail-with-body --request GET \
  'https://app.helicarrier.xyz/api/deployments/YOUR_DEPLOYMENT_ID/logs?after=0' \
  -H "Authorization: Bearer $HELI_API_KEY"

const response = await fetch(
  "https://app.helicarrier.xyz/api/deployments/YOUR_DEPLOYMENT_ID/logs?after=0",
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${process.env.HELI_API_KEY}`
    }
  }
);
const data = await response.json();
if (!response.ok) {
  throw new Error(`HTTP ${response.status}: ${data.error}`);
}
// Inspect data; avoid logging secret responses.

import os
import requests

response = requests.request(
    "GET",
    "https://app.helicarrier.xyz/api/deployments/YOUR_DEPLOYMENT_ID/logs?after=0",
    headers={
        "Authorization": f"Bearer {os.environ['HELI_API_KEY']}"
    },
    timeout=30,
)
response.raise_for_status()
data = response.json()
# Inspect data; avoid logging secret responses.

Response example200

[
  {
    "id": 42,
    "deploymentId": "dep_example",
    "line": "Build completed",
    "stream": "system",
    "createdAt": "2026-10-07T12:00:00Z"
  }
]

Illustrative values · selected fields

Response details OpenAPI

Authorization

An account key with access, or a project/service key with logs:read. The resource must be within the key’s project, service, and environment scope.

Authorization: Bearer <key>Key setup

Path parameters

deploymentIdstringrequired

Deployment id.

Query parameters

afterintegeroptional

Return only lines after this sequence number, so a build can be followed incrementally instead of re-fetching the whole log each time.

Response 200

Returns a JSON array of deployment log records. Pass the last sequence number as after to read only newer lines.

Examples show selected response fields with illustrative values. Your response can contain additional fields.

idinteger

Unique identifier of this resource.

deploymentIdstring

Identifier to use when reading deployment history or logs.

linestring

One line of log output.

streamstring

Log stream that produced this line.

createdAtstring

Resource creation timestamp.

Errors

401

The API key is missing, invalid, or revoked.

403

The caller or key scope does not permit this operation.

404

The resource does not exist or is not visible to this caller.

500

The operation could not be completed. Check resource state before retrying a write.

Error handling and safe retries

ALSO AVAILABLE VIA MCP

`get_deployment_logs`

Required MCP arguments: deploymentId. Send path, query, and body fields together as tool arguments.

Connect your agent

import os import requests response = requests.request( "GET", "https://app.helicarrier.xyz/api/deployments/YOUR_DEPLOYMENT_ID/logs?after=0", headers={ "Authorization": f"Bearer {os.environ['HELI_API_KEY']}" }, timeout=30, ) response.raise_for_status() data = response.json() # Inspect data; avoid logging secret responses.