SandboxesSandbox TemplatesTemplate builds

Read a template build's log

Read a build's log, oldest first. A log is kept for seven days; the build's own status and timings outlive it.

GET
/v1/template-builds/{buildId}/logs

Read a build's log, oldest first. A log is kept for seven days; the build's own status and timings outlive it.

AuthorizationBearer <token>

API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.

In: header

Path Parameters

buildId*string

Build ULID

Lengthlength <= 64

Query Parameters

cursor?string

Continue from this position, taken from the next_cursor of a previous page read in the same direction. Omit it to start at the beginning of the build going forward, or at its end going backward.

Lengthlength <= 128
direction?string

forward reads from the cursor towards the end of the build, backward reads from it towards the beginning. Backward is how a console opens a finished build, because the failure is the last line. Forward by default.

Value in

  • "forward"
  • "backward"
level?string

Narrow to one level

Value in

  • "debug"
  • "info"
  • "warn"
  • "error"
limit?integer

Page size, 200 by default

Formatint32
Range1 <= value <= 1000

Response Body

application/json

application/problem+json

curl -X GET "https://example.com/v1/template-builds/string/logs"
{  "items": [    {      "at": "2019-08-24T14:15:22Z",      "attempt": 0,      "level": "debug",      "message": "string",      "step_index": 0,      "step_name": "string"    }  ],  "pagination": {    "end_cursor": "string",    "has_more": true,    "next_cursor": "string"  }}