Get log

GET 
/v2/actor-builds/:buildId/log

Check out Logs for full reference.

Request

Path Parameters

buildId string required
ID of the build, found in the build's Info tab.

Example: soSkq9ekdmfOslopH

Query Parameters

stream boolean
If true or 1 then the logs will be streamed as long as the run or build is running.

Example: false
download boolean
If true or 1 then the web browser will download the log file rather than open it in a tab.

Example: false

Status 200

Response Headers

2017-07-14T06:00:49.733Z Application started.
2017-07-14T06:00:49.741Z Input: { test: 123 }
2017-07-14T06:00:49.752Z Some useful debug information follows.

Schema

• string string
  Example: 2017-07-14T06:00:49.733Z Application started. 2017-07-14T06:00:49.741Z Input: { test: 123 } 2017-07-14T06:00:49.752Z Some useful debug information follows.

Status 400

Bad request - invalid input parameters or request body.

{
  "error": {
    "type": "invalid-input",
    "message": "Invalid input: The request body contains invalid data."
  }
}

Schema

• error object required

  • type ErrorType (string)

    Machine-processable error type identifier.

    Possible values: [actor-memory-limit-exceeded, actor-not-found, invalid-input, method-not-allowed, permission-denied, rate-limit-exceeded, record-not-found, record-not-unique, record-or-token-not-found, request-id-invalid, request-too-large, run-failed, run-timeout-exceeded, token-not-valid, unknown-build-tag, unsupported-content-encoding]

  • message string

    Human-readable error message describing what went wrong.

Status 401

Unauthorized - authentication required or invalid token.

{
  "error": {
    "type": "token-not-valid",
    "message": "Authentication token is not valid."
  }
}

Schema

• error object required

  • type ErrorType (string)

    Machine-processable error type identifier.

    Possible values: [actor-memory-limit-exceeded, actor-not-found, invalid-input, method-not-allowed, permission-denied, rate-limit-exceeded, record-not-found, record-not-unique, record-or-token-not-found, request-id-invalid, request-too-large, run-failed, run-timeout-exceeded, token-not-valid, unknown-build-tag, unsupported-content-encoding]

  • message string

    Human-readable error message describing what went wrong.

Status 403

Forbidden - insufficient permissions to perform this action.

{
  "error": {
    "type": "permission-denied",
    "message": "You do not have permission to perform this action."
  }
}

Schema

• error object required

  • type ErrorType (string)

    Machine-processable error type identifier.

    Possible values: [actor-memory-limit-exceeded, actor-not-found, invalid-input, method-not-allowed, permission-denied, rate-limit-exceeded, record-not-found, record-not-unique, record-or-token-not-found, request-id-invalid, request-too-large, run-failed, run-timeout-exceeded, token-not-valid, unknown-build-tag, unsupported-content-encoding]

  • message string

    Human-readable error message describing what went wrong.

Status 404

Not found - the requested resource was not found.

{
  "error": {
    "type": "record-not-found",
    "message": "Actor build was not found"
  }
}

Schema

• error object

  • type ErrorType (string)

    Machine-processable error type identifier.

    Possible values: [actor-memory-limit-exceeded, actor-not-found, invalid-input, method-not-allowed, permission-denied, rate-limit-exceeded, record-not-found, record-not-unique, record-or-token-not-found, request-id-invalid, request-too-large, run-failed, run-timeout-exceeded, token-not-valid, unknown-build-tag, unsupported-content-encoding]

    
    Constant value: record-not-found
  • message string

    Human-readable error message describing what went wrong.

Status 405

Method not allowed.

{
  "error": {
    "type": "method-not-allowed",
    "message": "This API end-point can only be accessed using the following HTTP methods: OPTIONS,GET"
  }
}

Schema

• error object required

  • type ErrorType (string)

    Machine-processable error type identifier.

    Possible values: [actor-memory-limit-exceeded, actor-not-found, invalid-input, method-not-allowed, permission-denied, rate-limit-exceeded, record-not-found, record-not-unique, record-or-token-not-found, request-id-invalid, request-too-large, run-failed, run-timeout-exceeded, token-not-valid, unknown-build-tag, unsupported-content-encoding]

  • message string

    Human-readable error message describing what went wrong.

Status 429

Too many requests - rate limit exceeded.

{
  "error": {
    "type": "rate-limit-exceeded",
    "message": "You have exceeded the rate limit. Please try again later."
  }
}

Schema

• error object required

  • type ErrorType (string)

    Machine-processable error type identifier.

    Possible values: [actor-memory-limit-exceeded, actor-not-found, invalid-input, method-not-allowed, permission-denied, rate-limit-exceeded, record-not-found, record-not-unique, record-or-token-not-found, request-id-invalid, request-too-large, run-failed, run-timeout-exceeded, token-not-valid, unknown-build-tag, unsupported-content-encoding]

  • message string

    Human-readable error message describing what went wrong.