Template names give builds stable refs that are easier to use than generated
template IDs.
claim = Template.reserve_name("team/agent-template")
print(claim.claim_token)
namespace = Template.get_namespace("team")
print(namespace.slug)
Template.rename("team/agent-template", "agent-template-renamed")
Template.release_name_claim(claim.claim_token)
nullspace template reserve team/agent-template
nullspace template namespace get team
nullspace template rename team/agent-template agent-template-renamed
nullspace template claim release tclm_...
# Reserve a name claim
curl -X POST "${NULLSPACE_API_URL}/v1/templates/claims" \
-H "Authorization: Bearer ${NULLSPACE_API_KEY}" \
-H "Content-Type: application/json" \
-d '{"template_ref": "team/agent-template"}'
# Inspect a namespace
curl "${NULLSPACE_API_URL}/v1/templates/namespaces/team" \
-H "Authorization: Bearer ${NULLSPACE_API_KEY}"
# Rename a template (use /v1/templates/refs/{ref}/rename for slash-bearing refs)
curl -X POST "${NULLSPACE_API_URL}/v1/templates/refs/team%2Fagent-template/rename" \
-H "Authorization: Bearer ${NULLSPACE_API_KEY}" \
-H "Content-Type: application/json" \
-d '{"new_name": "agent-template-renamed"}'
# Release a name claim
curl -X DELETE "${NULLSPACE_API_URL}/v1/templates/claims/tclm_..." \
-H "Authorization: Bearer ${NULLSPACE_API_KEY}"
The TypeScript SDK exposes client.templates.list(), .get(ref), and
.delete(ref); name reservation, namespaces, renaming, and field selection
are available in the Python SDK, CLI, or HTTP API.
Template refs can be IDs, canonical refs, or aliases depending on the
operation. Prefer canonical refs in automation when you need stable ownership
and namespace behavior.
Use field selection for compact index responses:
templates = Template.list(fields=["id", "canonical_ref", "visibility"])
info = Template.get("team/agent-template", fields=["id", "canonical_ref"])
nullspace template list --fields id,canonical_ref,visibility
nullspace template get team/agent-template --fields id,canonical_ref
curl "${NULLSPACE_API_URL}/v1/templates?fields=id,canonical_ref,visibility" \
-H "Authorization: Bearer ${NULLSPACE_API_KEY}"
curl "${NULLSPACE_API_URL}/v1/templates/team%2Fagent-template?fields=id,canonical_ref" \
-H "Authorization: Bearer ${NULLSPACE_API_KEY}"