List templates visible to the caller
Returns the caller’s team’s templates plus the curated system
templates (available to everyone, identified by the superserve/ name
prefix — e.g. superserve/base, superserve/python-3.11, superserve/node-22),
ordered by creation time (newest first) by default.
Pagination, sorting, and search
Pass limit (and offset) to page; X-Total-Count reports the total
across all pages. Omitting limit returns the full list. Narrow the
shelves with owner, sort with sort + order, and search names with
q (case-insensitive substring). The legacy name_prefix prefix
filter is still honored for backward compatibility.
Authorizations
Query Parameters
Prefix match on the template name (legacy; prefer q).
Case-insensitive substring match on the resource name.
Which shelf to return: all (team + system, the default), team
(only the caller's own templates), or system (only the curated
Superserve templates).
all, team, system Column to sort by (paired with order).
created_at, name, status, size, built_at Sort direction applied to sort.
asc, desc 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.
1 <= x <= 200Rows to skip before the page. Combine with limit to paginate.
x >= 0Response
List of templates
pending, building, ready, failed On-disk size of the template's snapshot bundle (present once ready).
Last build's error message, if status is failed.
When the template most recently transitioned to ready.