Identity & Hostname Tools

Available on every plan, including Free. Choosing your own hostname is the one paid part.

identity { action: "get" }

Returns your agent's current network identity. No other parameters.

{
  "active_ipv6": "2001:67c:3f4:801c::4:1",
  "prefix": "2001:67c:3f4:801c::4:0/112",
  "tunnel_ipv6": null,
  "ipv4_exit": "shared_pool",
  "hostname": "claude",
  "tier": "team5",
  "connection_type": "r6me"
}

• active_ipv6 — the address your traffic leaves from
• prefix — your agent's own /112 slice of your organisation's /64; rotation stays inside it
• tunnel_ipv6 — a mesh tunnel address where one applies; null for agents on the Route6 client (their mesh address is in team_status)
• ipv4_exit — how IPv4-only destinations are reached: shared_pool (NAT64 from a shared Route6 address) unless the agent holds the Static IPv4 add-on
• hostname — the agent's name under on.route6.me
• tier — the plan's internal id (free, team, team5 = Scale)
• connection_type — r6me (the client) or http_tunnel (serverless)

identity { action: "set_ipv6" }

Rotate or pin your public IPv6 address within your own /112 slice.

{ "new_ipv6": "2001:67c:3f4:801c::2:e9a1", "prefix": "2001:67c:3f4:801c::2:0/112" }

The change is immediate for outbound traffic, and your hostname's AAAA record follows it automatically — there is nothing to re-register.

identity { action: "check_reputation" }

Check whether an address is on spam/abuse blocklists (DNSBL).

{
  "ip": "2001:67c:3f4:801c::4:1",
  "clean": true,
  "complete": true,
  "blocklists": [
    { "list": "bl.spamcop.net", "status": "not_listed", "listed": false }
  ],
  "recommendation": "Not listed on any checked blocklist."
}

• clean — true only when every list answered "not listed"; false when any list lists the address; null when a list could not be checked (then read it as unknown)
• complete — whether every list gave a usable answer
• blocklists[] — per list: status (listed / not_listed / error), listed, and result / error where relevant
• recommendation — what to do next

If the address is listed, call identity { action: "set_ipv6" } with no address and check again.

hostname_register

Choose, change or release your agent's *.on.route6.me hostname. Every agent already has an assigned name — read it with identity { action: "get" }.

• With name — registers that name (paid plans; on Free the call answers upgrade_required). DNS is updated within about a minute.
• Without name — releases your current hostname.