Base URL https://api.tilion.dev. Every request needs Authorization: Bearer $TILION_API_KEY.

Residential egress

Set residential: true on session create to route the session’s traffic through residential IPs. Residential egress needs a paid plan; on the free plan the request is rejected with 402 and the machine-readable code residential_egress_paid.

Rotation policy

The proxy_rotation field on session create controls when the egress IP changes:

Rotate on demand

The endpoint requests a new egress IP for a session that uses rotating proxies. It returns 400 if the session is not on a rotatable egress path, and 409 if the session has no live browser.