Get the build log

⚠️
Preview — this feature is being built; the design below is the spec.
GET https://app.syntic.ai/v1/environments/{environment_id}/build_log

Return the plain-text log of the environment’s most recent build. Read it when build.status is failed: the last lines usually name the package or script step that broke.

For how this fits into a full workflow, see Environments.

Headers

HeaderRequiredValue
AuthorizationYesBearer <key>: a private inference key (sk_live_...). See Authentication.
syntic-betaYes, while in previewagents-2026-11-01. Without it the call fails with 400 beta_required. See Versioning.

Path parameters

ParameterTypeDescription
environment_idstringThe environment id, starting with env_.

Response

200 OK

Content-Type: text/plain; charset=utf-8. Logs are kept for 30 days and capped at 5 MB, keeping the end of the log.

Examples

curl -sS -o build.log https://app.syntic.ai/v1/environments/env_01JC5B2D4F6H8K0M2P4R/build_log \
  -H "Authorization: Bearer $SYNTIC_API_KEY" \
  -H "syntic-beta: agents-2026-11-01"

Errors

Errors use the error envelope and carry a request_id. Codes specific to this operation:

StatustypecodeWhen
400invalid_request_errorbeta_requiredThe syntic-beta header is missing.
404not_found_errorenvironment_not_foundNo environment with that id in this workspace.
401authentication_errorinvalid_api_keyThe key is missing, unknown, revoked or expired.
429rate_limit_errorrate_limitedToo many requests; wait for Retry-After. See Rate-limit headers.
Was this page helpful?