get_deployment_build_logs

Tail build logs for a deployment, or stream an in-flight build by offset.

Returns build logs for a deployment, the output of the build pipeline. Defaults to the last 100 lines. Read-only.

There are two modes:

  • Tail (default, or with lines), return the last N lines.
  • Offset streaming (with offset, no lines), stream forward from a character offset. Use a previous response's nextOffset to resume following an in-flight build.

lines takes precedence if both are set.

Parameters

ParameterTypeRequiredDescription
organizationIdstringYesOrganization that owns the deployment. From list_organizations.
deploymentIdstringYesThe deployment whose build logs you want. From list_deployments.
linesnumberNoReturn only the last N lines (1–5000, default 100).
offsetnumberNoCharacter offset to stream forward from. Ignored if lines is set.

Returns

The log text plus the build status when available. Tail mode includes returnedLines and totalLength; offset mode includes pagination info with nextOffset.

Typical use

Debugging a failed deployment: find it with list_deployments (status: "failed"), then read its build logs here.

On this page