Skip to main content
GET
List template builds

Authorizations

X-API-Key
string
header
required

Path Parameters

templateID
string
required

Query Parameters

nextToken
string

Cursor to start the list from

limit
integer<int32>
default:100

Maximum number of items to return per page

Required range: 1 <= x <= 100
statuses
enum<string>[]

Comma-separated list of build statuses to include. Every status when omitted. Repeating a status returns 400.

Status of the template build

Available options:
building,
waiting,
ready,
error,
uploaded
tags
string[]

Comma-separated list of tags. Only the builds these tags point at are returned. Every build when omitted. Tags are trimmed and lowercased.

Maximum array length: 100

Response

Successfully returned the template builds

buildID
string<uuid>
required

Identifier of the build

status
enum<string>
required

Status of the template build

Available options:
building,
waiting,
ready,
error,
uploaded
createdAt
string<date-time>
required

Time when the build was created

updatedAt
string<date-time>
required

Time when the build was last updated

cpuCount
integer<int32>
required

CPU cores for the sandbox

Required range: x >= 1
memoryMB
integer<int32>
required

Memory for the sandbox in MiB

Required range: x >= 128
tags
string[]
required

Tags of the template that point at this build. A tag points at the latest ready build it was assigned to, the build a sandbox created with that tag starts from.

finishedAt
string<date-time>

Time when the build was finished

maxCpuCount
integer<int32>

Maximum CPU count for resizable templates; absent for fixed-size templates.

Required range: x >= 1
diskSizeMB
integer<int32>

Disk size for the sandbox in MiB

Required range: x >= 0
envdVersion
string

Version of the envd running in the sandbox