Skip to main content
GET
Get image build logs
Keep the time range fixed when paging with offset. Related guide: Inspect image build logs.

Authorizations

Authorization
string
header
required

Send Authorization: Bearer <api_key>. The legacy Authorization: Api-Key <api_key> scheme is also accepted.

Headers

X-Team-Id
string

Optional team ID. Must match the team_id query parameter when both are supplied. If neither selector is supplied, defaults to the caller's only accessible team. Callers with multiple accessible teams must select a team. Requests without access to any team are forbidden.

Minimum string length: 1

Path Parameters

image_name
string
required

Image repository name.

Minimum string length: 1
Example:

"base-image"

Query Parameters

team_id
string

Optional team ID. Must match X-Team-Id when both are supplied. If neither selector is supplied, defaults to the caller's only accessible team. Callers with multiple accessible teams must select a team. Requests without access to any team are forbidden.

Minimum string length: 1
start_time
string<date-time>

Inclusive RFC 3339 start time. Defaults to 24 hours before end_time.

end_time
string<date-time>

RFC 3339 end time. Defaults to the current time.

limit
integer
default:100

Maximum number of log entries to return.

Required range: 1 <= x <= 1000
offset
integer
default:0

Number of log entries to skip. Narrow the time range beyond 10000 entries.

Required range: 0 <= x <= 10000

Response

Build logs in the requested time range. An empty array means no logs are available in that range.

logs
object[]
required
total_count
integer<int64>
required

Number of matching log entries in the requested time range.