Deployments

Build and deploy log of a deployment of this project (by line offset)

get/projects/{projectId}/deployments/{deploymentId}/logs

Request

  • Base URL: https://hostingsurge.com/api/v1
  • URL: https://hostingsurge.com/api/v1/projects/{projectId}/deployments/{deploymentId}/logs
  • Auth: one of:
    • HTTP bearer
    • API key in cookie __Host-hs_session

Path parameters

projectIdstring uuid required
Example:3f2b8a4e-5c1d-4e8f-9a7b-2c6d1e0f4a5b
deploymentIdstring uuid required
Example:3f2b8a4e-5c1d-4e8f-9a7b-2c6d1e0f4a5b

Query parameters

sinceinteger nullable

Line offset: the number of log lines already received (0-based index of the first line to return). The build log is append-only, so offsets are stable; send the previous response's nextSince. Beyond the end: no lines, nextSince = line count.

Response

Lines [since, nextSince) of the build log; 404 unless the deployment belongs to the project

completeboolean required

true when the deployment finished and its whole log was read (false while the engine is too busy to read the end of a finished build: ask again)

sinceinteger required

the line offset this page starts at (the request's since, capped at the log length)

nextSinceinteger required

send this as ?since= to receive only later lines

Changes

No recorded changes to this operation across all 1 revision of this API.