GET /api/v1/templates/{templateId}

Operation: getTemplate.

Get one published template (public)

Endpoint

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

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
templateId	path	Required	string	Template UUID or its slug (spec.template_id, e.g. qwen3-8b-awq); unpublished -> 404.

Responses

200

Template.

application/json

Field	Type	Presence	Description
id	UUID	Required
published	boolean	Required
template_id	string	Required
name	string	Required
template_version	string	Required
image_digest	ImageDigest	Required	Pinned OCI reference (name@sha256:<64 hex>) — the same form quotes, START commands and qualification records carry.
launch_profile_version	string	Required
kind	“model” / “classical” / “custom”	Required
engine	“vllm” / “llamacpp” / “comfyui” / “faster-whisper” / “pytorch” / “jupyter” / “ollama” / “oci”	Required
model_ref	object	Optional
quantization	string	Optional
vram_fit	object	Required
readiness	object	Optional
exposes	array of object	Required
env	object	Required
min_gpu_count	integer	Required
required_runtime	“cuda” / “rocm-hip” / “level-zero” / “opencl” / “xpu”	Required
setup_notes	string	Required
runtimes	object	Optional	Additive. One template, many backends: the same weights and API contract per backend. tier container is an OCI image; tier inference is the signed Tier B runtime artifact (<source>@sha256:<hex>). The control plane picks the machine’s runtime by preference (cuda > rocm > sycl > vulkan > metal) and pins its digest in the quote and lease.
backends	array of “cuda” / “rocm” / “sycl” / “vulkan” / “metal”	Optional	Additive. Backends with a built runtime, in preference order (“Works on” filter). Spec compatibility, not a hardware test.
works_on	array of “nvidia” / “amd” / “intel” / “apple”	Optional	Additive. Hardware vendors those backends cover. Spec compatibility only; a hardware report is what says “tested on”.

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

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/{templateId}'

Schema definitions · Download OpenAPI · Authentication · Errors and recovery