Assign or promote tags for a custom template ref
import requests
url = "https://api.13-215-85-171.sslip.io/v1/templates/refs/{ref}/tags"
payload = { "tags": ["<string>"] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)curl --request POST \
--url https://api.13-215-85-171.sslip.io/v1/templates/refs/{ref}/tags \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"tags": [
"<string>"
]
}
'{
"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": "template tags must not be empty",
"code": "invalid_request",
"request_id": "req_123"
}{
"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>"
}Templates
Assign or promote tags for a custom template ref
Firecracker-only endpoint. Request tags must be a non-empty array. If the template’s canonical ref itself ends with tags, the subresource remains one segment deeper, for example /v1/templates/refs/acme/tags/tags.
POST
/
v1
/
templates
/
refs
/
{ref}
/
tags
Assign or promote tags for a custom template ref
import requests
url = "https://api.13-215-85-171.sslip.io/v1/templates/refs/{ref}/tags"
payload = { "tags": ["<string>"] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)curl --request POST \
--url https://api.13-215-85-171.sslip.io/v1/templates/refs/{ref}/tags \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"tags": [
"<string>"
]
}
'{
"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": "template tags must not be empty",
"code": "invalid_request",
"request_id": "req_123"
}{
"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 custom template ref.
Body
application/json
Non-empty list of tags to assign or promote. Empty arrays are invalid.
Response
Updated template metadata
Available options:
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