Run task
States a goal in natural language against a domain. Tilion replays a cached skill when it has one and derives a new one when it does not, so repeat calls get cheaper. decision in the response is REPLAY, DERIVE, or HEAL.
Authorizations
Every request carries a bearer API key, which looks like ph_live_.... Keep keys server-side, because a key grants full control of your sessions. A missing header returns 401; an invalid or revoked key currently returns 403, so treat the two together as authentication failure.
Body
The domain the goal applies to, such as example.com.
The goal in natural language, such as "get the page heading".
The session to run in.
The page to navigate for a cold derive.
Advanced override.
Advanced override.
Expected output field names.
Values for {slot} placeholders.
Response
Successful Response
The extracted output.
REPLAY, DERIVE, or HEAL.
Whether the task succeeded.
Whether a cached skill served the request.
Whether a broken skill was repaired during the run.
Tokens spent on this run.
Tokens saved by replaying a cached skill.
The skill that served the request.