Skip to main content
GET
List templates visible to the caller

Authorizations

X-API-Key
string
header
required

Query Parameters

name_prefix
string

Prefix match on the template name (legacy; prefer q).

q
string

Case-insensitive substring match on the resource name.

owner
enum<string>
default:all

Which shelf to return: all (team + system, the default), team (only the caller's own templates), or system (only the curated Superserve templates).

Available options:
all,
team,
system
sort
enum<string>
default:created_at

Column to sort by (paired with order).

Available options:
created_at,
name,
status,
size,
built_at
order
enum<string>
default:desc

Sort direction applied to sort.

Available options:
asc,
desc
limit
integer

Maximum rows to return (page size). Omit to return the full list unpaginated — the default, preserved for backward compatibility with callers that page client-side. Values above 200 are clamped to 200.

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

Rows to skip before the page. Combine with limit to paginate.

Required range: x >= 0

Response

List of templates

id
string<uuid>
team_id
string<uuid>
name
string
status
enum<string>
Available options:
pending,
building,
ready,
failed
vcpu
integer
memory_mib
integer
disk_mib
integer
size_bytes
integer<int64>

On-disk size of the template's snapshot bundle (present once ready).

error_message
string

Last build's error message, if status is failed.

created_at
string<date-time>
built_at
string<date-time>

When the template most recently transitioned to ready.