GET /api/v1/templates

Operation: listTemplates.

List published templates (public)

D-19(c). Cursor paged; filters kind and min_vram_bytes (templates whose vram_fit.min_vram_bytes <= the given value). Only published templates (bound to at least one admitted machine by a qualification record) are listed. No cached public responses.

Endpoint

GET https://amplerun-api.spiry.org/api/v1/templates

Authentication

No default Bearer requirement is declared for this operation. Read its description for wallet signatures, host enrollment or other specialized proofs.

Parameters

Name	Location	Presence	Type	Description
cursor	query	Optional	string	Opaque pagination cursor from a previous response.
limit	query	Optional	integer
kind	query	Optional	“model” / “classical” / “custom”
min_vram_bytes	query	Optional	DecimalString	Return templates that fit a device with this much VRAM.
backend	query	Optional	“cuda” / “rocm” / “sycl” / “vulkan” / “metal”	Only templates with a built runtime for this backend (“Works on”).

Responses

200

Page of templates.

application/json

Field	Type	Presence	Description
items	array of Template	Required
next_cursor	string or null	Required

{
  "type": "object",
  "required": [
    "items",
    "next_cursor"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Template"
      }
    },
    "next_cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    }
  }
}

default

Error envelope. 401 unauthenticated, 403/404 forbidden, 409 conflict, 422 invalid input, 429 rate limited (code UNAVAILABLE, retryable:true, no Retry-After header), 503 unavailable money/provider state with retryable:true.

application/json

Field	Type	Presence	Description
error	object	Required

{
  "$ref": "#/components/schemas/ErrorEnvelope"
}

Static request outline

Replace path/query placeholders and provide the required JSON body, headers and credential from the sections above. This is a request outline, not a command that chooses an amount or starts a rental for you.

curl --request GET 'https://amplerun-api.spiry.org/api/v1/templates'

Schema definitions · Download OpenAPI · Authentication · Errors and recovery