# GET /api/v1/templates/{templateId}

Get one published template (public)

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". |

```json
{
  "$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 |  |

```json
{
  "$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.

```sh
curl --request GET 'https://amplerun-api.spiry.org/api/v1/templates/{templateId}'
```

[Schema definitions](https://docs.amplerun.com/reference/schemas.md) · [Download OpenAPI](/openapi.json) · [Authentication](https://docs.amplerun.com/agents/authentication.md) · [Errors and recovery](https://docs.amplerun.com/reference/errors.md)

---
Generated from the AmpleRun API contract.
Canonical: https://docs.amplerun.com/reference/api/get-template/