Base URL https://api.tilion.dev. Every request needs Authorization: Bearer $TILION_API_KEY.
POST /v1/session accepts an empty body, and every field below is optional. The defaults give
you an ephemeral, headless browser in the nearest region.
A session bills for as long as it exists. Keep idle_timeout tight and always release in a
finally block; a long idle timeout keeps a browser alive long after your job finished.
Regions
The endpoint lists the region codes you may pass as region on create. When you omit the
field, the session runs in the nearest region.
Personas
Each session gets a fingerprint persona, rotated automatically by default. Pass persona to
pin one, which keeps the fingerprint stable across sessions that should look like the same
visitor.
Unrecognised regions
An unrecognised region value is currently accepted rather than rejected, so a typo will not
fail the create. Check the session’s region field in the response if placement matters.