LinkTrace docs

Domains move through verification, routing, and active host selection

LinkTrace currently supports branded subdomains for short-link delivery. Ownership proof and routing readiness are separate steps.

Domain lifecycle

A domain is not usable for routing until it is active.

  • pending_verification: ownership has not been proven.
  • pending_routing: ownership is proven, but routing is not yet active.
  • active: the host can be selected on links and workspace defaults.

Verification and activation

Proof of ownership and actual DNS routing are two different checks.

  • Add the TXT record for _linktrace.<hostname> to prove ownership.
  • Point the subdomain CNAME at the configured LinkTrace short-link target.
  • Only active domains can be attached to links.

Domain creation

Domains are managed per workspace and gated by plan limits.

bash
curl 'https://api.linktrace.cc/api/v1/domains' \
  -X POST \
  -H 'Authorization: Bearer lt_your_secret_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "hostname":"go.example.com"
  }'
Related guides