Inspect

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

POST /v1/inspect

curl -X POST https://api.tilion.dev/v1/inspect \
  -H "Authorization: Bearer $TILION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"session_id":"'"$SESSION_ID"'","url":"https://example.com","async_mode":true}'

Request

Field	Type	Default	Notes
`session_id`	string	required	An existing session
`url`	string	required	The page to watch
`duration`	number (s)	60	Capped at 180
`async_mode`	bool	`false`	Return a `job_id` immediately

Two response shapes

The synchronous form returns the full report. With async_mode it returns a job envelope of the shape { session_id, job_id, kind, status } instead. Branch on whether job_id is present, then poll the job as described in Async jobs. An inspection of any real length should use async_mode, because a synchronous call that outruns its deadline returns 504.

Search Agent tasks

Get started

MCP

Sessions

Fetch & jobs

Content

Agent & tasks

Live view & recordings

Account

Reference

Request

Two response shapes

​Request

​Two response shapes

Request

Two response shapes