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). Filter by name_prefix=<text>.

GET /templates

List templates visible to the caller

cURL

curl --request GET \
  --url https://api-staging.superserve.ai/templates \
  --header 'X-API-Key: <api-key>'

200

[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "vcpu": 123,
    "memory_mib": 123,
    "disk_mib": 123,
    "size_bytes": 123,
    "error_message": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "built_at": "2023-11-07T05:31:56Z"
  }
]

Authorizations

X-API-Key · string · header · required

Query Parameters

name_prefix · string

Response

200

application/json

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.