kiln_signin_poll
Poll to check if a sign-in is complete using the device code. Returns pending, success, denied, or expired status.
Instructions
Check whether a sign-in started by kiln_signin is done.
Call this repeatedly (every ``interval`` seconds) with the
``device_code`` that ``kiln_signin`` returned. Each call is a
single HTTP round-trip (it does NOT block), so the agent stays
responsive and the user sees progress.
Returns ``{"status": "pending" | "success" | "denied" |
"expired", ...}``.
* ``pending`` — user hasn't finished in the browser yet;
wait ``interval`` seconds and call again.
* ``success`` — tokens have been written to
``~/.kiln/auth_tokens.json`` (mode 0600); the response
also echoes ``email`` and ``tier``. Every other Kiln tool
picks up the new session automatically.
* ``denied`` — user cancelled in the browser.
* ``expired`` — the device_code timed out (15 min window);
call ``kiln_signin`` again for a fresh code.
Free tier — no license key required.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| device_code | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||