GET
/v1/builds/{buildId}/logsStream build logs⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️
Streams the full build log for a build as newline-delimited JSON (application/x-ndjson). Each line is a JSON object discriminated by type: log (a build output line) or terminal (end-of-stream marker with a cursor for resumption). The default is a finite dump that ends once the stream is drained; pass follow=true to keep the connection open for an in-flight build, and cursor to resume from a prior terminal cursor.
Parameters
buildIdstringpathrequiredfollowstringquerycursorstringqueryResponses
value
oneOf · 2 options
Option 1object
cursorstringrequiredlevelstringrequiredsourcestringrequiredstepstringtextstringrequiredtypestringrequiredOption 2object
codestringrequiredcursornull | stringrequiredkindstringrequiredmessagestringrequiredretryablebooleanrequiredtypestringrequired{
"code": "string",
"cursor": "string",
"kind": "end",
"message": "string",
"retryable": true,
"type": "terminal"
}object
errorobjectrequiredShow child attributes
codestringrequiredhintstringmessagestringrequired{
"error": {
"code": "string",
"hint": "string",
"message": "string"
}
}object
errorobjectrequiredShow child attributes
codestringrequiredhintstringmessagestringrequired{
"error": {
"code": "string",
"hint": "string",
"message": "string"
}
}object
errorobjectrequiredShow child attributes
codestringrequiredhintstringmessagestringrequired{
"error": {
"code": "string",
"hint": "string",
"message": "string"
}
}