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