import requests
url = "https://api.13-215-85-171.sslip.io/v1/templates/refs/{ref}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)curl --request GET \
--url https://api.13-215-85-171.sslip.io/v1/templates/refs/{ref} \
--header 'Authorization: Bearer <token>'{
"id": "<string>",
"name": "<string>",
"description": "<string>",
"builtin": true,
"canonical_ref": "<string>",
"namespace_slug": "<string>",
"visibility": "private",
"tags": [
"<string>"
],
"default_tag": "<string>",
"runtime_defaults": {
"default_env_keys": [
"<string>"
],
"start_cmd": "<string>",
"default_user": "<string>",
"default_workdir": "<string>",
"readiness": {
"kind": "tcp",
"port": 3000,
"timeout_secs": 30,
"interval_ms": 500,
"startup_grace_secs": 2
}
}
}{
"error": "<string>",
"code": "invalid_request",
"error_detail": {
"code": "unauthorized",
"message": "<string>",
"phase": "auth",
"retryable": true,
"suggested_action": "<string>",
"step_index": 123,
"attempt": 123,
"max_attempts": 123,
"cache_subject": "<string>",
"build_id": "<string>",
"request_id": "<string>",
"details": {}
},
"request_id": "<string>",
"build_id": "<string>"
}{
"error": "<string>",
"code": "invalid_request",
"error_detail": {
"code": "unauthorized",
"message": "<string>",
"phase": "auth",
"retryable": true,
"suggested_action": "<string>",
"step_index": 123,
"attempt": 123,
"max_attempts": 123,
"cache_subject": "<string>",
"build_id": "<string>",
"request_id": "<string>",
"details": {}
},
"request_id": "<string>",
"build_id": "<string>"
}{
"error": "<string>",
"code": "invalid_request",
"error_detail": {
"code": "unauthorized",
"message": "<string>",
"phase": "auth",
"retryable": true,
"suggested_action": "<string>",
"step_index": 123,
"attempt": 123,
"max_attempts": 123,
"cache_subject": "<string>",
"build_id": "<string>",
"request_id": "<string>",
"details": {}
},
"request_id": "<string>",
"build_id": "<string>"
}Get template details by canonical ref
Firecracker-only endpoint. Accepts raw custom template IDs, logical refs like name and name:tag, exact build refs like name:tb_123, builtin refs like nullspace/base:latest, slug namespaced custom refs like acme/python-dev:stable, and legacy authenticated owner UUID namespaced refs. Full canonical refs take precedence over subresource parsing, so names such as acme/tags, acme/aliases, acme/rename, and acme/visibility remain addressable through this route when those templates exist.
import requests
url = "https://api.13-215-85-171.sslip.io/v1/templates/refs/{ref}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)curl --request GET \
--url https://api.13-215-85-171.sslip.io/v1/templates/refs/{ref} \
--header 'Authorization: Bearer <token>'{
"id": "<string>",
"name": "<string>",
"description": "<string>",
"builtin": true,
"canonical_ref": "<string>",
"namespace_slug": "<string>",
"visibility": "private",
"tags": [
"<string>"
],
"default_tag": "<string>",
"runtime_defaults": {
"default_env_keys": [
"<string>"
],
"start_cmd": "<string>",
"default_user": "<string>",
"default_workdir": "<string>",
"readiness": {
"kind": "tcp",
"port": 3000,
"timeout_secs": 30,
"interval_ms": 500,
"startup_grace_secs": 2
}
}
}{
"error": "<string>",
"code": "invalid_request",
"error_detail": {
"code": "unauthorized",
"message": "<string>",
"phase": "auth",
"retryable": true,
"suggested_action": "<string>",
"step_index": 123,
"attempt": 123,
"max_attempts": 123,
"cache_subject": "<string>",
"build_id": "<string>",
"request_id": "<string>",
"details": {}
},
"request_id": "<string>",
"build_id": "<string>"
}{
"error": "<string>",
"code": "invalid_request",
"error_detail": {
"code": "unauthorized",
"message": "<string>",
"phase": "auth",
"retryable": true,
"suggested_action": "<string>",
"step_index": 123,
"attempt": 123,
"max_attempts": 123,
"cache_subject": "<string>",
"build_id": "<string>",
"request_id": "<string>",
"details": {}
},
"request_id": "<string>",
"build_id": "<string>"
}{
"error": "<string>",
"code": "invalid_request",
"error_detail": {
"code": "unauthorized",
"message": "<string>",
"phase": "auth",
"retryable": true,
"suggested_action": "<string>",
"step_index": 123,
"attempt": 123,
"max_attempts": 123,
"cache_subject": "<string>",
"build_id": "<string>",
"request_id": "<string>",
"details": {}
},
"request_id": "<string>",
"build_id": "<string>"
}Authorizations
API key passed as Bearer token
Path Parameters
Canonical template ref. This route accepts slash-bearing refs such as namespace/name, namespace/name:tag, namespace/name:tb_123, and legacy <user_uuid>/<name>:<tag> aliases.
Query Parameters
Comma-separated field mask for template list/get responses. Supported fields: id, name, description, tags, default_tag, builtin, canonical_ref, namespace_slug, visibility.
Response
Template details
private, public Effective runtime defaults retained for a built template. Environment values are intentionally omitted; only keys are exposed.
Show child attributes
Show child attributes