Names

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

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