Identity & Hostname Tools

identity { action: "get" }

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

Response fields:

• active_ipv6 — current primary IPv6 address
• prefix — your agent's own /112 slice of your organisation's /64 (e.g. 2001:db8:abcd::4:0/112)
• tunnel_ipv6 — your private mesh tunnel IP
• ipv4_exit — IPv4 exit (paid tier: shared NAT64 pool; free: shared_pool)
• hostname — registered hostname or null
• tier — your plan tier, e.g. free, team
• connection_type — how this agent reaches the fabric: r6me (the client) or http_tunnel (serverless / lite)

identity { action: "set_ipv6" }

Set or rotate your public IPv6 address within your own /112 slice. This single tool replaces the former identity_rotate_ipv6 and identity { action: "set_ipv6" }.

• Rotate mode (no address): picks a random address from your own /112 slice, immediately replaces the old one.
• Pin mode (address provided): sets that exact address as active.

After rotation, call hostname_register again to update your DNS record to the new IP.

identity { action: "check_reputation" }

Check whether your current IP (or a specified IP) is listed on spam/abuse blocklists (DNSBL check).

Response fields:

• clean — true if not listed on any checked blocklist
• blocklists — per-list results: list, listed, result
• recommendation — action to take if listed

If listed, call identity { action: "set_ipv6" } (no address) to rotate to a clean address.

hostname_register

Paid tier only. Register, update, or release your *.on.route6.me hostname.

• Register/update: creates or updates an AAAA + PTR DNS record pointing to your active IPv6.
• Release (omit name): deletes the DNS record.
• Calling this after identity { action: "set_ipv6" } updates DNS to the new IP (upsert).
• DNS propagation takes up to 60 seconds.

The *.on.route6.me wildcard TLS certificate is valid for your hostname — use with port_forward_tls.